Windsurf

How to give Windsurf access to gray-matter

Set up in seconds, once. From then on, Windsurf gets things done for you: add one server entry, and gray-matter is live in Cascade.

Ask AI about this guide

gray-matter Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/mcp

Connecting gray-matter to Windsurf

About a minute, in Cascade

  1. 1In Cascade, click the MCPs icon (or go to Settings, Cascade, MCP Servers).
  2. 2Edit mcp_config.json and add gray-matter with the serverUrl field set to your link. The link above is the URL.
  3. 3Save and ask something real. gray-matter is now part of Windsurf.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "markdown-frontmatter-harvester-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/mcp"
    }
  }
}

Windsurf + gray-matter

One chat. Your gray-matter, live inside Windsurf.

Real prompts, answered with live data. This is the kind of session you will have in Windsurf once the server is in.

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

These prompts ship with the gray-matter Connector. Once yours is connected, they work in your sessions.

The full capability set, the prompts and the observed latency live on the gray-matter Connector page.

Mission Control

See everything your Windsurf agents do in gray-matter.

When Windsurf runs a tool in gray-matter, it happens in your editor: you see the result, but not the request itself, what data it carried, or whether a rule was broken.

Now every move lands on your screen.

Every execution is recorded, enforced, and shown to you: what ran, what it returned, what was blocked, and why.

AI Briefing
Upgrade to unlock

Know exactly what needs your attention before you even look at the charts. One briefing. The full picture. The next move.

Requests
0
Total in this period
Avg Latency
0
API 88ms · Overhead 54ms
Vinkius Reliability
0
Agent 280 · Upstream 47 · Vinkius 15
Tokens
0
AI tokens processed
DLP Protected
0
Sensitive data redacted
Cost Saved
0
FinOps truncations applied

AI Agents Activities

last 30 days
30d agotoday

Request Volume & Latency

requests latency

Every request your Windsurf agents make through gray-matter is logged, enforced and auditable. See how AI Governance turns agent activity into accountability, and what it means for your gray-matter workflows.

What sets us apart

It's not just the Connector that stays safe. Everything your agents do through it is.

Connecting gray-matter to your AI is step one. But an open line between your agents and gray-matter is only half the story: without protection, every action they take runs unguarded.

That's why protection doesn't stop at the door.

Every action your agents take through the Connector runs inside our infrastructure: signed activity logs, automatic key rotation, spending limits that pause instead of surprise, and a sandbox that isolates every execution.

01

Tamper Proof Activity Log

Every request your agents make in gray-matter is recorded and signed, so any change to the history becomes detectable.

02

Automatic Key Rotation

We rotate security keys every 24 hours. Your gray-matter connection stays protected without any manual work.

03

Spending Protection

We enforce the spending limit you choose and pause actions that exceed it until approval is received. Your gray-matter actions never surprise you.

04

Isolated Sandbox

Every execution through gray-matter runs isolated, with 34+ security rules covering memory, CPU, network access, file handling and execution.

05

Security Event Streaming

Security events flow to Splunk, Datadog or your own webhook, so gray-matter activity lands in the tools you already rely on.

06

Instant Resume

Idle connections resume in 3 to 5 ms while preserving their state, keeping your Windsurf sessions responsive.

07

Malicious File Protection

We detect compressed files designed to exhaust system resources and block them before they ever reach gray-matter.

08

Credential Validation

We test your gray-matter credentials before saving them. Invalid credentials are rejected instead of being stored.

09

Separate Usage Limits

Usage stays isolated per account, so activity in one connection never consumes another account's allowance.

One Connector, one link, and the whole operation is protected. Not just the connection: everything your agents do through it.

These guarantees are not add-ons: they are the infrastructure every gray-matter connection runs on. Read how our infrastructure protects everything your Windsurf agents do, end to end.

Inside Vinkius

Get gray-matter ready for your AI. It's easy.

You choose gray-matter from the Vinkius Catalog and get one connection link. That's it.

  1. You choose gray-matter

    You find gray-matter in the Catalog and install the Connector with one click.

    gray-matter

    Active

    Enable Connector
    Activating…
  2. You add the link in Windsurf

    Vinkius gives you one connection link. In Windsurf, you add gray-matter to mcp_config.json with the link in the serverUrl field, and the connection is ready.

    Token generated successfully

    MCP Connection URL

    https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/mcp

    Connection Token

    vk_live_••••••••
    Go to Dashboard

Set it up once. Use gray-matter with the AI you already use.

FAQ

Windsurf access questions.

  • 01

    Where does this work?

    In Cascade: the MCPs icon or Settings, Cascade, MCP Servers, with the config in ~/.codeium/windsurf/mcp_config.json and the serverUrl field for remote servers.

  • 02

    If I connect gray-matter to Gemini, can I use the same connection in Claude or ChatGPT later?

    Yes, and that's the point: the connection is yours, not Gemini's. You paste the same link in any AI you use, and there's nothing new to set up or pay again. Connect a new AI and gray-matter is already there.

  • 03

    Do I need to hand my gray-matter password to Gemini?

    Never. You sign in once at Vinkius, and we keep your logins encrypted and away from your AI. Gemini only ever sees the link, and you can remove it whenever you want.

  • 04

    What can I actually ask Gemini to do with gray-matter?

    Whatever the Connector covers: check data, run actions and bring answers back. The Connector page lists every capability your AI gains, with real examples you can copy.

  • 05

    Gemini doesn't show the Connector. What do I check?

    Make sure the entry was saved in mcp_config.json with the serverUrl pasted exactly as copied, then confirm the Connector is active in your Vinkius account. A deactivated Connector stops responding.

  • 06

    Can I remove the access later?

    Remove the entry from mcp_config.json and it's out of Cascade. Your Vinkius account keeps the connection and its history either way, ready for the next AI.

  • More questions about gray-matter? The Connector page answers them. See everything the gray-matter Connector can do

About the Connector

What gray-matter adds to your AI.

Once you connect it, your AI can take real actions in gray-matter when you ask. The Connector page lists every capability in detail, alongside the latency we measure in production and prompts worth trying first.

See everything the gray-matter Connector can do