Windsurf

Make Windsurf Cascade understand your work. One Horizon brings your assigned issues and recent accomplishments into Cascade so the AI can answer team questions, generate concise reports, and help you write better code with the right context.

When you finish something, it can auto-log what you did to your Done List.

Connecting

The Windsurf integration uses our remote MCP server over HTTP with OAuth.

Configure in Windsurf Settings

1. Open Windsurf
2. Go to Settings → Cascade → Open MCP Marketplace
3. Next to Installed MCPs, click the gear icon button
4. Add a custom MCP server with the following configuration:

{  "mcpServers": {    "onehorizon": {      "command": "npx",      "args": [        "mcp-remote@latest",        "https://mcp.onehorizon.ai/mcp"      ]    }  }}

After saving, a browser window will open asking you to connect and log in to verify the connection.

When you are successfully logged in, the server status will show as connected.

Activate in Cascade

Open Cascade (press Cmd/Ctrl+L or click the Cascade icon) and the One Horizon tools will be available automatically once connected.

The first call may take a moment to load. Windsurf will prompt you to authenticate - follow the browser window to log in and verify the connection.

What you can ask Cascade

"Show my planned work this week"

Cascade compiles a concise report of your assigned issues and tasks from tools like Linear or Jira.

"What's on my plate today"

Cascade pulls your assigned issues and tasks so you see today's work in one place.

"Log this work to my Done List"

Cascade summarizes what you just completed and adds it as a Completed Task to your Done List.

"What did I work on last week"

Cascade summarizes your completed items and related PRs/issues from the past week.

Security and permissions

The connector acts on your behalf. Data access follows your One Horizon roles, workspace membership, and scopes.

Troubleshooting

If you encounter issues connecting Windsurf to One Horizon:

• Ensure the MCP server URL is correctly entered: https://mcp.onehorizon.ai/mcp
• Verify your Windsurf plan includes Cascade and MCP features
• Check that you're logged into the correct One Horizon account in the authentication browser window
• Try restarting Windsurf if the connection fails
• If authentication loops, ensure you only have one One Horizon MCP server configured