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