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

# Set Up the Wolfia MCP Server in Claude, Cursor & Windsurf

> Connect Claude Code, Cursor, Windsurf, or any MCP client to Wolfia. Sign in once with OAuth to search your knowledge base and Slack answers in your editor.

## Overview

The Model Context Protocol (MCP) server brings Wolfia AI into the tools your team already works in, so they can chat, search, and pull answers without leaving their editor or terminal. Authentication is handled via OAuth, so you sign in once with your existing Wolfia account and the client stays connected.

The server is hosted at `https://api.wolfia.com/mcp/` and uses [mcp-remote](https://www.npmjs.com/package/mcp-remote) as a thin stdio shim that most clients already know how to spawn.

<Note>
  Connecting **directly** without the shim, putting Wolfia behind a **gateway** (Runlayer, Cloudflare AI Gateway, etc.), or hitting an `Invalid redirect URI` error? See [MCP OAuth, direct connections & gateways](/how-to/mcp-server-oauth) for the full OAuth contract, redirect URI rules, and why Wolfia needs no manual allowlist.
</Note>

## Supported clients

| Client                                                        | Type                  |
| ------------------------------------------------------------- | --------------------- |
| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | CLI / Terminal        |
| [Claude Desktop](https://claude.ai/download)                  | Desktop app           |
| [Cursor](https://cursor.com)                                  | IDE                   |
| [Windsurf](https://codeium.com/windsurf)                      | IDE                   |
| [OpenClaw](https://github.com/openclaw/openclaw)              | Local AI agent        |
| Any other MCP-compatible client (custom agents, desktop apps) | Desktop / CLI / Agent |

## Available tools

Once connected, your client can chat with Wolfia AI, search your knowledge base and Slack history, read documents, submit questionnaires, and manage knowledge and settings, all scoped to your Wolfia permissions.

<Card title="Browse every MCP tool" icon="screwdriver-wrench" href="/how-to/mcp-tools">
  See the full tool reference, grouped by category (chat, knowledge search, documents, Slack, questionnaires, knowledge management, AI customization, and trust center), with what each tool does and which role it needs.
</Card>

Every tool respects your organization's permissions, so you only see and change content you already have access to in Wolfia.

## Setup

### Claude Code

Add Wolfia with a single command:

```bash theme={null}
claude mcp add wolfia -- npx -y mcp-remote@latest https://api.wolfia.com/mcp/
```

### Cursor / Windsurf

Add the following to your MCP configuration file:

| Client   | Config file location                                  |
| -------- | ----------------------------------------------------- |
| Cursor   | `.cursor/mcp.json` in your project or global settings |
| Windsurf | `.windsurf/mcp.json` or IDE settings                  |

```json theme={null}
{
  "mcpServers": {
    "wolfia": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.wolfia.com/mcp/"]
    }
  }
}
```

### Claude Desktop

Edit `claude_desktop_config.json` (Settings, then Developer, then Edit Config):

```json theme={null}
{
  "mcpServers": {
    "wolfia": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.wolfia.com/mcp/"]
    }
  }
}
```

### OpenClaw

OpenClaw can spawn standard stdio MCP servers. Add Wolfia to your OpenClaw MCP config (typically `~/.openclaw/mcp.json` or the equivalent in your OpenClaw settings):

```json theme={null}
{
  "mcpServers": {
    "wolfia": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.wolfia.com/mcp/"]
    }
  }
}
```

On first use, OpenClaw will launch a browser window for OAuth sign-in. After you authorize, all Wolfia tools become available to your local agent.

### Other MCP clients (custom agents, desktop apps)

Any client that can spawn a stdio MCP server works. Point it at `mcp-remote` with the Wolfia endpoint:

```json theme={null}
{
  "mcpServers": {
    "wolfia": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://api.wolfia.com/mcp/"]
    }
  }
}
```

If your client speaks remote MCP (streamable HTTP) natively without a stdio shim, connect directly to `https://api.wolfia.com/mcp/` and let the client handle the OAuth dance.

<Note>
  After editing the config file, restart your application for changes to take effect.
</Note>

## Authentication

The first time you use Wolfia, you'll be prompted to authenticate:

1. A browser window opens automatically
2. Sign in with your existing Wolfia account (SSO or email)
3. Authorize the application to access Wolfia
4. Return to your app, you're now connected

Tokens are cached locally by `mcp-remote` (typically under `~/.mcp-auth/`), so you only sign in once per client.

<Note>
  You must have an existing Wolfia account to use the MCP server. If you don't have one, [sign up at wolfia.com](https://wolfia.com) first.
</Note>

## Troubleshooting

### Authentication errors

If authentication fails:

* Clear your browser cookies for wolfia.com and try again
* Clear the local `mcp-remote` token cache (`rm -rf ~/.mcp-auth`) and reconnect
* Ensure you're using the same account that has access to your Wolfia organization

### `Invalid redirect URI`

The client (or your gateway) sent a redirect URI that Wolfia rejects. There is no Wolfia-side allowlist to change, the fix lives in your client or gateway config. See [MCP OAuth: redirect URI rules and troubleshooting](/how-to/mcp-server-oauth#redirect-uri-rules) for the exact rules and how to fix it.

### Tools don't appear

* Restart the client after editing the config file
* Check that `npx` is on your PATH (`npx --version`)
* Check your client's MCP logs. Claude Code: `claude mcp list`. Cursor/Windsurf: MCP panel in settings

## Requirements

* An MCP-compatible client
* A Wolfia account with access to your organization
* Node.js 18+ (for `npx`)