How to Use the Nuclino MCP in Windsurf

Q: How does Windsurf use Nuclino to find my docs?

Cascade performs semantic queries using searchitems to locate specific documents across your entire team. It returns the exact UUIDs needed to pull content into your chat.

Q: Can Windsurf manage my Nuclino team members?

Yes, your agent calls listusers to see who is active in the organization. This helps when you need to assign documentation tasks or verify authorship on a specific page.

Q: Will Windsurf accidentally delete my Nuclino data?

The server forces a verification step before deleteitem runs. You are always in control of what gets wiped from your workspace.

Q: Does this MCP Server support file attachments?

It does. You can use listfiles to see every image or document bolted onto an item, giving your agent full visibility into your knowledge base.

Let Cascade autonomously manage your wiki. Connect this MCP Server to Windsurf and watch your agent handle documentation edits in real-time.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nuclino MCP to Windsurf

Create your Vinkius account to connect Nuclino 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 Nuclino with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full document control for Windsurf

Cascade reads your workspace state using `list_workspaces` and `list_items` to understand the structure before acting. It maps your project context directly to your wiki. You can tell Cascade to update a page and it uses `update_item` to push changes instantly. It handles the data sync so you stay focused on the code.

Automated wiki organization

Your agent uses `list_collections` and `list_fields` to categorize new content correctly. It ensures every piece of knowledge lands in the right folder based on your project needs. When information needs a home, the agent calls `create_item` to build the structure. It organizes your team knowledge without you moving a single file.

Safe content destruction

Deleting old data shouldn't be a guessing game. This MCP Server requires explicit confirmation before triggering `delete_item` to prevent accidental loss. Cascade checks the `get_item` payload first to confirm it has the right target. You get a clear summary of what's being removed before the action completes.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "nuclino-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 Nuclino. 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 Nuclino 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 Nuclino MCP in Windsurf

Cascade performs semantic queries using `search_items` to locate specific documents across your entire team. It returns the exact UUIDs needed to pull content into your chat.

Yes, your agent calls `list_users` to see who is active in the organization. This helps when you need to assign documentation tasks or verify authorship on a specific page.

The server forces a verification step before `delete_item` runs. You are always in control of what gets wiped from your workspace.

It does. You can use `list_files` to see every image or document bolted onto an item, giving your agent full visibility into your knowledge base.

Your data stays within your authorized team boundaries. The server only accesses the specific objects requested by your agent and does not store your credentials.

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