Connect Vynix to Windsurf

Why connect Windsurf to Vynix

Cascade edits confidently when it knows precisely what changed and where. Vynix supplies that context for every note: the resolved selector, the DOM snippet, the computed styles, the viewport, and any console or network error at capture time. Over MCP, Windsurf reads it on demand and skips the screenshot-and-guess cycle.

Before you begin

• The Vynix widget installed on the site you collect feedback on.
• At least one annotation in a Vynix project.
• Windsurf updated to a version with MCP support.
• Node.js 18 or newer (the server runs via npx).

Get your Vynix API token

Create a personal API token in your Vynix account and copy it. It authenticates the MCP server as you and is revocable at any time.

Add the Vynix MCP server to Windsurf

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. You can also open it from the Cascade panel via Manage MCP servers, then Add server. Paste the Vynix entry and your token:

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": { "VYNIX_API_TOKEN": "your-token-here" }
    }
  }
}

Refresh the MCP servers list in Cascade. The vynix server should connect and expose its tools. If not, confirm Node is on your PATH and the token is correct.

What Windsurf can do with your feedback

• List projects and open annotations from Cascade.
• Read a note's element, selector, XPath, styles, DOM, and runtime errors.
• Generate a coding prompt or an AI diagnosis with ranked root causes and likely files.
• Update status, add a comment, and open a GitHub issue from the note.

A typical loop in Windsurf

Ask Cascade "what feedback do I have open?" It lists your notes; say "fix annotation 2" and it reads the captured context, edits the exact element, and marks the note resolved with a short comment. Your reviewers watch the notes close in the dashboard.