Skip to content

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: update documentation for new changelog entries

github-actions[bot]ceb4c9b269e7
diff --git a/docs/content/docs/projects.mdx b/docs/content/docs/projects.mdx
index 653f3e36c..c8bd3b328 100644
--- a/docs/content/docs/projects.mdx
+++ b/docs/content/docs/projects.mdx
@@ -85,6 +85,9 @@ curl -X PATCH https://backend.composio.dev/api/v3/org/project/config \
}'
```
+Notable security setting:
+- `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.
+
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.
## What to read next
diff --git a/docs/content/docs/single-toolkit-mcp.mdx b/docs/content/docs/single-toolkit-mcp.mdx
index 21e45982d..239e474ea 100644
--- a/docs/content/docs/single-toolkit-mcp.mdx
+++ b/docs/content/docs/single-toolkit-mcp.mdx
@@ -129,6 +129,10 @@ console.log("MCP Server URL:", instance.url);
<Step>
### Use with AI providers
+ <Callout type="info">
+ 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).
+ </Callout>
+
<Tabs items={['OpenAI (Python)', 'Anthropic (Python)', 'Mastra (TypeScript)']}>
<Tab value="OpenAI (Python)">
```python
@@ -137,6 +141,7 @@ from openai import OpenAI
client = OpenAI(api_key="your-openai-api-key")
mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID"
+mcp_headers = {"x-api-key": "YOUR_COMPOSIO_API_KEY"}
response = client.responses.create(
model="gpt-5",
@@ -144,6 +149,7 @@ response = client.responses.create(
"type": "mcp",
"server_label": "composio-server",
"server_url": mcp_server_url,
+ "headers": mcp_headers,
"require_approval": "never",
}],
input="What are my latest emails?",
@@ -159,6 +165,7 @@ from anthropic import Anthropic
client = Anthropic(api_key="your-anthropic-api-key")
mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID"
+mcp_headers = {"x-api-key": "YOUR_COMPOSIO_API_KEY"}
response = client.beta.messages.create(
model="claude-sonnet-4-5",
@@ -167,7 +174,8 @@ response = client.beta.messages.create(
mcp_servers=[{
"type": "url",
"url": mcp_server_url,
- "name": "composio-mcp-server"
+ "name": "composio-mcp-server",
+ "headers": mcp_headers,
}],
betas=["mcp-client-2025-04-04"]
)
@@ -182,11 +190,12 @@ import { openai } from "@ai-sdk/openai";
import { Agent } from "@mastra/core/agent";
const MCP_URL = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID";
+const MCP_HEADERS = { "x-api-key": "YOUR_COMPOSIO_API_KEY" };
const client = new MCPClient({
id: "mcp-client",
servers: {
- composio: { url: new URL(MCP_URL) },
+ composio: { url: new URL(MCP_URL), headers: MCP_HEADERS },
}
});
diff --git a/docs/content/docs/troubleshooting/mcp.mdx b/docs/content/docs/troubleshooting/mcp.mdx
index a24fac489..8c76fddd6 100644
--- a/docs/content/docs/troubleshooting/mcp.mdx
+++ b/docs/content/docs/troubleshooting/mcp.mdx
@@ -23,6 +23,15 @@ Verify your URL format matches one of these patterns:
- `https://apollo-<randomID>-composio.vercel.app/v3/mcp/<UUID>`
- `https://apollo.composio.dev/v3/mcp/<UUID>`
+## Getting 401 Unauthorized errors
+
+If your MCP client gets `401 Unauthorized`, include your Composio project API key in request headers:
+
+- Header name: `x-api-key`
+- Value: your project API key from the Composio dashboard
+
+When `require_mcp_api_key` is enabled on your project, requests without this header are rejected.
+
## Testing and debugging
If experiencing issues, test your MCP server with: