Skip to main content
Windsurf Windsurf Windsurf is an AI-powered code editor. Connect it to Trilo via MCP to manage your workspace directly from the editor.
Windsurf uses serverUrl instead of url in its MCP config — make sure to use the correct field name.

​
Setup

1

Create a Personal Access Token

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

Add the MCP server

Choose one of these options:Option A — Settings UI:
  1. Open Windsurf Settings > Cascade > MCP Servers (or click the MCPs icon in the Cascade panel)
  2. Click Configure to add a new server
  3. Set the URL to https://api.trilo.chat/mcp
  4. Add the Authorization header with your PAT
Option B — Config file:Edit ~/.codeium/windsurf/mcp_config.json:
{
  "mcpServers": {
    "trilo": {
      "serverUrl": "https://api.trilo.chat/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
Replace YOUR_TOKEN_HERE with the PAT you copied.
You can use environment variables in the config: "Authorization": "Bearer ${env:TRILO_PAT}" to avoid hardcoding your token.
3

Verify the connection

In Windsurf’s AI chat, ask:
List my Trilo workspaces
If it returns your workspace data, you’re connected.

​
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

  • Verify your token starts with trilo_pat_
  • Check the Authorization header uses the Bearer prefix
  • Confirm the token hasn’t been revoked in Profile Settings > API
Restart Windsurf after adding the MCP server. Verify you used serverUrl (not url) in the config, and that the URL is exactly https://api.trilo.chat/mcp with no trailing slash.
MCP sessions expire after 30 minutes of inactivity. Windsurf usually reconnects automatically. If not, restart the editor.