Servidor MCP

El servidor MCP (Model Context Protocol) público de Nexor permite que un cliente de IA consulte y opere tu cuenta. Trabaja sobre los mismos recursos que la API REST, pero los dos catálogos no son idénticos. URL del servidor de producción: https://mcp.getnexor.ai/mcp

Explora todas las tools listadas

Revisa las 384 tools no administrativas que se muestran a sesiones de cliente, con scopes, argumentos obligatorios, tipo de operación, resguardos y la excepción de disponibilidad vigente.

Autenticación REST

Usa esta guía separada para las claves de la API REST. Las claves REST y MCP no son intercambiables.

Mira el recorrido de conexión

Las configuraciones siguientes son la referencia vigente para cada cliente compatible.

Crea una clave MCP

Haz clic en MCP en la barra lateral izquierda. La ventana crea una clave llamada Acceso MCP con acceso completo de configuración, para que tu asistente pueda terminar la puesta en marcha.
Copia el código para tu cliente. Incluye la clave; la clave completa no se vuelve a mostrar. Guárdala en un gestor de contraseñas o de secretos.
Para reducir el acceso de la clave, recorta sus scopes en la misma ventana o abre Gestionar claves. Revoca las claves que ya no uses: abrir la ventana de nuevo en otra sesión puede crear otra clave.

Las claves MCP comienzan con nxr_mcp_. Son distintas de las claves REST y tienen sus propios scopes. Aplica mínimo privilegio: si el cliente solo necesita consultar la cuenta, deja solo scopes de lectura.

Envía la clave solo mediante el header X-API-Key. El servidor MCP público no autentica Authorization: Bearer. Nunca pegues una clave real en el control de versiones, capturas o chats compartidos.

Conecta un cliente

Usa una de estas cuatro configuraciones específicas. Reemplaza nxr_mcp_YOUR_KEY en tu equipo.

Claude Code

Ejecuta en una terminal:

claude mcp add --transport http nexor https://mcp.getnexor.ai/mcp --header "X-API-Key: nxr_mcp_YOUR_KEY"

Codex

Agrega esto a ~/.codex/config.toml:

[mcp_servers.nexor]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.getnexor.ai/mcp", "--header", "X-API-Key: nxr_mcp_YOUR_KEY"]

Cursor

Agrega esto a ~/.cursor/mcp.json:

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

Claude Desktop

Claude Desktop usa un bridge stdio local para este servidor remoto con autenticación por header. Abre Developer → Edit Config y agrega esto a claude_desktop_config.json:

{
  "mcpServers": {
    "nexor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.getnexor.ai/mcp",
        "--header",
        "X-API-Key:${NEXOR_MCP_KEY}"
      ],
      "env": {
        "NEXOR_MCP_KEY": "nxr_mcp_YOUR_KEY"
      }
    }
  }
}

Mantén el argumento del header sin espacios en la configuración de Claude Desktop. mcp-remote reemplaza ${NEXOR_MCP_KEY} desde env al iniciarse.

Cómo funciona la conexión

Nexor implementa Streamable HTTP con sesión:

El cliente envía una solicitud MCP initialize mediante HTTP POST con X-API-Key.
Nexor autentica la clave, vincula la identidad del cliente y sus scopes a la sesión nueva, y devuelve un mcp-session-id.
Las solicitudes POST siguientes reutilizan esa sesión. GET abre el stream de eventos del servidor y DELETE cierra la sesión.

La mayoría de los clientes MCP administra el header de sesión y la reconexión de forma automática. Una tool disponible para clientes nunca acepta un ID de cliente como autorización; Nexor obtiene el tenant desde la sesión autenticada. Existen siete tools de administración interna fuera del catálogo generado para clientes, y solo las sesiones internas de administración pueden usar sus controles de contexto de tenant.

Scopes

Una clave MCP solo puede llamar una tool cuando tiene el scope requerido. Las tools sin un scope nominal también exigen una clave MCP válida.

Scope	Otorga
`workflows:read`	Consultar Agentes, configuración, tools, jobs, funciones y ajustes relacionados
`workflows:write`	Crear o cambiar Agentes, configuración, tools, jobs, funciones y ajustes relacionados
`rules:read`	Consultar reglas de recordatorio, recontacto y timeout de status
`rules:write`	Crear o cambiar esas reglas
`people:read`	Consultar miembros del equipo e invitaciones pendientes
`invites:write`	Invitar personas o revocar invitaciones
`leads:read`	Consultar leads, historial, conversaciones, reuniones, conversiones, campañas y templates
`leads:write`	Crear o cambiar leads, tags, status, asignación y estado de automatización
`leads:delete`	Borrar definitivamente leads y sus datos relacionados después de una confirmación explícita
`messages:send`	Enviar mensajes o iniciar llamadas
`meetings:write`	Crear, cambiar, cancelar o agregar notas a reuniones
`reports:read`	Consultar reportes de cuenta, funnel, llamadas, campos y leads
`numbers:read`	Consultar inventario y disponibilidad de números de teléfono
`numbers:write`	Provisionar, asignar, configurar o desactivar números de teléfono
`whatsapp:read`	Consultar números, templates y salud de WhatsApp
`whatsapp:write`	Conectar, asignar, configurar o desactivar recursos de WhatsApp
`imessage:read`	Consultar números, disponibilidad y estado de iMessage
`imessage:write`	Provisionar, asignar, configurar o desactivar números de iMessage
`senders:read`	Consultar remitentes de correo y su estado de verificación
`senders:write`	Registrar, verificar, definir por defecto o eliminar remitentes de correo
`sub-accounts:read`	Leer subcuentas y su estado de acceso
`sub-accounts:write`	Crear y gestionar subcuentas
`calendars:read`	Consultar calendarios conectados y su estado de conexión
`calendars:write`	Conectar, cambiar o desconectar calendarios

