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: