@devries-cameron20 / composio Mirror · read-only / commits / bc03aebf4
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 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