Connect your AI GUILDUO
Connect Claude to Guilduo with OAuth MCP
Add https://mcp.guilduo.com/mcp in a Claude Connector that supports Remote MCP and authenticate with OAuth. Link its Agent in Web App Connections, then verify that Claude can read the same Quest.
Configure OAuth in Connectors
- Open Connectors from Claude Settings. Check your version for the setting name and custom connector availability.
- Add a Remote MCP connection named Guilduo with URL https://mcp.guilduo.com/mcp.
- Complete OAuth using the same account as the Guilduo Web App. Do not paste credentials into chat or configuration fields.
- Return to Claude and confirm that the connection is available.
Match the Claude connection to an Agent
OAuth can succeed while the Agent remains unlinked. Client names do not determine identity; verify that the connection is not linked to a different assignee.
- Register the intended Agent in Guilduo Party. For example: display name Text reviewer, role Check meaning and wording.
- Link this Claude connection to the intended Agent in Connections.
- Call get_current_agent_context in Claude and check linked, the Agent ID and effectiveExecutionScopes.
Separate the first read from the first write
For example, choose Review the description before publication and use get_quest to check its criteria. Preview and save an assignment only within the user's authorization.
Reread the saved update and return the result as review_required. Request a Human review for subjective judgment and read the saved answer before resuming.
Read my Guilduo get_current_agent_context.
Then use list_quests to read at most five Backlog Quests and report only their titles.
Do not change anything or display tokens, Client IDs or UIDs.Troubleshoot the Claude connection
- No connector entry is available: check version support and requirements for Remote MCP and custom connections. Do not substitute a secret-key configuration.
- 401: check the canonical endpoint and OAuth account. An old pre-migration connection requires registration and authorization again.
- Reads work but writes fail: check that both the OAuth grant and Agent allowedScopes contain quests:write.
- Human tools are missing: check the connector's metadata refresh and verify in a new conversation. Do not assume a Codex local plugin loads automatically in Claude.
Sources for this article
Edited from the public GitHub documentation. Read the original sources for specification details.
Content reviewed: · Public source revision: 5125178