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 6 tools:

• read: read a Falconer document by ID, title, or URL
• search: search across your Falconer documents
• create: create a new Falconer document in your private space
• edit: make targeted edits to an existing document by replacing specific text
• overwrite: replace a document’s full content with new Markdown
• delete: archive a document by ID

Document responses include visibility status (private, shared, or published) so you know who can access each doc.

1. Install CLI and authenticate

npm install -g @falconer/cli
falconer oauth login

This opens your browser for OAuth authentication. No API key required — just sign in with your Falconer account. Your credentials are stored at ~/.config/falconer/config.json.

Multi-org access

If you belong to multiple organizations, you can list and switch between them:

falconer oauth org list        # List available organizations
falconer oauth org set <org>   # Switch to a different organization

Custom base URL (on-prem)

If you’re using a self-hosted Falconer instance, configure the base URL:

falconer config set base-url https://your-falconer-instance.com

2. Add MCP server

Claude Code:

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

Cursor:

Add to your ~/.cursor/mcp.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.