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

AIを接続する GUILDUO

ClaudeでGuilduoを使う:Claude CodeプラグインとConnector

Claude Code(CLI、IDE拡張、デスクトップアプリのCodeタブ)では、GuilduoリポジトリのmarketplaceからGuilduoプラグインを導入し、Claude Code標準OAuthで接続します。検証したプラグイン版は0.6.0-beta.2です。公式MCPとguilduo-workflows Skillだけを追加し、npmは使いません。

必要な環境

  • Claude Code 2.1.286以降。2.1.286と2.1.296で検証しています。
  • 構成は公式MCP https://mcp.guilduo.com/mcp(表示名plugin:guilduo:guilduo)とguilduo-workflows Skillだけです。hook、コマンド、サブエージェント、自動追加入力、追加モデル呼び出しはありません。
  • 認証と資格情報の保存はClaude Codeが担当します。プラグイン独自の資格情報保存やトークンbridgeはありません。

marketplaceから導入する

Claude Codeのセッション内で次を実行します。既存の設定、他のプラグイン、MCP接続、認証、履歴は保持されます。

  1. シェルからはclaude plugin marketplace add ELRdn/Guilduo --sparse .claude-plugin plugins/guilduo-claude と claude plugin install guilduo@guilduo を実行します。--sparseでmarketplaceとこのプラグインだけを取得します。
  2. 開いているセッションでは/reload-pluginsを実行するか、新しいセッションを開始します。
text
/plugin marketplace add ELRdn/Guilduo
/plugin install guilduo@guilduo

Claude Code標準OAuthで認証する

https://mcp.guilduo.com/mcpを既にclaude mcp addなどで手動登録している場合、Claude Codeはその既存接続を使い続け、プラグイン側の接続は起動しません。コマンドのplugin:guilduo:guilduoを既存のサーバー名へ置き換えてください。

  1. /mcpでplugin:guilduo:guilduoを選び、サインインの案内に従います。シェルからはclaude mcp login plugin:guilduo:guilduoでも同じです。
  2. ブラウザーでWeb版Guilduoと同じアカウントを許可し、Claude Codeへ戻ります。callback URLやトークンを会話へ貼り付けません。

読み込みと接続を確認する

detailsにguilduo-workflows Skillとguilduo MCPが表示され、認証後のmcp getで接続済みと表示されることを確認します。その後、新しいセッションで書き込みなしの確認を依頼します。例:「/guilduo:guilduo-workflows を使って、何も書き込まずに get_current_agent_context を読み、BacklogのQuestを最大5件、タイトルだけ報告してください」。

Skillは説明文が一致したときにClaudeが選ぶか、/guilduo:guilduo-workflowsで明示的に呼び出したときに使われます。各フェーズで必ず自動実行されるものではありません。Questが多いアカウントで絞り込みなしのlist_questsを読むと、Claude CodeのMCP出力上限を超えることがあります。範囲を指定するか、起動前にMAX_MCP_OUTPUT_TOKENSを引き上げます。

powershell
claude --version
claude plugin details guilduo@guilduo
claude mcp get plugin:guilduo:guilduo

更新・停止する

/pluginのMarketplacesタブからも更新できます。サードパーティmarketplaceの自動更新は既定でオフです。導入済みのコピーはプラグインの版番号が変わったときだけ更新されます。更新後は/reload-pluginsか再起動をします。OAuth認証は有効な間そのまま使われます。

一時停止はclaude plugin disable guilduo@guilduo、再開はclaude plugin enable guilduo@guilduoです。

powershell
claude plugin marketplace update guilduo
claude plugin update guilduo@guilduo

切断・削除する

  1. Claude Code側のサインアウトは、/mcpのClear authenticationかclaude mcp logoutで行います。ローカルの認証も消したい場合は、削除前に行います。
  2. サーバー側の認可はhttps://app.guilduo.com/の接続管理で別途失効させます。サインアウトやプラグイン削除だけでは失効しません。
  3. claude plugin uninstallでプラグインを削除し、必要ならmarketplaceも削除します。Quest、他のプラグイン、他のMCP接続には影響しません。
powershell
claude mcp logout plugin:guilduo:guilduo
claude plugin uninstall guilduo@guilduo
claude plugin marketplace remove guilduo

Claude ConnectorsでMCPを手動接続する

Claude Code以外のClaude(Web・デスクトップアプリのチャットなど)では、プラグインではなくRemote MCP対応のConnectorsで接続できます。この経路にSkillは含まれません。チャット・Coworkでのプラグイン導入は未受入です。

  1. ClaudeのSettingsからConnectorsを開きます。画面名やカスタムConnectorの利用条件は使用している版で確認します。
  2. Remote MCP接続を追加し、名前をGuilduo、URLをhttps://mcp.guilduo.com/mcpにします。
  3. OAuth認証を進め、Web版Guilduoと同じアカウントで許可します。秘密情報を会話や設定欄に貼り付けません。その後、上のAgent確認と同じ手順で読み取りを確認します。

接続できないとき

  • /mcpにplugin:guilduo:guilduoがない:claude plugin list --jsonで有効か確認し、/reload-pluginsか新しいセッションで再確認します。同じendpointを手動登録している場合はその名前で表示されます。
  • 401やNeeds authentication:正式endpointとOAuthアカウントを確認し、/mcpかclaude mcp loginで再認証します。
  • 読めるが更新できない:OAuth認可とAgent allowedScopesの両方にquests:writeがあるか確認します。実行権限を広げてリンクエラーを解消しないでください。
  • Humanツールが見えない:新しいセッションでツール一覧を再取得します。通常のQuest更新で代用したり、回答を作ったりしません。

検証範囲と公式掲載

Claude Code 2.1.286/2.1.296で、隔離環境での導入・Skill/MCP検出・更新・停止・再開・削除と無関係な設定の保持、GitHubからの導入と版番号を上げた更新、公開OAuth、別プロセスでの認証再利用、サインアウト・再接続、専用接続のAgentリンク、Agent権限による書き込み拒否、限定Quest更新と再読、no-op、競合の拒否と再読、Human依頼→本人のWeb回答→保存回答の取得→Agent再開の受入記録があります。

トークンの自動refresh、サーバー側失効、共有接続でのcross-Agent選択、チャット・Coworkでのプラグイン導入は未受入です。Anthropic公式directoryへの掲載は申請前で、導入手順とは別に扱います。

この記事の出典

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

内容確認日: · 公開資料の版: 53793f0