Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: update documentation for new changelog entries
github-actions[bot]ceb4c9b269e7
diff --git a/docs/content/docs/projects.mdx b/docs/content/docs/projects.mdxindex 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 nextdiff --git a/docs/content/docs/single-toolkit-mcp.mdx b/docs/content/docs/single-toolkit-mcp.mdxindex 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 OpenAIclient = 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 Anthropicclient = 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.mdxindex 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 debuggingIf experiencing issues, test your MCP server with: