> ## 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.

# Cursor setup

> Connect Cursor's agent to Fortress with mcp.json.

Use Cursor when Fortress should be available to Cursor Agent in one project or across the editor.

## Choose scope

| Scope   | File                 |
| ------- | -------------------- |
| Global  | `~/.cursor/mcp.json` |
| Project | `.cursor/mcp.json`   |

Use global config for a personal Fortress token. Use project config only when you are sure the file will not be committed with secrets.

## Add Fortress

Generate a **Cursor** setup snippet in Fortress and paste it into the chosen `mcp.json` file:

```json theme={"theme":"github-dark"}
{
  "mcpServers": {
    "fortress-agent": {
      "url": "https://api.fortressproductivity.com/mcp?agent_id=<agent-id>",
      "headers": {
        "Authorization": "Bearer ft_<token>"
      }
    }
  }
}
```

Cursor also supports environment interpolation in `url` and `headers`, so you can move the token to your shell environment:

```json theme={"theme":"github-dark"}
{
  "mcpServers": {
    "fortress-agent": {
      "url": "https://api.fortressproductivity.com/mcp?agent_id=<agent-id>",
      "headers": {
        "Authorization": "Bearer ${env:FORTRESS_TOKEN_AGENT}"
      }
    }
  }
}
```

## Verify

Restart Cursor if the server does not appear, enable the Fortress tools, and ask the agent to read `fortress://workspace/overview`.

See Cursor's [MCP documentation](https://cursor.com/docs/mcp.md).