# Install Patricia with MCP

Machine-readable version of https://www.patricia.app/mcp.

Connect Claude Code, Claude, Cursor, ChatGPT, Codex, or any MCP client to the
same Patricia your team knows. She brings your workspace context and can take
a job from start to finish.

## What your client can do

Patricia gives your client the context of a real teammate. You can read what
she knows or add useful context. Hand her a job with `ask_patricia` and poll
the run for the result.

### Know the workspace

Confirm which workspace and which person the credential names, read the company profile, and list the team.

### Read and write the workspace memory

Search what Patricia already knows about the company, store a new fact, or forget one.

### Work with files

List, search, read, and create files in the workspace, and open or close a dated public link for one.

### See what Patricia can already do

List the skills and the connected tools this workspace holds, then search or inspect a capability before calling it.

### Hand Patricia a job

Ask Patricia to do the work as the person the token names. The run is asynchronous, so poll it for status. Patricia's ordinary approval rules still apply, so anything that publishes, sends, or spends waits for a human yes.

## Install

Choose your client. Each option connects to the same secure Patricia MCP
server. You need a Patricia account first. There is no self-serve signup.
[Book a demo](https://www.patricia.app/demo) and we set you up together.

### Install in Claude Code

Add Patricia from your terminal. Then sign in from Claude Code.

1. Run this command in your terminal.

**Terminal command**

```
claude mcp add --transport http patricia https://api.patricia.app/v1/mcp
```

1. Open Claude Code and enter the command below.
2. Select Patricia and sign in with your Patricia account.

**Claude Code command**

```
/mcp
```

### Install in Claude.ai or Claude Desktop

Add Patricia as a custom connector from the Claude settings.

1. Open Customize > Connectors.
2. Select the + button.
3. Select Add custom connector.
4. Enter the Patricia MCP server address.
5. Select Add.
6. Sign in with your Patricia account.

**MCP server address**

```
https://api.patricia.app/v1/mcp
```

On a Team or Enterprise plan, an Owner adds Patricia under Organization settings > Connectors. Members then open Customize > Connectors and select Connect. A connector added to your Claude account also works in Claude Desktop.

### Install in Cursor

Use the install button, or add Patricia to your Cursor configuration.

Opens Cursor on this computer and asks you to confirm the server. Then sign in when Cursor asks.

Add to Cursor:

cursor://anysphere.cursor-deeplink/mcp/install?name=patricia&config=eyJ1cmwiOiJodHRwczovL2FwaS5wYXRyaWNpYS5hcHAvdjEvbWNwIn0%3D

#### Manual setup on another device or without the button

Save this block in ~/.cursor/mcp.json, then sign in when Cursor asks.

**~/.cursor/mcp.json**

```
{
  "mcpServers": {
    "patricia": {
      "url": "https://api.patricia.app/v1/mcp"
    }
  }
}
```

### Install in ChatGPT or Codex

Connect from ChatGPT settings, or add Patricia with the Codex CLI.

#### ChatGPT desktop app

1. Open Settings.
2. Select MCP servers.
3. Select Add server.
4. Choose Streamable HTTP.
5. Enter the Patricia MCP server address.
6. Save the server.
7. Restart the ChatGPT desktop app.
8. Sign in with your Patricia account when ChatGPT asks.

**MCP server address**

```
https://api.patricia.app/v1/mcp
```

#### ChatGPT on the web

1. Open Settings > Security and login.
2. Turn on Developer mode.
3. In Plugins, select the plus button.
4. Create a developer-mode app for your remote MCP server.
5. Name the app Patricia.
6. Enter the Patricia MCP server address.
7. Choose OAuth.
8. Sign in with your Patricia account when ChatGPT asks.

**MCP server address**

```
https://api.patricia.app/v1/mcp
```

Available to Pro, Plus, Business, Enterprise, and Education accounts on the web.

#### Codex CLI

1. Run both commands in your terminal.
2. Sign in with your Patricia account in the browser window that opens.

**Add Patricia**

```
codex mcp add patricia --url https://api.patricia.app/v1/mcp
```

**Sign in**

```
codex mcp login patricia
```

### Install in any MCP client

Use Patricia with any client that supports Streamable HTTP.

Choose the block that matches your client.

**With OAuth**

```
{
  "mcpServers": {
    "patricia": {
      "type": "http",
      "url": "https://api.patricia.app/v1/mcp"
    }
  }
}
```

**Without OAuth**

```
{
  "mcpServers": {
    "patricia": {
      "type": "http",
      "url": "https://api.patricia.app/v1/mcp",
      "headers": {
        "Authorization": "Bearer pat_mcp_..."
      }
    }
  }
}
```

A client that supports OAuth opens your browser for sign-in. For a client without OAuth, mint a personal token in [Developer settings](https://console.patricia.app/settings/developer).

## Credentials

Authentication uses a bearer token on the `Authorization` header. The two
credentials have different access:

- `pat_mcp_` **Personal token.** Names the person who minted it. Required for anything that reads or writes that person's own work: files, memory, skills, connected tools, and asking Patricia to do a job.
- `pat_live_` **Workspace API key.** Names the workspace and no person. It can read workspace-level context such as the company profile and the team roster. Anything that depends on who is asking is refused.

Mint or revoke a credential in [Developer settings](https://console.patricia.app/settings/developer).
Every answer stays scoped to the workspace behind that credential. Patricia
keeps her normal approval rules for every job.

## OAuth discovery

- Authorization server metadata: https://api.patricia.app/.well-known/oauth-authorization-server
- Protected resource metadata: https://api.patricia.app/.well-known/oauth-protected-resource/v1/mcp

## Bring your own MCP servers

MCP runs both ways here. Connect any tool's MCP server from the console and
Patricia treats it like any other tool: same permissions, same approvals, same
audit trail.

- **Connect it your way.** Sign in at the tool server's own page and approve Patricia. If a server will not register her automatically, an admin pastes a client ID and secret instead.
- **Team-wide or personal.** An admin connects a server for the whole workspace. Any member can also connect one just for themselves: only they can use it, and it goes away if they leave.
- **Approvals that make sense.** Plain lookups run without nagging you. Anything that changes data asks first, no matter what the server claims about itself. You can allow one specific action to run automatically, and nothing more.

## Security and reference

- [Privacy policy](https://www.patricia.app/legal/privacy)
- [Security overview](https://www.patricia.app/security)
- [MCP registry descriptor](https://www.patricia.app/mcp/server.json)
- [Developer reference](https://www.patricia.app/developers)

## Other machine-readable pages

Every page below also answers in markdown at its normal URL when you send
`Accept: text/markdown`.

- What Patricia is, and when to use her: https://www.patricia.app/index.md
- Pricing, plans, and worked examples: https://www.patricia.app/pricing.md
- Security, compliance, and data handling: https://www.patricia.app/security.md
- Patricia for marketing agencies: https://www.patricia.app/for-agencies.md
- Connected tools and integrations: https://www.patricia.app/integrations.md
- What teams ask her to do: https://www.patricia.app/use-cases.md
- Who is behind Patricia: https://www.patricia.app/about.md
- MCP server, REST API, and the OpenAPI document: https://www.patricia.app/developers.md
- Agent front door: https://www.patricia.app/llms.txt
- Full product context: https://www.patricia.app/llms-full.txt
- Agent skill: https://www.patricia.app/.well-known/agent-skills/patricia/SKILL.md
- Recovery document for a missing page: https://www.patricia.app/404.md