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: address review on the Custom MCP guide (PLEN-4800)
Drop slug-derivation details, simplify the API key and DCR OAuth notes, move the CIMD note to Limits, and say the default logo is the MCP logo. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01H6YzWrR4j8HcSUKs9b7EhV
Bharath committed
Nov 3, 2026 at 16:31 UTC
23cb1e4d08f9728bae46c915d9ffba23ec15edbe
1 file changed
+6
-5
docs/content/docs/extending-sessions/custom-mcp.mdx
+6
-5
@@ -70,7 +70,7 @@ curl -X POST https://backend.composio.dev/api/v3.1/custom/toolkits \
70
</Tab>
71
</Tabs>
72
73
-Composio picks the slug from the server's domain, and adds a random suffix if it's taken. Save the slug: you need it to sync, update, or delete the toolkit.
73
+Save the returned slug: you need it to sync, update, or delete the toolkit.
74
75
`app_url`, `auth_schemes`, and `user_id` can't change later. To change them, delete the toolkit and create it again.
76
@@ -88,12 +88,12 @@ Set `auth_schemes` to one of these:
88
| API key | Each user brings an API key. | `[{"mode": "API_KEY", "headers": {"Authorization": "Bearer {{generic_api_key}}"}}]` |
89
| DCR OAuth | The server supports OAuth Dynamic Client Registration. | `[{"mode": "DCR_OAUTH", "discovery_url": "https://mcp.acme.com/.well-known/oauth-authorization-server"}]` |
90
91
-- **API key:** Composio replaces `{{generic_api_key}}` with the user's key. Any header name works, but at least one header must contain `{{generic_api_key}}`. Composio only checks that a key was given, so run a safe tool after connecting to test it.
92
-- **DCR OAuth:** `discovery_url` is the OAuth authorization server's metadata URL. The server must support the authorization-code flow. Client ID Metadata Documents (CIMD) aren't supported. Composio sends a `resource` parameter: the one the server advertises, or else `app_url` without its query string or trailing slash.
91
+- **API key:** put `{{generic_api_key}}` in the header where the key goes, as in the table. Composio fills in each user's key when it calls your server.
92
+- **DCR OAuth:** set `discovery_url` to your OAuth server's metadata URL, usually ending in `/.well-known/oauth-authorization-server`. The server must support Dynamic Client Registration and the authorization-code flow.
93
94
### Create a toolkit for one user
95
96
-Set `user_id` to a user's ID to make the toolkit private: only that user's sessions and API calls can see or run its tools. A private toolkit's slug always has a random suffix, such as `CUSTOM_ACME_K7F2Q`.
96
+Set `user_id` to a user's ID to make the toolkit private: only that user's sessions and API calls can see or run its tools.
97
98
<Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
99
<Tab value="Python">
@@ -178,7 +178,7 @@ Creating the same MCP URL twice for one user, or twice as shared, returns `409`.
178
179
### Add a logo
180
181
-Add `logo_file` to create or update: a square PNG or JPEG, 256 to 1024 pixels, at most 3MB, base64-encoded on one line. Composio hosts it. Without one, the toolkit shows the Composio logo.
181
+Add `logo_file` to create or update: a square PNG or JPEG, 256 to 1024 pixels, at most 3MB, base64-encoded on one line. Composio hosts it. Without one, the toolkit shows the MCP logo.
182
183
```json
184
"logo_file": {"content": "<base64>", "mime_type": "image/png"}
@@ -397,6 +397,7 @@ curl -X POST https://backend.composio.dev/api/v3.1/tool_router/session \
397
- Remote servers only: local and STDIO servers aren't supported.
398
- `app_url`, `auth_schemes`, and `user_id` can't change after creation.
399
- At most 500 tools per toolkit.
400
+- OAuth servers that only support Client ID Metadata Documents (CIMD) aren't supported.
401
- No automatic resync: sync again when the server's tools change.
402
403
## Related guides