# Connect MCP

import { LinkButton } from '@astrojs/starlight/components';

Connect Falconer MCP to your AI client so it can search, read, create, and update Falconer documents.

Falconer's MCP endpoint is:

```text
https://falconer.com/api/mcp
```

When your client connects, it opens Falconer OAuth in your browser. Sign in with your Falconer account and approve the connection.

## Claude

Falconer supports both Claude.ai and Claude Code: add Falconer to Claude.ai as a custom connector, or configure Falconer in Claude Code from the command line.

**Claude.ai**

<LinkButton href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Falconer&connectorUrl=https%3A%2F%2Ffalconer.com%2Fapi%2Fmcp" target="_blank" rel="noopener noreferrer">
  Add to Claude.ai
</LinkButton>

This opens Claude with the Falconer connector name and MCP URL prefilled. Connect the connector, then sign in to Falconer when Claude asks for authorization.

Manual setup:

1. Open [Claude connectors](https://claude.ai/customize/connectors).
2. Click **Add custom connector**.
3. Set **Name** to `Falconer`.
4. Set the MCP server URL to `https://falconer.com/api/mcp`.
5. Leave **OAuth Client ID** and **OAuth Client Secret** empty.
6. Click **Add**, connect the Falconer connector, and sign in to Falconer when Claude asks for authorization.

![Claude.ai Add custom connector modal with Falconer name and MCP server URL](/docs/images/falconer-mcp-claude-connector.png)

**Claude Code**

Run this command in a terminal:

```bash
claude mcp add --transport http --scope user --client-id falconer-claude-code --callback-port 49152 "falconer" "https://falconer.com/api/mcp"
```

Then open Claude Code and run:

```text
/mcp
```

Follow the browser sign-in flow. If port `49152` is unavailable, change it to another local callback port and rerun the command.

![Claude Code MCP settings showing Falconer connected](/docs/images/falconer-mcp-claude-code-connected.png)

## Cursor

Falconer supports both Cursor surfaces: add Falconer to the Cursor app for editor workflows, or configure Cursor Agent for agent sessions.

**Cursor app**

<LinkButton href="cursor://anysphere.cursor-deeplink/mcp/install?name=Falconer&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZmFsY29uZXIuY29tL2FwaS9tY3AifQ%3D%3D">
  Add to Cursor app
</LinkButton>

This opens Cursor with Falconer's MCP configuration. Connect the Falconer server, then sign in to Falconer when Cursor asks for authorization.

For manual setup, create or update `.cursor/mcp.json` in your project:

```json
{
  "mcpServers": {
    "Falconer": {
      "type": "http",
      "url": "https://falconer.com/api/mcp"
    }
  }
}
```

Open Cursor MCP settings and complete the Falconer OAuth flow if prompted.

**Cursor Agent**

<LinkButton href="https://cursor.com/agents" target="_blank" rel="noopener noreferrer">
  Open Cursor Agent
</LinkButton>

1. Add a new MCP server named `Falconer`.
2. Use `https://falconer.com/api/mcp` as the MCP server URL.
3. Click **Login** to start the OAuth flow for Falconer.

## Codex CLI

Falconer supports Codex CLI through an OAuth-backed MCP connection configured from the terminal.

Run this command in a terminal:

```bash
codex mcp add falconer --url "https://falconer.com/api/mcp" --oauth-client-id falconer-codex-cli --oauth-resource "https://falconer.com/api/mcp"
```

Verify the server is listed:

```bash
codex mcp list
```

![Codex CLI terminal showing Falconer listed in MCP servers](/docs/images/falconer-mcp-codex-cli-listed.png)

## Disconnect MCP

Disconnect Falconer in two places if you want to fully remove access.

First, revoke Falconer-side authorization. Open [Personal settings > Connected accounts](https://falconer.com/settings/personal#connected-accounts), then disconnect the relevant MCP client. This revokes that client's Falconer OAuth tokens, so it can no longer access Falconer using your account.

Then remove Falconer from your MCP client.

For Claude Code:

```bash
claude mcp remove falconer
```

For Codex CLI:

```bash
codex mcp remove falconer
```

For Cursor app, remove the `Falconer` entry from your Cursor MCP config or remove Falconer from Cursor MCP settings.

For Cursor Agent, remove Falconer from Cursor Agent MCP settings.

For Claude.ai, remove or disconnect the Falconer custom connector from Claude.ai connector settings.

For other clients, remove Falconer using that client's MCP documentation.

## Troubleshooting

| Issue | What to do |
| --- | --- |
| The client says authentication is required | Reconnect Falconer and complete the browser OAuth flow. |
| The client cannot choose an organization | Ask it to call `list_organizations`, then use the returned `organizationId`. |
| The token expired or was revoked | Reconnect Falconer from your MCP client. |
| Your client does not support Falconer MCP | Use Claude.ai, Claude Code, Codex CLI, Cursor, or another client that supports HTTP MCP. You can also use the Falconer CLI for direct command-line access. |