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

# Provider setup

> Connect Fortress MCP to Claude, Codex, Cursor, Windsurf, VS Code, Gemini CLI, OpenClaw, OpenRouter Spawn, and generic clients.

Fortress is a remote Streamable HTTP MCP server. Each agent gets a scoped URL, a namespaced server key, and either a bearer-token setup snippet or an OAuth connector flow.

Create one Fortress agent identity per runtime. Reusing one token across Claude Code, Cursor, and a cloud agent makes audit history and permissions harder to reason about.

<Columns cols={2}>
  <Card title="Claude Code" icon="terminal" href="/agents/providers/claude-code">
    Terminal setup with `claude mcp add --transport http`.
  </Card>

  <Card title="Claude Desktop" icon="radar" href="/agents/providers/claude-desktop">
    Remote custom connector setup through Settings > Connectors and Fortress OAuth.
  </Card>

  <Card title="Codex" icon="bot" href="/agents/providers/codex">
    CLI and IDE-extension setup using shared Codex MCP configuration.
  </Card>

  <Card title="Cursor" icon="compass" href="/agents/providers/cursor">
    `~/.cursor/mcp.json` or project `.cursor/mcp.json`.
  </Card>

  <Card title="Windsurf" icon="waves" href="/agents/providers/windsurf">
    Cascade MCP setup using `serverUrl` in `mcp_config.json`.
  </Card>

  <Card title="VS Code" icon="brackets" href="/agents/providers/vscode">
    GitHub Copilot Agent mode using VS Code's `servers` config shape.
  </Card>

  <Card title="Gemini CLI" icon="sparkles" href="/agents/providers/gemini-cli">
    User-scoped HTTP MCP setup with `gemini mcp add`.
  </Card>

  <Card title="OpenClaw" icon="crosshair" href="/agents/providers/openclaw">
    Saved MCP server registry using `streamable-http`.
  </Card>

  <Card title="OpenRouter Spawn" icon="orbit" href="/agents/providers/openrouter-spawn">
    Add Fortress inside the spawned runtime or custom Agent SDK harness.
  </Card>

  <Card title="Generic MCP" icon="plug-zap" href="/agents/providers/generic">
    Standard remote HTTP endpoint plus `Authorization` header.
  </Card>
</Columns>

## Choose a preset

| Runtime          | Fortress preset    | Setup path                              | Auth                 |
| ---------------- | ------------------ | --------------------------------------- | -------------------- |
| Claude Code      | `claude_code`      | Shell command                           | Bearer token header  |
| Claude Desktop   | `claude_desktop`   | Settings > Connectors                   | OAuth                |
| Codex CLI / IDE  | `codex`            | Shell command or `~/.codex/config.toml` | Bearer token env var |
| Cursor           | `cursor`           | `mcp.json`                              | Bearer token header  |
| Windsurf Cascade | `windsurf`         | `mcp_config.json`                       | Bearer token header  |
| VS Code Copilot  | `vscode`           | User or workspace `mcp.json`            | Bearer token header  |
| Gemini CLI       | `gemini_cli`       | Shell command                           | Bearer token header  |
| OpenClaw         | `openclaw`         | `openclaw mcp set`                      | Bearer token header  |
| OpenRouter Spawn | `openrouter_spawn` | Inside the spawned runtime              | Runtime-specific     |
| Other MCP client | `generic`          | Client-specific MCP file                | Bearer token header  |

## Verify any provider

After adding Fortress, ask the agent to read:

```text theme={"theme":"github-dark"}
fortress://workspace/overview
```

That proves the client can reach Fortress, authenticate as the intended agent, and receive the workspace starting context.

<Warning>
  Most generated snippets include a permanent `ft_` bearer token. Keep them in user-level config or
  a secret manager. Do not commit them to a repository.
</Warning>