@devries-cameron20 / composio Mirror · read-only / commits / 23cb1e4d0
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.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

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