How to Use the ONES MCP in Windsurf

Q: Does Cascade know which task type to use for bugs versus features?

It does if it checks the schema first. The agent calls listtasktypes to map your local terminology to the exact categories your product managers set up.

Let Windsurf's Cascade agent read your R&D context and update ONES tasks automatically while you stay focused on the codebase.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ONES MCP to Windsurf

Create your Vinkius account to connect ONES to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup ONES with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Let the MCP Server Chain Project States

Cascade doesn't just pull a ticket. You tell Windsurf to start working on a feature, and it hits `list_tasks` to figure out what's on your plate. It grabs the exact bug report using `get_task_details` without you ever opening a browser tab. The agent then checks `list_workflows` to find out what the next valid state is. Once you finish writing the code, Cascade fires off an `update_task` call to move the ticket to code review.

Map Engineering Teams to Code

Figuring out who owns what in a massive enterprise repository usually involves pinging three different Slack channels. Windsurf bypasses that noise entirely by running `list_members` right in your IDE. If a specific engineer opened the original issue, Cascade maps their UUID to the PR assignment. It pulls down the organizational structure via `get_org_info` to ensure the right product owner gets notified when you merge.

Auto-Generate Technical Epics

Breaking down a massive refactor into manageable chunks is tedious. You can just highlight a messy module, and Windsurf will use `list_projects` to locate the current R&D sprint backlog. From there, the MCP integration evaluates `list_task_types` to ensure it formats the stories correctly. It automatically loops through your planned architecture changes and triggers `create_task` for every individual component that needs work.

Setup guide

Set up ONES MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the ONES MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my ONES payment history." If connected, Cascade will call the ONES tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "ones-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ONES. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ONES now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ONES MCP in Windsurf

Open the Settings panel and navigate to the Cascade MCP Servers UI. You can also edit your `~/.codeium/windsurf/mcp_config.json` file to add the server endpoints manually. Hit refresh, and Cascade will auto-discover the tools immediately.

Yes, as long as you prompt Cascade to handle the workflow transition. The agent reads `list_workflows` to check the valid states and executes `update_task` right after you stage your commit.

Your agent might be looking at the wrong organization scope. Ask Cascade to run `list_projects` explicitly to dump the available project IDs into your context window. That usually clears up the confusion fast.

It does if it checks the schema first. The agent calls `list_task_types` to map your local terminology to the exact categories your product managers set up.

Your enterprise R&D project descriptions and task titles remain isolated within your local environment. The V8 Isolate Sandbox ensures that when Cascade pulls `get_task_details`, that specific text stays entirely ephemeral and never leaks into shared training pipelines.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript