@devries-cameron20 / composio Mirror · read-only / commits / ceb4c9b26
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 22, 04:30 UTC

docs: update documentation for new changelog entries

github-actions[bot] committed Mar 4, 2026 at 23:50 UTC ceb4c9b269e74adbebd003a2dfcd54f79e69715b
3 files changed +23 -2
docs/content/docs/projects.mdx
+3
@@ -85,6 +85,9 @@ curl -X PATCH https://backend.composio.dev/api/v3/org/project/config \
85 }'
86 ```
87
88 +Notable security setting:
89 +- `require_mcp_api_key`: when `true`, MCP server requests must include a valid `x-api-key` header. This defaults to `true` for organizations created on or after March 5, 2026.
90 +
91 You can also view and update these from **Settings > Project Settings** in the [dashboard](https://platform.composio.dev?next_page=/settings). See the [Projects API reference](/reference/api-reference/projects) for all available settings.
92
93 ## What to read next
docs/content/docs/single-toolkit-mcp.mdx
+11 -2
@@ -129,6 +129,10 @@ console.log("MCP Server URL:", instance.url);
129 <Step>
130 ### Use with AI providers
131
132 + <Callout type="info">
133 + Pass an `x-api-key` header when connecting to Composio MCP. This is required when `require_mcp_api_key` is enabled (default for newly created organizations).
134 + </Callout>
135 +
136 <Tabs items={['OpenAI (Python)', 'Anthropic (Python)', 'Mastra (TypeScript)']}>
137 <Tab value="OpenAI (Python)">
138 ```python
@@ -137,6 +141,7 @@ from openai import OpenAI
141 client = OpenAI(api_key="your-openai-api-key")
142
143 mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID"
144 +mcp_headers = {"x-api-key": "YOUR_COMPOSIO_API_KEY"}
145
146 response = client.responses.create(
147 model="gpt-5",
@@ -144,6 +149,7 @@ response = client.responses.create(
149 "type": "mcp",
150 "server_label": "composio-server",
151 "server_url": mcp_server_url,
152 + "headers": mcp_headers,
153 "require_approval": "never",
154 }],
155 input="What are my latest emails?",
@@ -159,6 +165,7 @@ from anthropic import Anthropic
165 client = Anthropic(api_key="your-anthropic-api-key")
166
167 mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID"
168 +mcp_headers = {"x-api-key": "YOUR_COMPOSIO_API_KEY"}
169
170 response = client.beta.messages.create(
171 model="claude-sonnet-4-5",
@@ -167,7 +174,8 @@ response = client.beta.messages.create(
174 mcp_servers=[{
175 "type": "url",
176 "url": mcp_server_url,
170 - "name": "composio-mcp-server"
177 + "name": "composio-mcp-server",
178 + "headers": mcp_headers,
179 }],
180 betas=["mcp-client-2025-04-04"]
181 )
@@ -182,11 +190,12 @@ import { openai } from "@ai-sdk/openai";
190 import { Agent } from "@mastra/core/agent";
191
192 const MCP_URL = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID";
193 +const MCP_HEADERS = { "x-api-key": "YOUR_COMPOSIO_API_KEY" };
194
195 const client = new MCPClient({
196 id: "mcp-client",
197 servers: {
189 - composio: { url: new URL(MCP_URL) },
198 + composio: { url: new URL(MCP_URL), headers: MCP_HEADERS },
199 }
200 });
201
docs/content/docs/troubleshooting/mcp.mdx
+9
@@ -23,6 +23,15 @@ Verify your URL format matches one of these patterns:
23 - `https://apollo-<randomID>-composio.vercel.app/v3/mcp/<UUID>`
24 - `https://apollo.composio.dev/v3/mcp/<UUID>`
25
26 +## Getting 401 Unauthorized errors
27 +
28 +If your MCP client gets `401 Unauthorized`, include your Composio project API key in request headers:
29 +
30 +- Header name: `x-api-key`
31 +- Value: your project API key from the Composio dashboard
32 +
33 +When `require_mcp_api_key` is enabled on your project, requests without this header are rejected.
34 +
35 ## Testing and debugging
36
37 If experiencing issues, test your MCP server with: