# Claude connector (MCP with your account)

> Connect your Ghosty account to Claude, Claude Code or any MCP client with OAuth; from there you talk to your agents, review conversations and work your sales board.

URL: https://www.ghosty.studio/en/docs/protocols/claude-connector

`https://www.ghosty.studio/mcp` is the MCP server **for your account**. Unlike the [documentation MCP](/en/docs/protocols/docs-mcp), it signs in with your login (OAuth 2.0) and works on what is yours: your agents, your conversations and your agents' sales board.

## Connect

:::tabs
```text tab=Claude
Settings → Connectors → Add custom connector
URL: https://www.ghosty.studio/mcp
```
```bash tab=Claude Code
claude mcp add --transport http ghosty https://www.ghosty.studio/mcp
```
```json tab=Cursor
{
  "mcpServers": {
    "ghosty": { "type": "http", "url": "https://www.ghosty.studio/mcp" }
  }
}
```
:::

The client opens the Ghosty screen: sign in with Google, Apple or email, review the permissions and tap **Allow**. No keys to copy.

## Tools

| Tool | What it does | Kind |
|---|---|---|
| `whoami` | Your account, plan and granted permissions | read |
| `list_agents` | Your agents (id, engine, model, channels) | read |
| `list_conversations` | Your conversations with an agent, or search with `query` | read |
| `read_conversation` | The latest messages of a conversation | read |
| `message_agent` | Messages an agent and waits for its reply (~3 min) | write |
| `get_agent_reply` | The reply of an agent that was still working | read |
| `crm_search_leads` | Leads on the agent's sales board | read |
| `crm_read_lead` | A lead's conversation | read |
| `crm_reply_lead` | Asks the agent to answer what a WhatsApp Business lead left pending | write |
| `crm_pause_lead` | Pauses or resumes the agent on a lead | write |
| `list_files` | Your file library, with temporary links | read |
| `get_usage` | Your personal plan usage | read |

Every tool calls the same [v2 API](/en/docs/api/reference) the app and the CLI use, with your token: it sees and does exactly what you can on the web. An agent shared with you shows up if you have access; a team space's board, if you are a member.

## Permissions

| Scope | What for |
|---|---|
| `profile` | Know who you are (your email) |
| `agents:read` | See your agents and talk to them |
| `agents:write` | Send them work and operate the board |
| `files` | Read your file library |

## Revoke

Remove the connector in Claude, or sign that app out from your Ghosty account: the token stops working on the server right away.

## For client builders

- Discovery: `/.well-known/oauth-protected-resource/mcp` (RFC 9728) and `/.well-known/oauth-authorization-server` (RFC 8414).
- Dynamic registration: `POST /oauth2/register` (RFC 7591). Public client with mandatory PKCE S256.
- Streamable HTTP over POST, no SSE or session; `GET /mcp` returns 405.
- Without a token, `/mcp` returns `401` with `WWW-Authenticate: Bearer resource_metadata="…"`.