Skip to content
GuilduoDocs
日本語Open Web App

Connect your AI GUILDUO

Use Guilduo with Claude: Claude Code plugin and Connectors

In Claude Code (CLI, IDE extensions and the desktop app's Code tab), install the Guilduo plugin from the Guilduo repository's marketplace and sign in with Claude Code's standard OAuth. The tested plugin release is 0.6.0-beta.2. It adds only the official MCP server and the guilduo-workflows Skill, and does not use npm.

Requirements

  • Claude Code 2.1.286 or later. Tested on 2.1.286 and 2.1.296.
  • The plugin contains only the official MCP server https://mcp.guilduo.com/mcp (shown as plugin:guilduo:guilduo) and the guilduo-workflows Skill. It has no hooks, commands, subagents, automatic prompts or extra model requests.
  • Claude Code owns authentication and credential storage. The plugin adds no credential store or token bridge.

Install from the marketplace

Run these in a Claude Code session. Your existing settings, other plugins, MCP servers, sign-ins and history are kept.

  1. From a shell, run claude plugin marketplace add ELRdn/Guilduo --sparse .claude-plugin plugins/guilduo-claude and then claude plugin install guilduo@guilduo. --sparse checks out only the marketplace and this plugin.
  2. Run /reload-plugins in an open session or start a new one.
text
/plugin marketplace add ELRdn/Guilduo
/plugin install guilduo@guilduo

Sign in with Claude Code OAuth

If you already added https://mcp.guilduo.com/mcp yourself, for example with claude mcp add, Claude Code keeps using that connection and does not start the plugin's copy. Use your existing server name instead of plugin:guilduo:guilduo in the commands.

  1. Run /mcp, select plugin:guilduo:guilduo and follow the sign-in prompt. From a shell, claude mcp login plugin:guilduo:guilduo does the same.
  2. Approve the same account as the Guilduo Web App in the browser and return to Claude Code. Do not paste callback URLs or tokens into chat.

Check loading and connection

details should list the guilduo-workflows Skill and the guilduo MCP server, and mcp get should report it as connected after sign-in. Then ask for a read-only check in a new session, for example: "Use /guilduo:guilduo-workflows. Without writing anything, read get_current_agent_context and report the titles of at most five Backlog Quests."

Claude selects the Skill when its description matches, or you invoke it as /guilduo:guilduo-workflows; it is not guaranteed to run automatically at every phase. An unfiltered list_quests on a large account can exceed Claude Code's MCP output limit. Ask for a narrower view or raise MAX_MCP_OUTPUT_TOKENS before starting Claude Code.

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

Update and stop

You can also update from the Marketplaces tab in /plugin. Auto-update is off by default for third-party marketplaces. Installed copies update only when the plugin version changes. Run /reload-plugins or restart afterwards. Your OAuth sign-in is kept while it remains valid.

Stop temporarily with claude plugin disable guilduo@guilduo and resume with claude plugin enable guilduo@guilduo.

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

Disconnect and remove

  1. Sign out in Claude Code with Clear authentication in /mcp or claude mcp logout. Do this before uninstalling if you also want the local sign-in removed.
  2. Revoke server-side authorization separately through connection management at https://app.guilduo.com/. Signing out or uninstalling does not revoke it.
  3. Remove the plugin with claude plugin uninstall, and optionally remove the marketplace. Your Quests, other plugins and other MCP servers are not affected.
powershell
claude mcp logout plugin:guilduo:guilduo
claude plugin uninstall guilduo@guilduo
claude plugin marketplace remove guilduo

Connect MCP manually in Claude Connectors

Outside Claude Code, such as chat in the web or desktop app, connect through a Connector that supports Remote MCP instead of the plugin. This path does not include the Skill. Plugin installation in chat and Cowork is not accepted.

  1. Open Connectors from Claude Settings. Check your version for the setting name and custom connector availability.
  2. Add a Remote MCP connection named Guilduo with URL https://mcp.guilduo.com/mcp.
  3. Complete OAuth using the same account as the Guilduo Web App. Do not paste credentials into chat or configuration fields. Then check the Agent and a first read as above.

Troubleshoot the connection

  • plugin:guilduo:guilduo is missing from /mcp: check that the plugin is enabled with claude plugin list --json, then run /reload-plugins or start a new session. If you added the same endpoint manually, it appears under that name.
  • 401 or Needs authentication: check the canonical endpoint and OAuth account, then sign in again with /mcp or claude mcp login.
  • Reads work but writes fail: check that both the OAuth grant and Agent allowedScopes contain quests:write. Do not broaden execution scopes to fix a linking error.
  • Human tools are missing: refresh the tool list in a new session. Never substitute ordinary Quest writes or invent an answer.

Accepted scope and directory listing

On Claude Code 2.1.286 and 2.1.296, the records cover isolated install, Skill and MCP discovery, update, disable, enable, removal and unrelated-setting preservation; installation from GitHub and a version-changing update; public OAuth and reuse in a new process; sign-out and reconnection; linking a dedicated connection to an Agent and write rejection by Agent scopes; a narrow Quest update with readback, no-op and stale-write rejection with reread; and Human request → owner's Web answer → saved answer → Agent resumption.

Token refresh, server-side revocation, cross-Agent selection on shared connections and plugin installation in chat or Cowork are not accepted. The Anthropic directory listing has not been submitted and is separate from installation.

Sources for this article

Edited from the public GitHub documentation. Read the original sources for specification details.

Content reviewed: · Public source revision: 53793f0