Skip to main content
Get your AI coding tool connected to Trilo in a few minutes. You’ll create a Personal Access Token, add the MCP server to your client, and verify the connection.

​
Step 1: Create a Personal Access Token

1

Open Profile Settings

In Trilo, click your avatar in the bottom-left corner and select Profile Settings.
2

Go to the API section

Select the API tab in the settings sidebar.
3

Create a new token

Click Create Token. Give it a descriptive name (e.g., “Claude Code - work laptop”) and select the scopes you need:
  • mcp:read — read workspace data
  • mcp:write — read and write workspace data
  • mcp:admin — full administrative access
4

Copy your token

Copy the token immediately — it won’t be shown again. The token starts with trilo_pat_.
Store your token securely. If you lose it, you’ll need to create a new one. Never commit tokens to version control.

​
Step 2: Configure Your AI Client

If you prefer using a Personal Access Token instead of OAuth:
claude mcp add trilo \
  --transport http \
  https://api.trilo.chat/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"
Replace YOUR_TOKEN_HERE with the PAT you copied.Alternatively, add it to your MCP config file (~/.claude/mcp.json):
{
  "mcpServers": {
    "trilo": {
      "type": "http",
      "url": "https://api.trilo.chat/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
If you prefer using a Personal Access Token instead of OAuth:
{
  "mcpServers": {
    "trilo": {
      "type": "http",
      "url": "https://api.trilo.chat/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
Replace YOUR_TOKEN_HERE with the PAT you copied. After saving, restart Claude Desktop for the changes to take effect.
Option A — Settings UI:
  1. Open Cursor Settings > MCP
  2. Click Add MCP Server
  3. Set the URL to https://api.trilo.chat/mcp
  4. Add the Authorization header with your PAT
Option B — Config file:Create or edit .cursor/mcp.json in your project root:
{
  "mcpServers": {
    "trilo": {
      "type": "http",
      "url": "https://api.trilo.chat/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
Option A — Settings UI:
  1. Open Windsurf Settings > MCP
  2. Add a new server with the URL https://api.trilo.chat/mcp
  3. Add the Authorization header with your PAT
Option B — Config file:Edit ~/.windsurf/mcp.json:
{
  "mcpServers": {
    "trilo": {
      "type": "http",
      "url": "https://api.trilo.chat/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
  1. Open an Agent session and click the ”…” menu at the top of the side panel
  2. Select MCP Servers to open the MCP Store
  3. Click Manage MCP Servers at the top, then View raw config
  4. Add Trilo to your mcp_config.json:
{
  "mcpServers": {
    "trilo": {
      "serverUrl": "https://api.trilo.chat/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
  1. Save the file and click Refresh in the Manage MCP Servers view
Any MCP-compatible client can connect using the HTTP Streamable transport:
  • Endpoint: https://api.trilo.chat/mcp
  • Transport: HTTP (Streamable HTTP)
  • Authentication: Authorization: Bearer trilo_pat_...
The server implements the standard MCP Streamable HTTP transport.

​
Step 3: Verify the Connection

Ask your AI tool to list your workspaces: 
You: List my Trilo workspaces
AI: I found 1 workspace: "Acme Corp" (id: abc-123...)
If the tool responds with workspace data, you’re connected.

​
Optional: Restrict to a Workspace

To limit the MCP connection to a specific workspace, append the workspace_id query parameter: 
https://api.trilo.chat/mcp?workspace_id=YOUR_WORKSPACE_ID

​
Optional: Read-Only Mode

To force read-only access regardless of token scopes, append: 
https://api.trilo.chat/mcp?read_only=true

​
Managing Tokens

  • View tokens: Profile Settings > API shows all your active tokens with last-used dates
  • Revoke a token: Click the revoke button next to any token to immediately disable it
  • Multiple tokens: Create separate tokens per client or machine for easy revocation
Create separate tokens for each AI tool or machine. If one is compromised, you can revoke it without affecting your other tools.

​
Troubleshooting

  • 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
Your token was created without MCP scopes. Create a new token and select at least mcp:read.
MCP sessions expire after 30 minutes of inactivity. Most clients reconnect automatically. If not, restart the MCP connection in your client.
You’re making too many requests. Wait for the duration specified in the Retry-After header. Rate limits are per-user, not per-token.
Either your token only has mcp:read scope, or the read_only=true query parameter is set. Create a new token with mcp:write scope or remove the query parameter.
Some clients require a restart after adding MCP servers. Try restarting your AI tool. Also verify the URL is exactly https://api.trilo.chat/mcp with no trailing slash.