Custom connectors require a Pro, Max, Team, or Enterprise plan.
Setup via Connectors (Recommended)
No token needed — Claude Desktop handles authorization via OAuth.1
Open Connectors settings
In Claude Desktop, go to Settings > Connectors.
2
Add a custom connector
Scroll to the bottom and click Add custom connector.
3
Enter the MCP server URL
Paste the Trilo MCP endpoint:You can skip the Advanced settings (OAuth Client ID / Secret) — Trilo’s server handles OAuth automatically.
4
Click Add
Click Add to save the connector. Claude Desktop will open your browser to authorize access to your Trilo account.
5
Authorize access
Click Authorize in your browser. The connector is now active.
6
Enable in a conversation
In a new conversation, click the + button in the chat input and select Connectors. Toggle Trilo on for that conversation.
7
Verify the connection
Ask Claude:If it returns your workspace data, you’re connected.
Setup via Config File (Alternative)
If you prefer editing the JSON config file directly:1
Open the config file
Open your Claude Desktop config file in a text editor:macOS:Windows:
2
Add the Trilo MCP server
Add the following to the file (create it if it doesn’t exist):
3
Restart Claude Desktop
Close and reopen Claude Desktop. It will detect the new server and open your browser to authorize access.
4
Verify the connection
In a new conversation, ask:
Options
Append query parameters to the MCP URL for additional control:Troubleshooting
'Add custom connector' not visible
'Add custom connector' not visible
Custom connectors require a Pro, Max, Team, or Enterprise plan. Check your subscription in Claude Desktop settings.
Connector added but not working
Connector added but not working
Make sure you’ve enabled the connector for the conversation. Click the + button in the chat input, then Connectors, and toggle Trilo on.
MCP server not detected (config file method)
MCP server not detected (config file method)
Double-check your config file path and JSON syntax. Use a JSON validator if needed — a missing comma or bracket will prevent the file from being parsed.
Tools not appearing
Tools not appearing
Restart Claude Desktop after adding the connector. Verify the URL is exactly
https://api.trilo.chat/mcp with no trailing slash.Session expired (error -32002)
Session expired (error -32002)
MCP sessions expire after 30 minutes of inactivity. Claude Desktop usually reconnects automatically. If not, restart the app.
