本文へスキップ
GuilduoDocs
EnglishWeb Appを開く

AIを接続する GUILDUO

CodexでGuilduoを使う:MCP接続と最初のQuest

CodexでGuilduoのタスクを読み、目的・進捗・人の回答を確かめて作業を続けるためのガイドです。まず1件の読み取りから始めます。導入やAgent登録だけで作業の自動実行や書き込み許可が生まれることはありません。

接続前に用意するもの

  • Guilduo / Relay Forge用のGoogleアカウントと、目的・完了条件を書いた小さなQuestを1件。
  • Codex CLI 0.159.2または導入済みWindows Desktopと、通常利用しているAI契約・API環境。外部AIの条件と費用は別です。
  • https://mcp.guilduo.com/mcp へのRemote HTTP MCP・OAuth接続。公開β版の手順で、所要時間は保証しません。
  • Guilduo Appへ接続済みなら、MCPを二重に追加せず、下の既存App companionの手順を使います。

標準marketplaceから導入する

Guilduoプラグインの配布版は0.6.0-beta.12です。

対象はCodex CLI 0.159.2と導入済みWindows Desktopです。既存guilduo-localがApp companionなら、その方式を維持して更新します。通常MCP版と重ねないでください。

powershell
codex plugin marketplace add ELRdn/Guilduo --ref main
codex plugin add guilduo-workflows@guilduo-local
codex plugin list --marketplace guilduo-local --json

1件を読んで接続成功を確認する

  1. Codexの接続設定からOAuth認証を完了し、Guilduo Skillを使える新しいチャットを開きます。
  2. 「現在のAgent contextとQuest一覧を確認し、私が作った小さなQuestを1件読んで。まだ書き込まないで」と依頼します。
  3. 取得したタイトル・目的・保存状態をGuilduo Webと照合します。plugin一覧や56ツールの発見だけでは、タスクの読み取り成功を示しません。
  4. 書き込みへ進むときはWebのConnectionsで許可済み登録Agentへリンクし、実行権限と任せる範囲を確認します。最新状態を読み、変更後も再読取します。

2026年10月10日の受入記録と未確認範囲

2026年10月10日の開発者本人による受入記録では、Windows CLI 0.159.2での導入とSkill・hook定義の発見、本人環境のApp companion更新とcache一致が確認されています。専用プロセスの直接OAuth接続(process-only direct OAuth)で、認証情報の再利用とツール発見が記録されています。

実モデルIDはopenai/gpt-6-astraで、正本Skillを明示指定した限定更新と保存結果の再読取、変更不要時の無更新、古い状態を基にした書き込みの拒否後の読み取りが記録されています。本人がWebで保存したHuman確認依頼への回答を取得し、同じAgentセッションで再開した結果も記録されています。

これは過去の開発者検証の紹介であり、2026年10月12日の内容確認で実機検証を再実行したものではありません。CodexからClaudeへの引き継ぎ実証や時間短縮の測定でもありません。包括的なDesktop lifecycle、trusted hookの実行、OAuth refresh・失効・再接続は未受入です。Appの古いtool schemaや、通常プラグインのSkill自動読込を、この結果から書き込み受入済みとは判断しません。

既存Appの接続を再利用する

実App IDはtokenではありません。公開source rootから生成し、生成フォルダーを保持します。再起動後の新しいチャットとcacheで、有効なguilduo-workflows:guilduo-workflows Skillが1つ、接続が1つであることを確認します。

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

継続補助は明示許可とbinding後に使う

hostで正確なhookを確認・trustし、継続許可を得てexact session・canonical cwd・Quest・Agentを確認してbindします。session_id+turn_idで実行済み記録を排他的に作り、元入力につき追加確認最大1回。再bindでも上限はリセットしません。識別子・再帰フラグ欠落、保存失敗、不正bindingは抑止します。導入だけで同期を始めません。詳細は同梱hooks/README.mdです。

Agent権限とHuman回答を確認する

導入はAgentを自動登録しません。Freeの上限は2登録Agentです。既存の許可済みAgentを使い、共有接続では毎回actingAgentIdを指定します。get_current_agent_contextでallowlistと実行スコープを確認し、fresh tool discoveryにexpectedUpdatedAtがあることを確かめます。限定更新後はreadbackし、同じ内容なら無更新、競合なら再読取します。update_questにdryRunはありません。Human依頼の回答は本人がWebで保存したものを取得してから再開します。

更新・無効化・切断・削除

Git marketplaceはupgrade後、同じpluginを再導入してcacheの版を確認します。unbindは補助停止、hostの停止ボタンは推論中断です。Plan・read-only・fork・許可撤回・中断時に書き込まないことを確認します。無効化はhost設定、OAuth切断は接続設定とGuilduo Web、削除はplugin removeです。

powershell
codex plugin marketplace upgrade guilduo-local
codex plugin add guilduo-workflows@guilduo-local
# Remove only when no longer needed:
codex plugin remove guilduo-workflows@guilduo-local

この記事の出典

公開GitHubの資料をもとに編集しています。仕様の詳細は原文を確認できます。

内容確認日: · 公開資料の版: 479b211