Claude Code + Trilo MCP Setup

Claude Code is Anthropic’s agentic coding tool for the terminal. It supports both OAuth (recommended) and PAT authentication for MCP connections.

Setup with OAuth (Recommended)

The fastest way to connect — no token needed.

Add the MCP server

In your terminal, run:

claude mcp add --transport http --scope user trilo https://api.trilo.chat/mcp

The --scope user flag makes Trilo available across all your projects. Use --scope local (default) to limit it to the current project only.

Authenticate

Inside Claude Code, run the /mcp command. Select Authenticate for the Trilo server — this will open your browser to authorize access to your Trilo account.

Verify the connection

Back in Claude Code, ask:

List my Trilo workspaces

If it returns your workspace data, you’re all set.

Setup with PAT (Alternative)

If you prefer a Personal Access Token instead of OAuth:

Create a token

In Trilo, go to Profile Settings > API > Create Token. Select the scopes you need (mcp:read, mcp:write) and copy the token.

Add the MCP server

Option A — CLI command:

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer YOUR_TOKEN_HERE" \
  trilo https://api.trilo.chat/mcp

Option B — Config file (~/.claude.json):

{
  "mcpServers": {
    "trilo": {
      "type": "http",
      "url": "https://api.trilo.chat/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

You can also use .mcp.json in your project root to share the config with your team (supports environment variable expansion like ${TRILO_PAT}).

Verify the connection

Ask Claude Code:

List my Trilo workspaces

Options

You can append query parameters to the MCP URL for additional control:

Parameter	Description	Example
`workspace_id`	Restrict to a specific workspace	`https://api.trilo.chat/mcp?workspace_id=abc-123`
`read_only`	Force read-only mode	`https://api.trilo.chat/mcp?read_only=true`

Troubleshooting

OAuth browser doesn't open

Make sure you run /mcp inside Claude Code to trigger the authentication flow. If the browser still doesn’t open, check that you have a default browser configured.

401 Unauthorized (PAT)

Verify your token starts with trilo_pat_ and is copied correctly
Check that the Authorization header uses the Bearer prefix
Confirm the token hasn’t been revoked in Profile Settings > API

Tools not appearing

Try restarting Claude Code. Run /mcp to check the server status. Also verify the URL is exactly https://api.trilo.chat/mcp with no trailing slash.

Session expired (error -32002)

MCP sessions expire after 30 minutes of inactivity. Claude Code usually reconnects automatically. If not, run /mcp and re-authenticate.

​Setup with OAuth (Recommended)

​Setup with PAT (Alternative)

​Options

​Troubleshooting

Setup with OAuth (Recommended)

Setup with PAT (Alternative)

Options

Troubleshooting