A desktop coding agent with free access to frontier models.
TypeScript
---
title: "OmniRush.ai MCP for Windsurf"
sidebarTitle: "Windsurf"
description: "Windsurf MCP setup for OmniRush.ai Connect through mcp-remote and OAuth access to your org's shared capabilities."
---
The OmniRush.ai MCP server ([OmniRush.ai Connect](/cloud/run-in-the-cloud/cloud-mcp))
enables Windsurf to use the OmniRush.ai capabilities your organization has made
available to you: Gmail read/search, Calendar list/create, Drive search/read,
Gmail draft creation, shared MCP connections such as Notion, Linear, Slack,
Stripe, Exa, and Context7, shared skills, and OmniRush.ai Cloud resources like
skills, plugins, Collections, workers, members, roles, teams, and LLM
providers. The server exposes only `search_capabilities` and
`execute_capability`, so Windsurf searches what you can access and runs exact
capability names instead of loading hundreds of tool definitions into context.
## Server URL
```text
https://api.omnirush.example.com/mcp/agent
```
omnirush.ai does not run a hosted Den, so there is no public endpoint: use the
`/mcp/agent` URL on the API origin of your [self-hosted Den](/start-here/self-host)
(`api.omnirush.example.com` above is a placeholder). OAuth sign-in uses your
account on that Den, and the organization you pick is pinned into the token.
## Setup
1. Open Windsurf `Settings` > `Cascade` > `MCP Servers`.
2. Click `Manage MCP Servers`, then `View raw config`.
3. Add this to `~/.codeium/windsurf/mcp_config.json`:
```json
{
"mcpServers": {
"omnirush": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://api.omnirush.example.com/mcp/agent"]
}
}
}
```
`mcp-remote` handles the browser OAuth on an HTTP loopback callback, which
OmniRush.ai accepts.
## Switch organizations
Remove the stored MCP auth token for `omnirush`, then restart the server and
choose the organization you want during browser sign-in.
<Note>
This is a setup guide. These steps match OmniRush.ai Connect's OAuth profile:
HTTPS or HTTP loopback callbacks, PKCE S256, and dynamic client registration
fallback. Windsurf is listed as setup only because native proof is not complete.
See the
[client support status](/cloud/run-in-the-cloud/cloud-mcp#client-support-status)
table.
</Note>
## What you can ask
- "Which OmniRush.ai organization am I connected to?"
- "Add [email protected] to my organization."
- "Create a skill that writes weekly status reports and share it with my whole organization."
- "Find the Q3 launch page in Notion and summarize it."
## What's next
- Read the [hub overview](/cloud/run-in-the-cloud/cloud-mcp) for OAuth, token,
server exposure, and troubleshooting details.
- Publish Notion, Linear, Slack, and other shared tools with
[shared MCP connections](/cloud/share-with-your-team/shared-mcp-connections).