How to Use the Coder (Remote Dev) MCP in Windsurf

Q: Can Windsurf debug a broken Coder (Remote Dev) workspace connection?

Yes, Cascade uses getagentdebuglogs and getagentdebugmagicsock to inspect the Coder connection. It analyzes the network logs and Coder agent startup manifest to pinpoint the exact failure point in Windsurf.

Spin up, monitor, and configure Coder (Remote Dev) workspaces autonomously using Windsurf Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Coder (Remote Dev) MCP to Windsurf

Create your Vinkius account to connect Coder (Remote Dev) 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 Coder (Remote Dev) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Control Workspace Lifecycles

This Coder (Remote Dev) MCP Server lets Cascade spin up, tear down, and manage remote environments using `create_workspace` and `cancel_workspace_build`. Instead of jumping to the Coder dashboard, your Windsurf agent handles the setup. Cascade tracks the build progress and stops Coder builds if things go sideways. Chaining these actions together, Cascade acts when you ask for a new Coder workspace. It calls Coder's `list_template_examples` to find a base, sets the parameters, and runs the build. You get a ready-to-use Coder environment without leaving your Windsurf editor.

Debug Agent Connections in Windsurf

Real-time debugging of Coder remote workspace environments runs through Windsurf using tools like `get_agent_debug_logs` and `get_agent_debug_magicsock`. When a remote Coder connection drops, Cascade doesn't just guess what happened. It pulls the last 10MiB of Coder agent logs and analyzes the Tailscale network state directly in Windsurf. The Windsurf agent checks `get_agent_containers` to see if your Coder devcontainer crashed. Port issues get diagnosed using `list_workspace_port_shares` and fixed on the fly. You bypass manual terminal troubleshooting entirely inside the Cascade interface.

Manage AI Bridge Sessions

Managing active Coder AI Bridge connections and chat sessions in Windsurf happens through `list_ai_sessions` and `create_chat_message`. Windsurf coordinates with Coder's gateway to trace prompt flows and run background tasks via `create_user_task`. Cascade uses the MCP connection to inspect active Coder interceptions and verify data routing. It keeps your remote Coder LLM context clean and aligned with your Windsurf workspace state.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "coder-remote-dev-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 Coder. 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 Coder (Remote Dev) 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 Coder (Remote Dev) MCP in Windsurf

Ask Cascade to create a Coder workspace from a template. The Windsurf agent calls `list_templates`, selects the template version, and executes `create_workspace` to build your remote Coder system.

Yes, Cascade uses `get_agent_debug_logs` and `get_agent_debug_magicsock` to inspect the Coder connection. It analyzes the network logs and Coder agent startup manifest to pinpoint the exact failure point in Windsurf.

Cascade reads and updates your environmental variables in Coder using `list_user_secrets` and `create_user_secret`. It keeps your remote Coder keys updated without exposing them in Windsurf plain text.

Add the MCP Server configuration under the mcpServers key in your Windsurf `mcp_config.json` file. Once saved, Cascade immediately discovers the Coder workspace management tools.

This server handles your Coder access tokens, workspace metadata, and agent logs inside Windsurf. All Coder traffic runs through a local V8 sandbox with encrypted transport, keeping your infrastructure credentials isolated from public networks.

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