@devries-cameron20 / composio-1 / commits / 2358dede3
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: expand MCP connected account error with auth config scoping details (#3224)

## Summary of Changes - Expanded the auth config bullet in `docs/content/docs/troubleshooting/mcp.mdx` to explain that MCP servers only resolve connected accounts through their bound auth configs - Added fix guidance: update `auth_config_ids` via the PATCH `/api/v3/mcp/{id}` endpoint ## Reasoning - Users with multiple auth configs for the same toolkit see "connected account not found" when the MCP server is bound to an auth config with no connections - Existing docs mentioned auth config matching but didn't explain the scoping behavior or how to fix a mismatch Co-authored-by: decimal-pr-bot[bot] <264021074+decimal-pr-bot[bot]@users.noreply.github.com> Co-authored-by: Sushmitha Mallesh <sushdec6@gmail.com>

decimal-pr-bot[bot] committed Apr 17, 2026 at 00:33 UTC 2358dede397f0637f2570d5f56230b6c17242e33
1 file changed +3 -1
docs/content/docs/troubleshooting/mcp.mdx
+3 -1
@@ -11,7 +11,9 @@ This error occurs when MCP cannot find a valid connected account for authenticat
11 - **Default behavior**: Without specification, MCP uses `user_id=default`. If multiple connections exist with the same user_id, the most recent is used
12 - **Verification checklist**:
13 - Account status is `ACTIVE` (not deleted)
14 - - Account belongs to the same auth config used to create the MCP server
14 + - 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.
15 +
16 +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.
17
18 Learn more: [Single Toolkit MCP](/docs/single-toolkit-mcp)
19