CodexとGuilduoを接続する：MCPとWorkflow Skill

Codexの接続を用意する

既存デスクトップAppを使う方式と直接MCPを登録する方式は選択肢です。同じ用途で両方を重ねる必要はありません。

1. 既存Guilduo Appの接続先とアカウントを確認します。なければMCP接続ガイドに沿ってRemote HTTP MCPを登録します。
2. 正式URLはhttps://mcp.guilduo.com/mcp、認証はOAuthです。CLIや別ホストの直接MCPでも、そのホストでOAuthを完了します。
3. PartyでAgentを登録し、Connectionsで今回の接続へリンクします。

最初は読み取りだけで確認する

Web Appと同じQuestを取得でき、linkedがtrueなら、アカウントとAgentの読み取り確認ができています。書き込みは対象と変更内容を決めて別に検証します。

Guilduoでget_current_agent_contextとlist_questsを読み取りだけで実行してください。
リンク状態、effectiveExecutionScopes、取得件数を報告してください。
作成・更新・完了・担当変更や追加のモデル実行はしないでください。
Token、Client ID、UIDは出力しないでください。

既存AppにWorkflow Skillを追加する

任意のローカル手順です。Guilduoソースリポジトリと、pluginコマンドに対応したCodex環境が必要です。YOUR_REGISTERED_GUILDUO_APP_IDは実際のGuilduo App IDへ置き換えます。OAuthトークンではありません。

リポジトリのルートで実行します。生成先.qa-artifacts/guilduo-pluginは、ローカルmarketplaceの登録中に保持してください。

1. Codexを再起動し、新しいチャットでGuilduo Workflowsを有効にします。
2. 読み込まれたSkill一覧にguilduo-workflows:questforge-workflowsがあることを確認します。
3. Human Relayにはrequest_human_reviewとlist_human_requestsの両方が必要です。

npx tsx tools/prepare-guilduo-plugin.mts --app-id YOUR_REGISTERED_GUILDUO_APP_ID
codex plugin marketplace add .qa-artifacts/guilduo-plugin
codex plugin add guilduo-workflows@guilduo-local
codex plugin list --marketplace guilduo-local --json

Questを担当してレビューへ返す

1. 「ヘルプ文を1か所改善する」をget_questで読み、完了条件と担当を確認します。
2. 任された範囲でassign_quest_to_agentをプレビューし、実際のAgent IDと最新expectedUpdatedAtで保存します。
3. 開始時にHandoffをworkingへ進め、Codexの作業環境で修正と検証を行います。
4. 結果と残る確認点をreview_requiredで返します。実機確認や好みの判断が必要ならHuman Relayを使います。

接続・Skill・実作業を切り分ける

• MCPは使えるがSkillがない：MCP単体ではSkillは読み込まれません。pluginと新しいチャットの読み込みを確認します。
• Humanツールがない：既存AppのメタデータをRefreshします。普通のQuest更新で人の回答を代用しません。
• pluginの認識成功はローカル読み込みの確認です。公開ディレクトリ掲載やOpenAI公式審査の完了ではありません。
• 担当保存は作業開始の証拠ではありません。workingへの遷移と実際の結果を別に確認します。