# Set up MCP and CLI

Give your AI coding agents (Claude Code, Cursor, and others) direct access to read, search, and create Falconer documents without leaving your development environment.

## Capabilities

You can use the MCP from Claude code, Claude desktop, Cursor, Codex, and anything that runs locally.

The Falconer MCP and CLI expose 4 functions:

- `read`: allows your agents to read Falconer docs that you give it the link to
- `search`: searches across your Falconer documents
- `create`: write a new Falconer document to your private space, where you can clean it up and publish it to the company-wide information architecture
- `edit`: make targeted edits to an existing Falconer document by providing the document identifier

If you have a use case for any other functionality, reach out to us!

## 1. Install CLI and authenticate

```bash
npm install -g @falconer/cli
falconer login
```

Generate your API key in the Falconer UI, then enter it when prompted. Your credentials are stored at `~/.config/falconer/config.json`.

## 2. Add MCP server

**Claude Code**:

```bash
claude mcp add falconer --scope user -- npx @falconer/mcp@latest
```

**Cursor**:

Add to your `~/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "falconer": {
      "command": "npx",
      "args": ["@falconer/mcp@latest"]
    }
  }
}
```

## 3. Verify

- **Claude Code**: Restart and run `/mcp`
- **Cursor**: Open Command Palette -> "View: Open MCP Settings"

## Next steps

Once connected, learn how to use the MCP to read, search, create, and edit your Falconer docs from your coding agent: [Read, write, and update docs with the MCP](/docs/set-up/read-write-and-update-docs-with-the-mcp).