> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

Todas las acciones disponibles en la REST API también están disponibles como tools MCP ([Model Context Protocol](https://modelcontextprotocol.io)), para que un cliente de IA — Claude, Cursor, Codex — pueda gestionar tu cuenta directamente. Pídele "crea un agente que califique leads, agende una demo, y derive a ventas" y va a llamar las mismas tools descritas abajo.

## Obtener una key

Las keys MCP son distintas de tu `X-API-Key` REST (ver [Autenticación](/docs/es/api/authentication)) y tienen sus propios scopes.

1. Abre **Integraciones** desde tu menú de perfil.
2. Ve a **Servidor MCP**.
3. Crea una key y elige los scopes que necesita — mínimo privilegio por defecto. Una key de solo lectura se le puede dar a un agente en el que todavía no confías del todo.

## Conectar un cliente

URL del servidor: `https://mcp.getnexor.ai/mcp`

**Claude Code**

```bash theme={null}
claude mcp add --transport http nexor https://mcp.getnexor.ai/mcp --header "X-API-Key: YOUR_MCP_KEY"
```

**Cursor / Claude Desktop** (`~/.cursor/mcp.json` o la configuración de conectores de Claude)

```json theme={null}
{
  "mcpServers": {
    "nexor": {
      "url": "https://mcp.getnexor.ai/mcp",
      "headers": { "X-API-Key": "YOUR_MCP_KEY" }
    }
  }
}
```

**Codex** (`~/.codex/config.toml`)

```toml theme={null}
[mcp_servers.nexor]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.getnexor.ai/mcp", "--header", "X-API-Key: YOUR_MCP_KEY"]
```

## Scopes

Una key solo puede llamar tools dentro de los scopes que tiene otorgados.

| Scope             | Otorga                                                                              |
| ----------------- | ----------------------------------------------------------------------------------- |
| `workflows:read`  | Ver agentes, su estructura, tools personalizadas y background jobs                  |
| `workflows:write` | Crear y editar agentes, prompts, estructura, tools personalizadas y background jobs |
| `leads:read`      | Ver leads, historial y templates de WhatsApp                                        |
| `leads:write`     | Crear/actualizar leads, tags, status y estado de automatización                     |
| `rules:read`      | Ver reglas de recordatorio, re-contacto y timeout de status                         |
| `rules:write`     | Crear/actualizar esas reglas                                                        |
| `people:read`     | Ver miembros del equipo e invitaciones pendientes                                   |
| `invites:write`   | Invitar o revocar personas                                                          |
| `messages:send`   | Enviar un mensaje de WhatsApp/email o disparar una llamada                          |
| `meetings:write`  | Registrar reuniones, notas y conversiones                                           |

## Catálogo de tools

### Workflows (agentes)

Este es el conjunto completo de tools para "crea un agente que hace A, luego B, luego C" — mapea directamente a los endpoints REST de [Workflows](/docs/es/api/workflows/create-workflow) y [Workflow Tools](/docs/es/api/workflow-tools/create-workflow-tool).

| Tool                          | Scope             | Descripción                                                      |
| ----------------------------- | ----------------- | ---------------------------------------------------------------- |
| `list_workflows`              | `workflows:read`  | Lista los agentes del cliente                                    |
| `get_workflow`                | `workflows:read`  | Obtiene un agente con statuses/campos/tools                      |
| `create_workflow`             | `workflows:write` | Crea un agente (funnel) con statuses                             |
| `set_workflow_prompt`         | `workflows:write` | Reemplaza el prompt base (global) de un agente                   |
| `set_workflow_active`         | `workflows:write` | Activa (despausa) o pausa un agente                              |
| `update_workflow`             | `workflows:write` | Renombra un agente o cambia su descripción                       |
| `set_channel_prompt`          | `workflows:write` | Configura un override de prompt por canal (mezclado)             |
| `get_workflow_prompt_history` | `workflows:read`  | Lee el historial de versiones del prompt de un agente            |
| `update_workflow_structure`   | `workflows:write` | Agrega/edita statuses + campos del funnel (upsert, sin eliminar) |

### Tools personalizadas

| Tool                   | Scope             | Descripción                                                   |
| ---------------------- | ----------------- | ------------------------------------------------------------- |
| `list_workflow_tools`  | `workflows:read`  | Lista las tools HTTP personalizadas de un agente              |
| `create_workflow_tool` | `workflows:write` | Agrega una tool HTTP personalizada que el agente puede llamar |
| `update_workflow_tool` | `workflows:write` | Edita la configuración de una tool personalizada              |
| `delete_workflow_tool` | `workflows:write` | Elimina una tool personalizada (soft/hard)                    |
| `set_tool_stage_gate`  | `workflows:write` | Gatea una tool personalizada a stages del funnel              |

### Background jobs

| Tool                             | Scope             | Descripción                                         |
| -------------------------------- | ----------------- | --------------------------------------------------- |
| `list_background_jobs`           | `workflows:read`  | Lista background jobs                               |
| `get_background_job`             | `workflows:read`  | Obtiene un background job + ejecuciones recientes   |
| `create_background_job`          | `workflows:write` | Crea una automatización programada/forzada de leads |
| `update_background_job`          | `workflows:write` | Actualiza la configuración de un background job     |
| `delete_background_job`          | `workflows:write` | Elimina un background job                           |
| `run_background_job`             | `workflows:write` | Fuerza la ejecución de un background job ahora      |
| `list_background_job_executions` | `workflows:read`  | Historial de ejecuciones de un job                  |

### Leads

| Tool                      | Scope         | Descripción                                                   |
| ------------------------- | ------------- | ------------------------------------------------------------- |
| `list_leads`              | `leads:read`  | Recorre leads con búsqueda/filtro                             |
| `get_lead`                | `leads:read`  | Un lead con sus campos + engagement                           |
| `get_lead_history`        | `leads:read`  | Timeline unificado del lead                                   |
| `upsert_leads`            | `leads:write` | Crea/actualiza leads (idempotente), con enroll opcional       |
| `update_lead`             | `leads:write` | Actualiza campos/metadata del lead                            |
| `sync_lead_tags`          | `leads:write` | Configura el set exacto de tags de un lead                    |
| `assign_lead_to_workflow` | `leads:write` | Mueve un lead a un agente, inicia la cadencia                 |
| `set_lead_status`         | `leads:write` | Fuerza el status del funnel de un lead (adelante/atrás)       |
| `stop_automation`         | `leads:write` | Toma de control humano ON: pausa la cadencia                  |
| `resume_automation`       | `leads:write` | Toma de control humano OFF; opcionalmente reanuda la cadencia |
| `delete_lead`             | `leads:write` | Elimina (archiva) un lead de forma suave                      |

### Reglas

| Tool                        | Scope         | Descripción                                            |
| --------------------------- | ------------- | ------------------------------------------------------ |
| `list_reminder_rules`       | `rules:read`  | Lista reglas de recordatorio de leads                  |
| `set_reminder_rule`         | `rules:write` | Crea/actualiza una regla de recordatorio de leads      |
| `list_host_reminder_rules`  | `rules:read`  | Lista reglas de notificación de hosts                  |
| `set_host_reminder_rule`    | `rules:write` | Crea/actualiza una regla de host (solo email)          |
| `list_recontact_rules`      | `rules:read`  | Lista reglas de re-contacto                            |
| `set_recontact_rule`        | `rules:write` | Crea/actualiza una regla de re-contacto                |
| `list_status_timeout_rules` | `rules:read`  | Lista configuraciones de timeout automático por status |
| `set_status_timeout_rule`   | `rules:write` | Configura/limpia un timeout automático de status       |

### Personas

| Tool                       | Scope           | Descripción                                             |
| -------------------------- | --------------- | ------------------------------------------------------- |
| `list_team`                | `people:read`   | Lista miembros activos del equipo                       |
| `list_pending_invitations` | `people:read`   | Lista invitaciones pendientes                           |
| `invite_user`              | `invites:write` | Invita a una persona (admin o human agent), idempotente |
| `revoke_invitation`        | `invites:write` | Cancela una invitación pendiente                        |

### Mensajería

| Tool                      | Scope           | Descripción                                |
| ------------------------- | --------------- | ------------------------------------------ |
| `list_whatsapp_templates` | `leads:read`    | Lista templates de WhatsApp aprobados      |
| `send_message`            | `messages:send` | Envía WhatsApp/email o dispara una llamada |

### Cuenta

| Tool                    | Scope            | Descripción                                       |
| ----------------------- | ---------------- | ------------------------------------------------- |
| `list_lead_meetings`    | `leads:read`     | Lista los eventos de calendario de un lead        |
| `create_meeting`        | `meetings:write` | Registra una reunión agendada (idempotente)       |
| `ingest_meeting_notes`  | `meetings:write` | Adjunta transcript/resumen a una reunión          |
| `list_conversion_types` | `leads:read`     | Lista tipos de conversión activos                 |
| `set_conversion_type`   | `leads:write`    | Crea o actualiza un tipo de conversión por nombre |
| `create_conversion`     | `leads:write`    | Registra un evento de conversión                  |
| `list_conversions`      | `leads:read`     | Lista eventos de conversión                       |
| `list_campaigns`        | `leads:read`     | Lista campañas                                    |

### Meta

| Tool     | Scope | Descripción                                          |
| -------- | ----- | ---------------------------------------------------- |
| `whoami` | —     | Identidad del cliente autenticado + scopes otorgados |

## Uso

Las llamadas a tools y tasas de error de los últimos 30 días son visibles en la misma página **Integraciones → Servidor MCP**, por key.