Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: expand MCP connected account error with auth config scoping details (#3224)
decimal-pr-bot[bot]2358dede397f
diff --git a/docs/content/docs/troubleshooting/mcp.mdx b/docs/content/docs/troubleshooting/mcp.mdxindex 74ae64377..bf9a435da 100644--- a/docs/content/docs/troubleshooting/mcp.mdx+++ b/docs/content/docs/troubleshooting/mcp.mdx@@ -11,7 +11,9 @@ This error occurs when MCP cannot find a valid connected account for authenticat- **Default behavior**: Without specification, MCP uses `user_id=default`. If multiple connections exist with the same user_id, the most recent is used- **Verification checklist**:- Account status is `ACTIVE` (not deleted)- - Account belongs to the same auth config used to create the MCP server+ - Account belongs to the same auth config used to create the MCP server. MCP servers only resolve connected accounts through their bound auth configs, so connections under a different auth config will not be found.++To fix a mismatched auth config, update the MCP server's `auth_config_ids` using the [`PATCH /api/v3/mcp/{id}`](/reference/api-reference/mcp/patchMcpById) endpoint.Learn more: [Single Toolkit MCP](/docs/single-toolkit-mcp)