Skip to main content
Claude Desktop Claude Desktop is Anthropic’s desktop app for Claude. The easiest way to connect is through the Connectors UI, which handles OAuth automatically — no token needed.
Custom connectors require a Pro, Max, Team, or Enterprise plan.
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:
https://api.trilo.chat/mcp
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:
List my Trilo workspaces
If it returns your workspace data, you’re connected.
Team / Enterprise plans: An Organization Owner must add the connector first via Organization settings > Connectors. Members can then connect individually from Settings > Connectors by clicking Connect next to the Trilo connector.

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:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
2

Add the Trilo MCP server

Add the following to the file (create it if it doesn’t exist):
{
  "mcpServers": {
    "trilo": {
      "type": "http",
      "url": "https://api.trilo.chat/mcp"
    }
  }
}
If you already have other MCP servers configured, add the "trilo" entry inside the existing "mcpServers" object.
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:
List my Trilo workspaces
Claude Desktop does not connect to remote MCP servers configured with headers in claude_desktop_config.json. For PAT-based authentication, use the Connectors UI with Advanced settings, or use Claude Code instead.

Options

Append query parameters to the MCP URL for additional control:
ParameterDescriptionExample
workspace_idRestrict to a specific workspacehttps://api.trilo.chat/mcp?workspace_id=abc-123
read_onlyForce read-only modehttps://api.trilo.chat/mcp?read_only=true

Troubleshooting

Custom connectors require a Pro, Max, Team, or Enterprise plan. Check your subscription in Claude Desktop settings.
Make sure you’ve enabled the connector for the conversation. Click the + button in the chat input, then Connectors, and toggle Trilo on.
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.
Restart Claude Desktop after adding the connector. Verify the URL is exactly https://api.trilo.chat/mcp with no trailing slash.
MCP sessions expire after 30 minutes of inactivity. Claude Desktop usually reconnects automatically. If not, restart the app.