La respuesta tools/list del servidor contiene 391 tools en la revisión fijada por esta documentación. Siete están reservadas para administración interna y rechazan claves de cliente. El catálogo generado de tools no administrativas incluye las otras 384.

El catálogo fijado todavía incluye create_client_tool, update_client_tool, assign_tool_to_workflow, configure_customer_api_tool, create_workflow_tool y update_workflow_tool porque esas tools existen en tools/list. Por ahora, crear, editar o asignar un destino HTTP personalizado no es una operación pública soportada mientras Nexor refuerza la validación de destinos. No uses estas tools para configurar un destino hasta que se retire este aviso.

Confirmaciones y acciones sensibles

Inscribir leads en una tarea activa, por ejemplo con upsert_leads y workflow_id, o con las tools de asignación individual y masiva, inicia el contacto de inmediato según su cadencia; las llamadas esperan el horario de contacto de la tarea, y los mensajes salen de inmediato salvo que la tarea los restrinja a su horario. Se excluyen los leads marcados como no contactar y las tareas solo entrantes. Al activar una tarea en pausa se empieza a contactar a todos los leads que esperan en ella. Explica esto y obtén aprobación antes de inscribir leads o activar una tarea.

Un scope de escritura autoriza una clase de acciones. No reemplaza la aprobación del operador. Antes de una acción destructiva, con cobro, con salida hacia un lead u operacional, explica el efecto y solicita aprobación explícita. El catálogo generado muestra estos resguardos directamente desde el contrato de la tool:

Resguardo	Tools	Comportamiento requerido
`confirm: true`	`hard_delete_lead`, `bulk_hard_delete_leads`, `create_whatsapp_templates_batch`, `cancel_meeting`, `book_meeting`, `reschedule_meeting`, `change_meeting_host`, `delete_whatsapp_template`, `delete_workflow`, `connect_calendar`, `disconnect_calendar`, `disconnect_calendly`, `disconnect_crm`, `run_hubspot_import`, `run_scheduled_function`	Llama sin confirmación para obtener una vista previa cuando la tool la ofrezca. Usa `confirm: true` solo después de que el operador apruebe la acción exacta.
`accept_charge: true`	`provision_imessage_number`	Informa el cobro recurrente y obtén aprobación antes de aceptarlo.
`confirm_transfer_side_effects: true`	`bulk_set_lead_status`	Confirma que los cambios de status pueden activar efectos secundarios de transferencia configurados.
Vista previa con `dry_run`	`invite_user`	Valida e informa el resultado de la invitación sin escribir. La vista previa no aprueba una invitación posterior.
Modo de ejecución `dry_run`	`create_background_job`, `update_background_job`	Estas llamadas escriben de inmediato la configuración del job. Activar `dry_run` hace que las ejecuciones posteriores registren lo que harían sin actuar; no muestra una vista previa de la creación o actualización.

Algunas tools destructivas exigen aprobación en sus instrucciones, pero no tienen un campo común de confirmación: run_background_job, delete_agent_group, delete_cloud_function, clear_cloud_function_runs, delete_function_environment_variable, delete_scheduled_function y clear_scheduled_function_runs. Pregunta antes de usarlas y no infieras aprobación por la ausencia de un campo en el schema.

Borradores, pruebas y publicación de funciones

Los cambios de código de Cloud Functions y Funciones programadas pasan por un borrador, así producción sigue ejecutando el código publicado mientras un cliente trabaja:

update_cloud_function y update_scheduled_function guardan code como borrador y devuelven su draft_hash. Los demás campos se guardan de inmediato.
test_cloud_function y test_scheduled_function ejecutan el borrador sin efectos reales. Las lecturas se envían, los demás métodos HTTP reciben un 200 simulado y aparecen en outbound.would_send, y los cambios en leads solo se previsualizan. run_cloud_function se mantiene como alias de la prueba.
Muestra al operador lo que se enviaría y los efectos previsualizados. Después de su aprobación explícita, llama a publish_cloud_function o publish_scheduled_function con confirm: true y el draft_hash probado como expected_draft_hash. Un CONFLICT con draft_changed_since_preview significa que el borrador cambió: vuelve a leerlo, pruébalo y pregunta de nuevo.

