Guilduo MCP接続：OAuth認証とAgentリンク

接続前の確認

• クライアントがRemote HTTP MCPとOAuthに対応していることを確認します。設定名や利用条件はクライアントの版によって異なります。
• Web Appで作業用アカウントにログインし、Questを読めることを確認します。
• 担当AIを使うならPartyでAgentを登録し、表示名とは別のAgent IDを確認します。

正式endpointでOAuth接続する

1. MCP・Apps・Connectors設定で、接続名Guilduo、種類Remote HTTP MCPを選びます。
2. URLに上記endpointを入力します。通常接続に/mcp-nextやAppwrite APIのURLは使いません。
3. 認証方式を選べる場合はOAuthにします。API Key、Bearer Token、Client Secretを貼り付けません。
4. Web Appと同じアカウントで認可画面にログインし、要求された権限を確認して許可します。
5. クライアントへ戻り、接続済みまたは利用可能の表示を確認します。

https://mcp.guilduo.com/mcp

接続をAgentへリンクする

linkedがfalse、agentがnullなら、OAuth認証後でもAgent未リンクです。OAuthをやり直す前にConnectionsのリンクを確認します。

1. Web AppのConnectionsで、今回接続したClientを確認します。
2. 意図した登録済みAgentへリンクします。接続元の名前からAgentを推測しないでください。
3. クライアントを再読み込みし、get_current_agent_contextでlinked、Agent ID、effectiveExecutionScopesを確認します。

書き込まずに検証する

一覧が0件でも同じアカウントの保存状態と一致すれば正常です。ツール名の発見だけでは、呼び出し権限や書き込み成功を確認できません。

Guilduoの接続を読み取りだけで確認してください。
get_current_agent_contextでリンク状態、Agent ID、Role、effectiveExecutionScopesを報告してください。
次にlist_questsをview=all、limit=5で取得し、件数だけ報告してください。
Token、Client ID、UID、Quest本文は表示せず、変更や追加のモデル実行はしないでください。

接続失敗の診断

移行前の接続が原因なら旧接続を外して正式endpointで再登録します。動いている接続でツールだけが古い場合は、まずRefreshを試し、重複接続を作らないでください。