How to Use the Cody AI MCP in Windsurf

Q: How do I configure Cody AI with Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the MCP server under the mcpServers block. Alternatively, use the Cascade settings UI to paste the Vinkius connection URL.

Q: Does the Cody AI MCP Server support custom folder structures in Windsurf?

Yes. Cascade uses listfolders to find your target directory before uploading new knowledge files. This ensures your documents land exactly where they belong.

Q: How do I test bot replies using this server?

You can ask Cascade to run tests by calling createconversation and sendmessage in sequence. It will read the response and output the results directly in your IDE pane.

Control your Cody AI knowledge bases directly from Windsurf using this managed MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cody AI MCP to Windsurf

Create your Vinkius account to connect Cody AI to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Cody AI with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sync web docs via the Cody AI MCP Server

`import_webpage` lets Cascade pull external documentation directly into your Cody folders. Cascade starts the import, then uses `get_document_status` to track when the file finishes processing. This chain happens without you babying the terminal. If a library updates, Cascade grabs the URL, updates your knowledge base, and verifies the sync status before writing any code.

Run support simulations in Windsurf

`create_conversation` spins up a direct test session with any bot listed in your account. Cascade initiates the session, then uses `send_message` to feed it user queries and verify responses. You don't need to jump back and forth to a web browser to test your bot's behavior. The tool feeds the raw message history through `list_messages` so Cascade can analyze the exact output.

Manage bots and folders in one view

`list_bots` retrieves all your active Cody AI bots and exposes their metadata to Cascade. Your agent uses `get_bot_details` to inspect configuration details, while `list_folders` maps your entire document hierarchy. Instead of manual organization, Cascade parses this structure to find where raw data belongs. It can identify empty folders or find which bot has access to specific files.

Setup guide

Set up Cody AI 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 Cody AI 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 Cody AI payment history." If connected, Cascade will call the Cody AI tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "cody-ai-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 Cody AI. 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 Cody AI 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 Cody AI MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the MCP server under the `mcpServers` block. Alternatively, use the Cascade settings UI to paste the Vinkius connection URL.

Yes, Cascade handles multi-tool chains on its own. For example, it can use `import_webpage` to pull a document and then poll `get_document_status` until the sync is complete.

Yes. Cascade uses `list_folders` to find your target directory before uploading new knowledge files. This ensures your documents land exactly where they belong.

You can ask Cascade to run tests by calling `create_conversation` and `send_message` in sequence. It will read the response and output the results directly in your IDE pane.

Your raw document metadata and content are processed entirely in memory within Vinkius's ephemeral V8 Isolate sandbox. No files are stored permanently, and the connection closes immediately after the task completes.

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