Servidor MCP

Nexor expone las capacidades de administración del catálogo de abajo como tools MCP (Model Context Protocol), para que un cliente de IA — Claude, Cursor o Codex — pueda operarlas directamente. MCP y REST trabajan sobre los mismos recursos, pero sus catálogos no son idénticos; usa esta página como fuente de verdad para las tools MCP disponibles.

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/SMS o disparar una llamada
`meetings:write`	Registrar reuniones y notas de reunión
`reports:read`	Ver reportes de funnel, distribución de campo, estadísticas de llamadas y por lead
`numbers:read`	Ver los números de teléfono del cliente
`numbers:write`	Provisionar, asignar y gestionar números de teléfono
`whatsapp:read`	Ver los números de WhatsApp del cliente
`whatsapp:write`	Conectar, asignar y gestionar números de WhatsApp

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

Tools con alcance a un solo agente, sin herencia de catálogo. Prefiere el catálogo de client tools de abajo cuando una tool deba ser reutilizable entre agentes.

Tool	Scope	Descripción
`list_workflow_tools`	`workflows:read`	Lista las tools HTTP personalizadas de un agente
`create_workflow_tool`	`workflows:write`	Crea una tool personalizada que vive solo en este agente (sin herencia de catálogo); prefiere `create_client_tool` + `assign_tool_to_workflow` para una tool reutilizable
`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

Catálogo de client tools

Un modelo de dos niveles: una client tool es una definición reutilizable en el catálogo del cliente; asignarla a un agente crea una copia heredada que se mantiene sincronizada con la tool del catálogo en futuras ediciones. Mapea a los endpoints REST de Client Tools.

Tool	Scope	Descripción
`list_client_tools`	`workflows:read`	Lista el catálogo reutilizable de tools del cliente
`create_client_tool`	`workflows:write`	Crea una tool reutilizable en el catálogo — la forma recomendada de agregar una tool usable entre agentes
`update_client_tool`	`workflows:write`	Edita una tool del catálogo; se propaga a todos los agentes que la hayan asignado (heredado)
`delete_client_tool`	`workflows:write`	Elimina una tool del catálogo (se propaga en cascada a las asignaciones heredadas)
`assign_tool_to_workflow`	`workflows:write`	Asigna una tool del catálogo a un agente; hereda y se mantiene sincronizada con la tool del catálogo

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/SMS o dispara una llamada (SMS usa el número SMS-enabled del workflow; `workflow_id` es opcional — se resuelve del run activo del lead)

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

Reportes

Tool	Scope	Descripción
`get_funnel_report`	`reports:read`	Reporte agregado de funnel: leads por status, totales de contactados/conectados/discovery, por agente
`get_field_distribution`	`reports:read`	Distribución de los valores de un campo capturado, con conteos y una cita de evidencia de ejemplo
`get_call_stats`	`reports:read`	Estadísticas de volumen/resultado de llamadas para un rango de fechas, totalizado o por día
`get_lead_report`	`reports:read`	Bundle completo de reporte para un lead: perfil, status, campos, insights, llamadas, tareas programadas

Números de teléfono

Tool	Scope	Descripción
`search_available_numbers`	`numbers:read`	Lista números disponibles para comprar en un país
`list_phone_numbers`	`numbers:read`	Lista los números del cliente y su asignación a workflows
`provision_phone_number`	`numbers:write`	Compra + provisiona un número (con tope por cliente, default 3)
`assign_number_to_workflow`	`numbers:write`	(Re)asigna un número a uno de los workflows del cliente
`set_number_sms`	`numbers:write`	Activa/desactiva SMS entrante en un número
`deactivate_number`	`numbers:write`	Desactiva un número (soft)

Las keys internal-admin tienen además release_phone_number, transfer_number y las tools de permisos de discado.

Números de WhatsApp

Conectar devuelve un link de setup alojado por Kapso que el cliente abre para completar el onboarding; el número se registra automáticamente y su webhook + eventos entrantes quedan registrados — igual que cualquier número onboardeado. Asignar el número a un workflow es lo que hace que los mensajes entrantes lleguen a ese agente.

Tool	Scope	Descripción
`list_whatsapp_numbers`	`whatsapp:read`	Lista los números de WhatsApp del cliente y su asignación a workflows
`connect_whatsapp_number`	`whatsapp:write`	Inicia el onboarding; devuelve un link de setup de Kapso (con tope por cliente, default 10)
`assign_whatsapp_to_workflow`	`whatsapp:write`	Asigna un número de WhatsApp a un workflow para que el inbound llegue al agente
`deactivate_whatsapp_number`	`whatsapp:write`	Desactiva un número de WhatsApp (soft)

Las keys internal-admin tienen además disconnect_whatsapp_number.

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

Errores

Todo error de una tool sigue la misma forma: { "error": { "code": "...", "message": "..." } }.

Código	Significado
`UNAUTHORIZED`	Key MCP faltante o inválida
`FORBIDDEN`	La key está autenticada pero le falta el scope que esta tool requiere
`NOT_FOUND`	El recurso solicitado no existe o no te pertenece
`INVALID_INPUT`	Argumentos faltantes o mal formados
`CONFLICT`	La solicitud entra en conflicto con el estado actual del recurso
`RATE_LIMITED`	Demasiadas solicitudes — reduce el ritmo y reintenta
`UPSTREAM_ERROR`	Un problema transitorio del lado de Nexor o un fallo de red; siempre el mismo mensaje genérico fijo, nunca el body crudo del backend
`INTERNAL_ERROR`	Error inesperado del servidor

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

​Catálogo de client tools

​Background jobs

​Leads

​Reglas

​Personas

​Mensajería

​Cuenta

​Reportes

​Números de teléfono

​Números de WhatsApp

​Meta

​Errores

​Uso