> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kyberis.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Windsurf Setup

> Install the Kyberis skill and connect Windsurf to Kyberis through MCP.

Before you run the setup commands, install [Node.js 20 or newer with `npx`](/install/node-npx).

## Install the Skill

Install the Kyberis skill so Windsurf has the investigation workflow and response handling rules.

```bash theme={null}
npx -y @kyberis-ai/agent-skills install windsurf
```

## Connect MCP

Use a one-time connect token from Kyberis:

```bash theme={null}
npx -y @kyberis-ai/mcp connect windsurf --token kct_abc123
```

The connector exchanges the token and updates Windsurf's MCP configuration at `~/.codeium/windsurf/mcp_config.json` by default.

Use `--dry-run` if you want to preview the configuration without changing local files:

```bash theme={null}
npx -y @kyberis-ai/mcp connect windsurf --token kct_abc123 --dry-run
```

Use `--json` if you need machine-readable connection details:

```bash theme={null}
npx -y @kyberis-ai/mcp connect windsurf --token kct_abc123 --json
```

## Verify

Ask Windsurf:

```text theme={null}
Use Kyberis to prioritize current threats for a healthcare environment running Microsoft Exchange and Okta.
```

## Troubleshooting

* If the connect token is expired or already used, generate a new setup command in Kyberis.
* If Windsurf reports no Kyberis tools, check `~/.codeium/windsurf/mcp_config.json` and the bearer header.
* If a tool returns `insufficient_scope`, ask for an API key with the required scopes.