@devries-cameron20 / composio Mirror · read-only / commits / 39af0f007
Fork 0

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 21, 19:45 UTC

docs: drop client names + connect.composio.dev link, add guide to migration index

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Palash Kala committed Jun 12, 2026 at 15:03 UTC 39af0f007c217095d92c2fabb7ad8329f7c34582
2 files changed +15 -11
docs/content/docs/migration-guide/index.mdx
+6
@@ -12,6 +12,12 @@ description: Guides for migrating to newer versions of Composio
12 [View Direct Tools migration guide →](/docs/migration-guide/direct-to-sessions)
13 </Accordion>
14
15 + <Accordion title="Migrating from MCP servers to Sessions">
16 + 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.
17 +
18 + [View MCP servers migration guide →](/docs/migration-guide/mcp-servers-to-sessions)
19 + </Accordion>
20 +
21 <Accordion title="Migrating from Experimental Tool Router">
22 Migrate from `composio.experimental.tool_router` to the stable sessions API.
23
docs/content/docs/migration-guide/mcp-servers-to-sessions.mdx
+9 -11
@@ -16,11 +16,10 @@ Starting fresh? Skip this guide and read [Configuring Sessions](/docs/configurin
16 </Callout>
17
18 <Callout type="info">
19 -Just connecting apps to your own AI client (Claude, Cursor, ChatGPT) for personal use — not building
20 -an app? You don't need the SDK. Use **[Composio For You](https://connect.composio.dev)** to connect
21 -across 1000+ apps in a few clicks, then point your client at the URL it gives you. Switch to it any
22 -time from the product switcher in the top-left of the dashboard. Reserve `session.mcp.url` for
23 -programmatic, in-app use.
19 +Just connecting apps to your own agent for personal use — not building an app? You don't need the
20 +SDK. Use **Composio For You** to connect across 1000+ apps in a few clicks — switch to it from the
21 +product switcher in the top-left of the dashboard. Reserve `session.mcp.url` for programmatic,
22 +in-app use.
23 </Callout>
24
25 ## What carries over (you keep all of this)
@@ -28,8 +27,8 @@ programmatic, in-app use.
27 - **Your tools** — every tool you exposed on a server is available in a session.
28 - **Your auth configs and connected accounts** — pass the same `ac_…` IDs; your users **do not
29 re-authenticate**.
31 -- **The MCP URL pattern** — you still get a URL (`session.mcp.url`) that plugs into Claude Desktop,
32 - Cursor, OpenAI Agents, Mastra — the same clients, the same protocol.
30 +- **The MCP URL pattern** — you still get a URL (`session.mcp.url`) that plugs into your agent — any
31 + MCP-compatible client — the same way, the same protocol.
32 - **Per-user isolation** — still keyed by `user_id`.
33 - **Tool restriction** — you can still pin a session to an exact, fixed tool list (see Step 3).
34
@@ -118,8 +117,8 @@ re-auth.
117 <Step>
118 <StepTitle>Point your MCP client at the new URL</StepTitle>
119
121 -Swap the generated server URL for `session.mcp.url` wherever your client connects — Claude Desktop,
122 -Cursor, OpenAI Agents, Mastra. Nothing else about the client changes.
120 +Swap the generated server URL for `session.mcp.url` wherever your agent connects. Nothing else about
121 +the client changes.
122
123 ```python
124 # 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", {
242 - **Triggers** — unchanged; continue using `composio.triggers.*` and webhooks (triggers aren't part
243 of sessions yet).
244 - **Dashboard** — sessions are created via the SDK. For no-code, personal app connections, use
246 - [Composio For You](https://connect.composio.dev) — reachable from the product switcher in the
247 - top-left of the dashboard.
245 + **Composio For You** — reachable from the product switcher in the top-left of the dashboard.
246
247 ## Get started
248