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 22, 18:15 UTC
chore: changelog for query params in mcp urls
Composio committed
Nov 4, 2025 at 20:15 UTC
bc03aebf4bb106349b60cdfaf9ce56077e17c48f
1 file changed
+55
fern/pages/src/changelog/11-05-25.md
new
+55
@@ -0,0 +1,55 @@
1
+# Enhanced MCP URL Security Requirements
2
+
3
+We're introducing improved security requirements for Model Context Protocol (MCP) URLs to ensure better isolation between user connections and prevent unauthorized access.
4
+
5
+## What's Changing?
6
+
7
+Starting today, **all new Composio projects** must include at least one of the following parameters in their MCP URLs:
8
+- `user_id` - Identifies the specific user
9
+- `connected_account_id` - Identifies the specific connected account
10
+
11
+## Why This Matters
12
+
13
+This change ensures that:
14
+- **User Isolation**: Each user's connections remain completely separate from others
15
+- **Enhanced Security**: Prevents potential cross-user data access scenarios
16
+- **Better Multi-Tenancy**: Enables safer multi-tenant application architectures
17
+- **Explicit Access Control**: Forces developers to explicitly specify which user or account context they're operating in
18
+
19
+## Impact on Existing Projects
20
+
21
+**For existing projects**: We understand the importance of backward compatibility. While we've sent email notifications to project owners about upgrading their MCP URLs, **this is not a breaking change**. Your existing integrations will continue to work without interruption.
22
+
23
+We strongly recommend updating your MCP URLs to include these parameters for enhanced security.
24
+
25
+## Implementation Example
26
+
27
+**Before:**
28
+```
29
+mcp://your-server.com/endpoint
30
+```
31
+
32
+**After (with user_id):**
33
+```
34
+mcp://your-server.com/endpoint?user_id=user_123
35
+```
36
+
37
+**After (with connected_account_id):**
38
+```
39
+mcp://your-server.com/endpoint?connected_account_id=acc_456
40
+```
41
+
42
+## Migration Guide
43
+
44
+If you're using an existing project and want to adopt this security enhancement:
45
+
46
+1. Review your current MCP URL configuration
47
+2. Add either `user_id` or `connected_account_id` parameter to your URLs
48
+3. Update your application code to pass the appropriate identifier
49
+4. Test the updated URLs in your development environment
50
+
51
+For more details on choosing the right user identifiers for your application, see our [User Management documentation](https://docs.composio.dev/docs/user-management).
52
+
53
+## Questions?
54
+
55
+If you have any questions about this security enhancement or need assistance with migration, please reach out to our support team or check our [MCP documentation](#).
\ No newline at end of file