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:
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:
If it returns your workspace data, you’re connected.

​
Options

Append query parameters to the MCP URL for additional control:

​
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.