list_cloud_function_versions, get_cloud_function_version, list_scheduled_function_versions y get_scheduled_function_version leen el historial de versiones. restore_cloud_function_version y restore_scheduled_function_version copian una versión en el borrador, nunca en producción. discard_cloud_function_draft, discard_scheduled_function_draft y una restauración con replace_draft: true pierden los cambios sin publicar, así que pregunta antes. run_scheduled_function ejecuta la versión publicada de verdad y sigue requiriendo confirm: true.

Errores de tools

Una falla de tool marca isError: true en MCP y devuelve texto JSON con la forma { "error": { "code": "...", "message": "..." } }.

Código	Significado
`UNAUTHORIZED`	Falta la clave MCP o no es válida
`FORBIDDEN`	La clave es válida, pero no tiene el scope requerido, o la tool es solo interna
`NOT_FOUND`	El recurso no existe o no pertenece al cliente autenticado
`INVALID_INPUT`	Faltan argumentos o tienen un formato incorrecto
`CONFLICT`	La solicitud entra en conflicto con el estado actual del recurso
`RATE_LIMITED`	Hay demasiadas solicitudes; reduce el ritmo y vuelve a intentar más tarde
`UPSTREAM_ERROR`	Nexor no pudo completar una llamada a una dependencia; reintenta solo si es seguro repetir la acción
`INTERNAL_ERROR`	El servidor encontró un error inesperado

Errores de transporte

Las fallas del handshake y de sesión son errores JSON-RPC, separados de los errores de tools.

Código JSON-RPC	Significado	Qué hacer
`-32001`	Falló el bootstrap de credenciales; el estado HTTP distingue una clave ausente o inválida (`401`), acceso insuficiente (`403`), límite de solicitudes (`429`) o autenticación temporalmente no disponible (`503`)	Para `401`, revisa `X-API-Key` y rota solo si la clave es inválida o está deshabilitada. Para `403`, corrige el acceso o el tipo de clave. Espera antes de reintentar ante `429`; vuelve a intentar una conexión segura más tarde ante `503`. No rotes una clave por una falla transitoria.
`-32000`	Falta el header de sesión o la sesión dejó de ser válida	Permite que el cliente se reconecte e inicie una sesión nueva
`-32603`	El transporte HTTP encontró un error de servidor no controlado	Reintenta después de reconectar; reporta la falla si persiste

Solución de problemas

El cliente conecta, pero una tool devuelve `FORBIDDEN`

Compara el scope de la tool en el catálogo con los scopes otorgados a la clave. Agrega solo el que falta. Una clave de cliente no puede llamar una tool reservada para administración interna.

Claude Desktop no inicia el servidor

Usa la configuración stdio con mcp-remote, no el formato remoto { "url", "headers" } de Cursor. Confirma que Node.js y npx estén disponibles, y mantén X-API-Key:${NEXOR_MCP_KEY} sin espacios.

El cliente informa una sesión inválida

Reinicia o reconecta el cliente MCP para que envíe una solicitud initialize nueva. No reutilices un mcp-session-id guardado entre procesos distintos del cliente. Las llamadas a tools y sus tasas de error de los últimos 30 días están disponibles por tool, para todas las claves MCP, en Gestionar claves.

Empieza aquí

Quickstart

Referencia API

Configura y lanza

WhatsApp

Canales

Agentes

Reuniones

Integraciones

Cuenta

Bandeja de entrada

Métricas

Herramientas para desarrolladores

Referencia de soporte

Servidor MCP

Explora todas las tools listadas

Autenticación REST

Mira el recorrido de conexión

Crea una clave MCP

Conecta un cliente

Claude Code

Codex

Cursor

Claude Desktop

Cómo funciona la conexión

Scopes

Confirmaciones y acciones sensibles

Borradores, pruebas y publicación de funciones

Errores de tools

Errores de transporte

Solución de problemas

El cliente conecta, pero una tool devuelve `FORBIDDEN`

Claude Desktop no inicia el servidor

El cliente informa una sesión inválida

Explora todas las tools listadas

Autenticación REST

​Mira el recorrido de conexión

​Crea una clave MCP

​Conecta un cliente

​Claude Code

​Codex

​Cursor

​Claude Desktop

​Cómo funciona la conexión

​Scopes

​Confirmaciones y acciones sensibles

​Borradores, pruebas y publicación de funciones

​Errores de tools

​Errores de transporte

​Solución de problemas

​El cliente conecta, pero una tool devuelve FORBIDDEN

​Claude Desktop no inicia el servidor

​El cliente informa una sesión inválida

Mira el recorrido de conexión

Crea una clave MCP

Conecta un cliente

Claude Code

Codex

Cursor

Claude Desktop

Cómo funciona la conexión

Scopes

Confirmaciones y acciones sensibles

Borradores, pruebas y publicación de funciones

Errores de tools

Errores de transporte

Solución de problemas

El cliente conecta, pero una tool devuelve `FORBIDDEN`

Claude Desktop no inicia el servidor

El cliente informa una sesión inválida