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: drop client names + connect.composio.dev link, add guide to migration index
Palash Kala39af0f007c21
diff --git a/docs/content/docs/migration-guide/index.mdx b/docs/content/docs/migration-guide/index.mdxindex 4fc21e9ff..364ce1abd 100644--- a/docs/content/docs/migration-guide/index.mdx+++ b/docs/content/docs/migration-guide/index.mdx@@ -12,6 +12,12 @@ description: Guides for migrating to newer versions of Composio[View Direct Tools migration guide →](/docs/migration-guide/direct-to-sessions)</Accordion>+ <Accordion title="Migrating from MCP servers to Sessions">+ Move from per-toolkit MCP server configs (`composio.mcp.create` / `composio.mcp.generate`) to sessions. Your tools, auth configs, and connected accounts carry over — no re-auth.++ [View MCP servers migration guide →](/docs/migration-guide/mcp-servers-to-sessions)+ </Accordion>+<Accordion title="Migrating from Experimental Tool Router">Migrate from `composio.experimental.tool_router` to the stable sessions API.diff --git a/docs/content/docs/migration-guide/mcp-servers-to-sessions.mdx b/docs/content/docs/migration-guide/mcp-servers-to-sessions.mdxindex 3c3289fc9..913491243 100644--- a/docs/content/docs/migration-guide/mcp-servers-to-sessions.mdx+++ b/docs/content/docs/migration-guide/mcp-servers-to-sessions.mdx@@ -16,11 +16,10 @@ Starting fresh? Skip this guide and read [Configuring Sessions](/docs/configurin</Callout><Callout type="info">-Just connecting apps to your own AI client (Claude, Cursor, ChatGPT) for personal use — not building-an app? You don't need the SDK. Use **[Composio For You](https://connect.composio.dev)** to connect-across 1000+ apps in a few clicks, then point your client at the URL it gives you. Switch to it any-time from the product switcher in the top-left of the dashboard. Reserve `session.mcp.url` for-programmatic, in-app use.+Just connecting apps to your own agent for personal use — not building an app? You don't need the+SDK. Use **Composio For You** to connect across 1000+ apps in a few clicks — switch to it from the+product switcher in the top-left of the dashboard. Reserve `session.mcp.url` for programmatic,+in-app use.</Callout>## What carries over (you keep all of this)@@ -28,8 +27,8 @@ programmatic, in-app use.- **Your tools** — every tool you exposed on a server is available in a session.- **Your auth configs and connected accounts** — pass the same `ac_…` IDs; your users **do notre-authenticate**.-- **The MCP URL pattern** — you still get a URL (`session.mcp.url`) that plugs into Claude Desktop,- Cursor, OpenAI Agents, Mastra — the same clients, the same protocol.+- **The MCP URL pattern** — you still get a URL (`session.mcp.url`) that plugs into your agent — any+ MCP-compatible client — the same way, the same protocol.- **Per-user isolation** — still keyed by `user_id`.- **Tool restriction** — you can still pin a session to an exact, fixed tool list (see Step 3).@@ -118,8 +117,8 @@ re-auth.<Step><StepTitle>Point your MCP client at the new URL</StepTitle>-Swap the generated server URL for `session.mcp.url` wherever your client connects — Claude Desktop,-Cursor, OpenAI Agents, Mastra. Nothing else about the client changes.+Swap the generated server URL for `session.mcp.url` wherever your agent connects. Nothing else about+the client changes.```python# Before: https://backend.composio.dev/v3/mcp/<SERVER_ID>?user_id=<USER_ID>@@ -243,8 +242,7 @@ const result = await session.execute("GITHUB_CREATE_ISSUE", {- **Triggers** — unchanged; continue using `composio.triggers.*` and webhooks (triggers aren't partof sessions yet).- **Dashboard** — sessions are created via the SDK. For no-code, personal app connections, use- [Composio For You](https://connect.composio.dev) — reachable from the product switcher in the- top-left of the dashboard.+ **Composio For You** — reachable from the product switcher in the top-left of the dashboard.## Get started