Servidor MCP

Todas las acciones disponibles en la REST API también están disponibles como tools MCP (Model Context Protocol), 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) y tienen sus propios scopes.

Abre Integraciones desde tu menú de perfil.
Ve a Servidor MCP.
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

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)

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

Codex (~/.codex/config.toml)

[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 y Workflow Tools.

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

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.

​Obtener una key

​Conectar un cliente

​Scopes

​Catálogo de tools

​Workflows (agentes)

​Tools personalizadas

​Background jobs

​Leads

​Reglas

​Personas

​Mensajería

​Cuenta

​Meta

​Uso