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: consolidate MCP pages into Single Toolkit MCP
Sushmithamallesheaee9c6d4e8d
diff --git a/docs/content/docs/mcp/index.mdx b/docs/content/docs/mcp/index.mdxnew file mode 100644index 000000000..a63b13838--- /dev/null+++ b/docs/content/docs/mcp/index.mdx@@ -0,0 +1,355 @@+---+title: Single Toolkit MCP+description: Create MCP servers for specific toolkits+keywords: [mcp, model context protocol, single toolkit]+---++<Callout type="info">+For most use cases, we recommend using [Tool Router](/docs/quickstart) which provides dynamic tool access without pre-configuring servers.+</Callout>++## Install the SDK++<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```bash+pip install composio+```+ </Tab>+ <Tab value="TypeScript">+```bash+npm install @composio/core+```+ </Tab>+</Tabs>++## Create an MCP server++<Steps>+ <Step>+ ### Initialize Composio++ <Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+from composio import Composio++composio = Composio(api_key="YOUR_API_KEY")+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';++const composio = new Composio({+ apiKey: process.env.COMPOSIO_API_KEY+});+```+ </Tab>+ </Tabs>+ </Step>++ <Step>+ ### Create server configuration++ <Callout type="warn">+ **Before you begin:** [Create an auth configuration](/docs/auth-configuration/custom-auth-configs) for your toolkit.+ </Callout>++ <Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+server = composio.mcp.create(+ name="my-gmail-server",+ toolkits=[{+ "toolkit": "gmail",+ "auth_config": "ac_xyz123"+ }],+ allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]+)++print(f"Server created: {server.id}")+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });+// ---cut---+const server = await composio.mcp.create("my-gmail-server", {+ toolkits: [+ {+ authConfigId: "ac_xyz123",+ toolkit: "gmail"+ }+ ],+ allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]+});++console.log(`Server created: ${server.id}`);+```+ </Tab>+ </Tabs>++ <Callout type="info">+ You can also create and manage MCP configs from the [Composio dashboard](https://platform.composio.dev?next_page=/mcp-configs).+ </Callout>+ </Step>++ <Step>+ ### Generate user URLs++ <Callout type="warn">+ Users must authenticate with the toolkits configured in your MCP server first. See [authentication](/docs/authentication) for details.+ </Callout>++ <Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+instance = composio.mcp.generate(user_id="user-123", mcp_config_id=server.id)++print(f"MCP Server URL: {instance['url']}")+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });+const server = { id: 'my-gmail-server' };+// ---cut---+const instance = await composio.mcp.generate("user-123", server.id);++console.log("MCP Server URL:", instance.url);+```+ </Tab>+ </Tabs>+ </Step>++ <Step>+ ### Use with AI providers++ <Tabs items={['OpenAI (Python)', 'Anthropic (Python)', 'Mastra (TypeScript)']}>+ <Tab value="OpenAI (Python)">+```python+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"++response = client.responses.create(+ model="gpt-5",+ tools=[{+ "type": "mcp",+ "server_label": "composio-server",+ "server_url": mcp_server_url,+ "require_approval": "never",+ }],+ input="What are my latest emails?",+)++print(response.output_text)+```+ </Tab>+ <Tab value="Anthropic (Python)">+```python+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"++response = client.beta.messages.create(+ model="claude-sonnet-4-5",+ max_tokens=1000,+ messages=[{"role": "user", "content": "What are my latest emails?"}],+ mcp_servers=[{+ "type": "url",+ "url": mcp_server_url,+ "name": "composio-mcp-server"+ }],+ betas=["mcp-client-2025-04-04"]+)++print(response.content)+```+ </Tab>+ <Tab value="Mastra (TypeScript)">+```typescript+import { MCPClient } from "@mastra/mcp";+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 client = new MCPClient({+ id: "mcp-client",+ servers: {+ composio: { url: new URL(MCP_URL) },+ }+});++const agent = new Agent({+ id: "assistant",+ name: "Assistant",+ model: openai("gpt-4-turbo"),+ tools: await client.getTools()+});++const res = await agent.generate("What are my latest emails?");+console.log(res.text);+```+ </Tab>+ </Tabs>+ </Step>+</Steps>++## Server management++### List servers++<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+servers = composio.mcp.list()+print(f"Found {len(servers['items'])} servers")++# Filter by toolkit+gmail_servers = composio.mcp.list(toolkits="gmail", limit=20)+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: 'your_api_key' });+// ---cut---+const servers = await composio.mcp.list({ limit: 10, page: 1 });+console.log(`Found ${servers.items.length} servers`);++// Filter by toolkit+const gmailServers = await composio.mcp.list({ toolkits: ["gmail"] });+```+ </Tab>+</Tabs>++### Get server details++<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+server = composio.mcp.get("mcp_server_id")+print(f"Server: {server.name}")+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: 'your_api_key' });+// ---cut---+const server = await composio.mcp.get("mcp_server_id");+console.log(`Server: ${server.name}`);+```+ </Tab>+</Tabs>++### Update a server++<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+updated = composio.mcp.update(+ server_id="mcp_server_id",+ name="updated-name",+ allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]+)+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: 'your_api_key' });+// ---cut---+const updated = await composio.mcp.update("mcp_server_id", {+ name: "updated-name",+ allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]+});+```+ </Tab>+</Tabs>++### Delete a server++<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+result = composio.mcp.delete("mcp_server_id")+if result['deleted']:+ print("Server deleted")+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: 'your_api_key' });+// ---cut---+const result = await composio.mcp.delete("mcp_server_id");+if (result.deleted) {+ console.log("Server deleted");+}+```+ </Tab>+</Tabs>++### Multi-toolkit servers++Combine multiple services in a single MCP server:++<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+ <Tab value="Python">+```python+server = composio.mcp.create(+ name="productivity-suite",+ toolkits=[+ {"toolkit": "gmail", "auth_config": "ac_gmail"},+ {"toolkit": "slack", "auth_config": "ac_slack"},+ {"toolkit": "github", "auth_config": "ac_github"}+ ],+ allowed_tools=[+ "GMAIL_FETCH_EMAILS",+ "SLACK_SEND_MESSAGE",+ "GITHUB_CREATE_ISSUE"+ ]+)+```+ </Tab>+ <Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: 'your_api_key' });+// ---cut---+const server = await composio.mcp.create("productivity-suite", {+ toolkits: [+ { authConfigId: "ac_gmail", toolkit: "gmail" },+ { authConfigId: "ac_slack", toolkit: "slack" },+ { authConfigId: "ac_github", toolkit: "github" }+ ],+ allowedTools: [+ "GMAIL_FETCH_EMAILS",+ "SLACK_SEND_MESSAGE",+ "GITHUB_CREATE_ISSUE"+ ]+});+```+ </Tab>+</Tabs>++## Next steps++<Cards>+ <Card title="Providers" href="/docs/providers">+ Use with Anthropic, OpenAI, and other frameworks+ </Card>+ <Card title="Quickstart" href="/docs/quickstart">+ Build an agent with Tool Router (recommended)+ </Card>+</Cards>diff --git a/docs/content/docs/mcp/mcp-quickstart.mdx b/docs/content/docs/mcp/mcp-quickstart.mdxdeleted file mode 100644index a13177f19..000000000--- a/docs/content/docs/mcp/mcp-quickstart.mdx+++ /dev/null@@ -1,272 +0,0 @@-----title: Quickstart-description: Create your first MCP server-keywords: [mcp, model context protocol]------[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) is an open-source standard for connecting AI applications to external tools. All the 500+ tools available in Composio are also available as MCP servers.--Composio lets you create MCP servers that handle authentication (OAuth, API keys), generate unique URLs for each user, and control which tools are exposed. You can combine multiple toolkits in a single server.--<Callout type="info">-Composio MCP servers only support Streamable HTTP transport.-</Callout>--## Install the SDK--First, install the Composio SDK for your preferred language:--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```bash-pip install composio-```- </Tab>- <Tab value="TypeScript">-```bash-npm install @composio/core-```- </Tab>-</Tabs>--## Create an MCP server--<Steps>- <Step>- ### Initialize Composio-- <Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-from composio import Composio--# Initialize Composio-composio = Composio(api_key="YOUR_API_KEY")-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';--// Initialize Composio-const composio = new Composio({- apiKey: process.env.COMPOSIO_API_KEY-});-```- </Tab>- </Tabs>- </Step>-- <Step>- ### Create server configuration-- <Callout type="warn">- **Before you begin:** [Create an auth configuration](/docs/authenticating-tools#creating-an-auth-config) for your toolkit.- </Callout>-- Create an MCP server with your auth config. You can also set list of specific tools to enable across all toolkits.-- <Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-# Create MCP server with multiple toolkits-server = composio.mcp.create(- name="mcp-config-73840", # Pick a unique name for your MCP server- toolkits=[- {- "toolkit": "gmail",- "auth_config": "ac_xyz123" # Your Gmail auth config ID- },- {- "toolkit": "googlecalendar",- "auth_config": "ac_abc456" # Your Google Calendar auth config ID- }- ],- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL", "GOOGLECALENDAR_EVENTS_LIST"]-)--print(f"Server created: {server.id}")-print(server.id)-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });-// ---cut----// Create MCP server with multiple toolkits-const server = await composio.mcp.create("mcp-config-73840", { // Pick a unique name for your MCP server- toolkits: [- {- authConfigId: "ac_xyz123", // Your Gmail auth config ID- toolkit: "gmail"- },- {- authConfigId: "ac_abc456", // Your Google Calendar auth config ID- toolkit: "googlecalendar"- }- ],- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL", "GOOGLECALENDAR_EVENTS_LIST"]-});--console.log(`Server created: ${server.id}`);-console.log(server.id);-```- </Tab>- </Tabs>-- <Callout type="info">- **Alternative:** You can also create and manage MCP configs directly from the [Composio dashboard → MCP Configs](https://platform.composio.dev?next_page=/mcp-configs).- </Callout>- </Step>-- <Step>- ### Generate user URLs-- <Callout type="warn">- **Before generating URLs:** Users must authenticate with the toolkits configured in your MCP server. See [hosted authentication](/docs/authenticating-tools#hosted-authentication-connect-link) for how to connect user accounts.- </Callout>-- Get server URLs for your users to connect:-- <Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-# Generate server instance for user-instance = composio.mcp.generate(user_id="user-73840", mcp_config_id=server.id) # Use the user ID for which you created the connected account--print(f"MCP Server URL: {instance['url']}")-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });-const server = { id: 'mcp-config-73840' };-// ---cut----// Generate server instance for user-const instance = await composio.mcp.generate("user-73840", server.id); // Use the user ID for which you created the connected account--console.log("MCP Server URL:", instance.url);-```- </Tab>- </Tabs>-- <Callout type="info">- If users haven't authenticated, the MCP server will still generate a URL but tools requiring authentication won't work until the user connects their accounts.- </Callout>- </Step>-- <Step>- ### Use with AI providers-- Use the MCP server URL with your AI provider:-- <Tabs items={['OpenAI (Python)', 'Anthropic (Python)', 'Mastra (TypeScript)']}>- <Tab value="OpenAI (Python)">-```python-from openai import OpenAI--# Initialize OpenAI client-client = OpenAI(api_key="your-openai-api-key")--# Use the MCP server URL you generated-mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID"--# Use MCP with OpenAI Responses API-response = client.responses.create(- model="gpt-5",- tools=[- {- "type": "mcp",- "server_label": "composio-server",- "server_description": "Composio MCP server for Gmail and Calendar integrations",- "server_url": mcp_server_url,- "require_approval": "never",- },- ],- input="What meetings do I have tomorrow? Also check if I have any urgent emails",-)--print("OpenAI MCP Response:", response.output_text)-```- </Tab>- <Tab value="Anthropic (Python)">-```python-from anthropic import Anthropic--# Initialize Anthropic client-client = Anthropic(api_key="your-anthropic-api-key")--# Use the MCP server URL you generated-mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID"--# Use MCP with Anthropic (beta feature)-response = client.beta.messages.create(- model="claude-sonnet-4-5",- system="You are a helpful assistant with access to various tools through MCP. Use these tools to help the user. Do not ask for confirmation before using the tools.",- max_tokens=1000,- messages=[{- "role": "user",- "content": "What meetings do I have tomorrow? Also check if I have any urgent emails"- }],- mcp_servers=[{- "type": "url",- "url": mcp_server_url,- "name": "composio-gmail-calendar-mcp-server"- }],- betas=["mcp-client-2025-04-04"] # Enable MCP beta-)--print(response.content)-```- </Tab>- <Tab value="Mastra (TypeScript)">-```typescript-import { MCPClient } from "@mastra/mcp";-import { openai } from "@ai-sdk/openai";-import { Agent } from "@mastra/core/agent";--// Use the MCP server URL you generated-const MCP_URL = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID";--export const client = new MCPClient({- id: "docs-mcp-client",- servers: {- composio: { url: new URL(MCP_URL) },- }-});--export const agent = new Agent({- id: "assistant",- name: "Assistant",- description: "Helpful AI with MCP tools",- instructions: "Use the MCP tools to answer.",- model: openai("gpt-4-turbo"),- tools: await client.getTools()-});--(async () => {- const res = await agent.generate("What meetings do I have tomorrow? Also check if I have any urgent emails");- console.log(res.text);-})();-```- </Tab>- </Tabs>- </Step>-</Steps>--## Next steps--<Cards>- <Card title="Server management" href="/docs/mcp/mcp-server-management">- Create and manage MCP servers- </Card>- <Card title="Providers" href="/docs/providers">- Use with Anthropic, OpenAI, and other frameworks- </Card>-</Cards>--<Callout type="info">-Need help? Join our [Discord](https://discord.com/invite/composio) or [raise an issue on GitHub](https://github.com/ComposioHQ/composio/issues/new?labels=bug).-</Callout>diff --git a/docs/content/docs/mcp/mcp-server-management.mdx b/docs/content/docs/mcp/mcp-server-management.mdxdeleted file mode 100644index 404b3294a..000000000--- a/docs/content/docs/mcp/mcp-server-management.mdx+++ /dev/null@@ -1,309 +0,0 @@-----title: Server management-description: Create, update, and manage MCP servers-keywords: [create server, update server, delete server]------This guide covers all server management operations for MCP servers.--## Create a server--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-server = composio.mcp.create(- name="my-gmail-server",- toolkits=[{- "toolkit": "gmail",- "auth_config": "ac_xyz123"- }],- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]-)--print(f"Created server: {server.id}")-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: 'your_api_key' });-// ---cut----const server = await composio.mcp.create(- "my-gmail-server",- {- toolkits: [- {- authConfigId: "ac_xyz123",- toolkit: "gmail"- }- ],- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"],- manuallyManageConnections: false- }-);--console.log(`Created server: ${server.id}`);-```- </Tab>-</Tabs>--## List servers--Find and filter your MCP servers.--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-# List all servers-servers = composio.mcp.list()-print(f"Found {len(servers['items'])} servers")--# Filter by toolkit-gmail_servers = composio.mcp.list(- toolkits="gmail",- limit=20-)--# Filter by name-production_servers = composio.mcp.list(- name="production"-)-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: 'your_api_key' });-// ---cut----// List all servers-const servers = await composio.mcp.list({- limit: 10,- page: 1,- authConfigs: [],- toolkits: []-});-console.log(`Found ${servers.items.length} servers`);--// Filter by toolkit-const gmailServers = await composio.mcp.list({- limit: 20,- page: 1,- authConfigs: [],- toolkits: ["gmail"]-});--// Filter by name-const productionServers = await composio.mcp.list({- limit: 10,- page: 1,- authConfigs: [],- toolkits: [],- name: "production"-});-```- </Tab>-</Tabs>--## Get server details--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-# Get by ID-server = composio.mcp.get("mcp_server_id")-print(f"Server name: {server.name}")-print(f"Toolkits: {server.toolkits}")-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: 'your_api_key' });-// ---cut----// Get by ID-const server = await composio.mcp.get("mcp_server_id");--console.log(`Server: ${server.name}`);-console.log(`Toolkits: ${server.toolkits}`);-```- </Tab>-</Tabs>--## Update a server--Modify server configuration, tools, or auth configs.--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-updated = composio.mcp.update(- server_id="mcp_server_id",- name="updated-name",- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]-)-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: 'your_api_key' });-// ---cut----const updated = await composio.mcp.update(- "mcp_server_id",- {- name: "updated-name",- toolkits: [- {- toolkit: "gmail",- authConfigId: "ac_new_config"- }- ],- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"],- manuallyManageConnections: false- }-);--console.log(updated);-```- </Tab>-</Tabs>--## Delete a server--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-result = composio.mcp.delete("mcp_server_id")-if result['deleted']:- print("Server deleted successfully")-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: 'your_api_key' });-// ---cut----const result = await composio.mcp.delete("mcp_server_id");-if (result.deleted) {- console.log("Server deleted successfully");-}-```- </Tab>-</Tabs>--## Multi-toolkit servers--Combine multiple services in a single MCP server.--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-server = composio.mcp.create(- name="productivity-suite",- toolkits=[- {"toolkit": "gmail", "auth_config": "ac_gmail"},- {"toolkit": "slack", "auth_config": "ac_slack"},- {"toolkit": "github", "auth_config": "ac_github"}- ],- allowed_tools=[- "GMAIL_FETCH_EMAILS",- "SLACK_SEND_MESSAGE",- "GITHUB_CREATE_ISSUE"- ]-)-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: 'your_api_key' });-// ---cut----const server = await composio.mcp.create(- "productivity-suite",- {- toolkits: [- {- authConfigId: "ac_gmail",- toolkit: "gmail"- },- {- authConfigId: "ac_slack",- toolkit: "slack"- },- {- authConfigId: "ac_github",- toolkit: "github"- }- ],- allowedTools: [- "GMAIL_FETCH_EMAILS",- "SLACK_SEND_MESSAGE",- "GITHUB_CREATE_ISSUE"- ],- manuallyManageConnections: false- }-);-```- </Tab>-</Tabs>--## Generate user URLs--After creating a server, generate unique URLs for each user.--<Tabs groupId="language" items={['Python', 'TypeScript']} persist>- <Tab value="Python">-```python-# Generate instance for user-instance = server.generate("[email protected]")--print(f"URL: {instance['url']}")-print(f"Tools: {instance['allowed_tools']}")--# Chat-based authentication is enabled by default-# Set manually_manage_connections=True to disable it:-instance_manual = server.generate(- "[email protected]",- manually_manage_connections=True-)-```- </Tab>- <Tab value="TypeScript">-```typescript-import { Composio } from '@composio/core';-const composio = new Composio({ apiKey: 'your_api_key' });-// ---cut----// Generate instance for user-const instance = await composio.mcp.generate(- "[email protected]",- "mcp_server_id"-);--console.log("URL:", instance.url);-console.log("Tools:", instance.allowedTools);--// Chat-based authentication is enabled by default-// Set manuallyManageConnections: true to disable it:-const instanceManual = await composio.mcp.generate(- "[email protected]",- "mcp_server_id",- { manuallyManageConnections: true }-);-```- </Tab>-</Tabs>--<Callout type="info">-**Chat-based authentication:**-- **TypeScript**: Enabled by default (set `manuallyManageConnections=false` or omit it)-- **Python**: Enabled by default (set `manually_manage_connections=False` or omit it)--When enabled, the agent can authenticate users dynamically during conversation if they're missing required connections. Set `manuallyManageConnections=true` (TypeScript) or `manually_manage_connections=True` (Python) to disable it.-</Callout>--## Best practices--- **Use descriptive names** - Makes servers easy to find-- **Limit tools appropriately** - Only include necessary tools-- **Reuse servers** - Don't create duplicates for same configuration-- **Store server IDs** - Keep track of created server IDsdiff --git a/docs/content/docs/mcp/meta.json b/docs/content/docs/mcp/meta.jsonindex 7d2b3692a..344c6ae22 100644--- a/docs/content/docs/mcp/meta.json+++ b/docs/content/docs/mcp/meta.json@@ -1,7 +1,6 @@{"title": "MCP","pages": [- "mcp-quickstart",- "mcp-server-management"+ "index"]}