# Conector de Claude (MCP con tu cuenta)

> Conecta tu cuenta de Ghosty a Claude, Claude Code o cualquier cliente MCP con OAuth; desde ahí hablas con tus agentes, revisas conversaciones y operas tu tablero de ventas.

URL: https://www.ghosty.studio/docs/protocolos/conector-claude

`https://www.ghosty.studio/mcp` es el servidor MCP **de tu cuenta**. A diferencia del [MCP de la documentación](/docs/protocolos/mcp-docs), éste entra con tu login (OAuth 2.0) y opera lo tuyo: tus agentes, tus conversaciones y el tablero de ventas de tus agentes.

## Conectar

:::tabs
```text tab=Claude
Configuración → Conectores → Agregar conector personalizado
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" }
  }
}
```
:::

El cliente te abre la pantalla de Ghosty: entras con Google, Apple o correo, revisas los permisos y tocas **Permitir**. No hay llaves que copiar.

## Herramientas

| Herramienta | Qué hace | Tipo |
|---|---|---|
| `whoami` | Tu cuenta, plan y permisos concedidos | lectura |
| `list_agents` | Tus agentes (id, motor, modelo, canales) | lectura |
| `list_conversations` | Tus conversaciones con un agente, o búsqueda con `query` | lectura |
| `read_conversation` | Los últimos mensajes de una conversación | lectura |
| `message_agent` | Le escribe a un agente y espera su respuesta (~3 min) | escritura |
| `get_agent_reply` | La respuesta de un agente que seguía trabajando | lectura |
| `crm_search_leads` | Leads del tablero de ventas del agente | lectura |
| `crm_read_lead` | La conversación de un lead | lectura |
| `crm_reply_lead` | Pide al agente contestar lo pendiente de un lead de WhatsApp Business | escritura |
| `crm_pause_lead` | Pausa o reanuda al agente en un lead | escritura |
| `list_files` | Tu biblioteca de archivos, con ligas temporales | lectura |
| `get_usage` | Uso de tu plan personal | lectura |

Cada herramienta llama a la misma [API v2](/docs/api/referencia) que usan la app y el CLI, con tu token: ve y hace exactamente lo que tú puedes en la web. Un agente compartido contigo aparece si tienes acceso; el tablero de un espacio de equipo, si eres miembro.

## Permisos

| Scope | Para qué |
|---|---|
| `profile` | Saber quién eres (tu correo) |
| `agents:read` | Ver tus agentes y conversar con ellos |
| `agents:write` | Mandarles trabajo y operar el tablero |
| `files` | Leer tu biblioteca de archivos |

## Revocar

Quita el conector en Claude, o cierra la sesión de esa aplicación desde tu cuenta de Ghosty: el token deja de servir en el servidor al instante.

## Para quien construye un cliente

- Descubrimiento: `/.well-known/oauth-protected-resource/mcp` (RFC 9728) y `/.well-known/oauth-authorization-server` (RFC 8414).
- Registro dinámico: `POST /oauth2/register` (RFC 7591). Cliente público con PKCE S256 obligatorio.
- Transporte Streamable HTTP por POST, sin SSE ni sesión; `GET /mcp` responde 405.
- Sin token, `/mcp` responde `401` con `WWW-Authenticate: Bearer resource_metadata="…"`.