Windsurf

Connect Shipchart to Windsurf to manage your portfolio from Codeium's AI IDE.

1. Generate an API token

Log in to Shipchart and go to Settings → API Tokens. Click Create Token with read and write abilities. Copy the token immediately.

2. Add the MCP server

Open Windsurf and go to Windsurf Settings → Cascade → MCP Servers (or press Cmd+Shift+P and search "MCP").

Click Add Server. You can also edit the config file directly at ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "shipchart": {
      "serverUrl": "https://shipchart.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Note: Windsurf uses serverUrl instead of url.

3. Restart Windsurf

Restart Windsurf so it picks up the new config. Open the MCP settings panel to verify the server shows as connected.

4. Test it

Open Cascade and try:

"What's my current monthly revenue (across all projects)?"

Troubleshooting

Server not connecting

Make sure the config file is at the correct path and the JSON is valid. Check that you're using serverUrl (not url).

Authentication errors

Check that the token is correct and hasn't been revoked. Generate a new token in Settings if needed.

For available tools, prompts, and resources, see the MCP Overview.