Sendveo para agentes de IA

Sendveo habla el Model Context Protocol (MCP). Añádelo a Claude, Cursor, ChatGPT o cualquier agente compatible con MCP y pídelo en lenguaje natural: lista mis números, conecta este, responde a ese chat. El agente llama a Sendveo por ti.

Qué es

El servidor MCP de Sendveo es un pequeño puente entre tu asistente de IA y tu cuenta de Sendveo. Expone las mismas acciones que la API y el panel, como herramientas que el asistente puede llamar. Todo se ejecuta bajo tu propia cuenta: inicias sesión con tu correo y tu contraseña de Sendveo o, para un script o una herramienta de línea de comandos, usas una clave de API de tu panel.

Hay dos formas de conectar, y ambas ofrecen las mismas herramientas. Alojada: pegas una URL en el asistente e inicias sesión, sin instalar nada ni copiar ninguna clave. Local: el asistente ejecuta un pequeño comando de Sendveo en tu equipo con una clave de API, que nunca sale de él.

Qué puedes hacer

Una herramienta por acción, agrupadas como las agrupa la guía: números, mensajes, conversaciones, contactos, grupos, salud y perfil, etiquetas, webhook, facturación. Las funciones de operador no se exponen: el servidor se limita a la cuenta a la que pertenece la conexión.

connect_number, refresh_qr y reconnect_number aceptan un parámetro opcional method. qr (por defecto) devuelve un QR para escanear desde WhatsApp en Dispositivos vinculados, Vincular un dispositivo. code devuelve un código de 8 caracteres para escribir en Vincular con número de teléfono: úsalo cuando estés en el mismo teléfono que tiene el número y no puedas escanear la pantalla. Ambos caducan y rotan, así que pide uno nuevo si deja de funcionar.

Opción A: pega la URL e inicia sesión (recomendado)

Añade Sendveo a tu asistente como servidor MCP remoto. Solo necesitas un valor, la URL MCP de Sendveo. No hay nada que instalar ni ninguna clave que pegar: tu asistente abre una página de Sendveo donde inicias sesión y apruebas la conexión.

https://mcp.sendveo.com/mcp

En Claude

1. Abre Ajustes, luego Conectores, y elige Añadir conector personalizado.
2. Pega la URL MCP de Sendveo de arriba y guarda. Tu asistente encuentra el resto por su cuenta.
3. Se abre una página de Sendveo en tu navegador. Inicia sesión con el correo y la contraseña que usas para el panel.
4. Lee lo que pide el asistente y la dirección a la que te devolverá, y pulsa Permitir. Si pulsas Rechazar, no se concede nada.

El asistente recibe una conexión ligada a tu cuenta, con los permisos que muestra esa pantalla de aprobación. Caduca al cabo de una hora y se renueva sola mientras la conexión está en uso. Nunca pegas una clave en el asistente, y nada de lo que apruebas alcanza otra cuenta, la consola de operador ni tu contraseña.

Para desconectar, elimina el conector en tu asistente. Una conexión que elimines desde Sendveo deja de funcionar de inmediato y para siempre.

Si no se abre ninguna página de inicio de sesión, comprueba que la URL termina en /mcp. Si tu asistente informa de que no pudo alcanzar el servicio de inicio de sesión, Sendveo no es accesible desde tu red: la misma comprobación que cargar el panel.

ChatGPT, Cursor y otros asistentes compatibles con MCP usan la misma URL en sus propios ajustes de servidor MCP remoto, y te hacen iniciar sesión igual.

Opción B: local (en tu equipo)

Si prefieres mantener la clave en tu propio equipo, ejecuta el servidor MCP de Sendveo en local. Requiere Node.js 22 o superior. El asistente lo inicia con npx @sendveo/mcp y le pasa tu clave mediante la variable de entorno SENDVEO_API_KEY.

Añade el bloque de abajo a la configuración MCP de tu asistente. En Claude Desktop es claude_desktop_config.json; en Claude Code ejecuta claude mcp add o edita .mcp.json; Cursor usa .cursor/mcp.json. El bloque es el mismo en todos.

{
  "mcpServers": {
    "sendveo": {
      "command": "npx",
      "args": ["-y", "@sendveo/mcp"],
      "env": {
        "SENDVEO_API_KEY": "YOUR_SENDVEO_API_KEY"
      }
    }
  }
}

Sustituye el texto de ejemplo por tu clave, reinicia el asistente y pídele que liste tus números de Sendveo. Si el servidor se cierra de inmediato, comprueba que SENDVEO_API_KEY está definida.

Con una clave de API en lugar de iniciar sesión

Iniciar sesión es la forma normal de usar la URL alojada. Si tu herramienta no puede hacerlo, un script, una llamada curl o un cliente que solo te deja definir cabeceras, la misma URL también acepta una clave de API de Sendveo enviada como token bearer. Cada solicitud se autentica solo con esa clave y se limita a la cuenta de esa clave.

https://mcp.sendveo.com/mcp

Authorization: Bearer YOUR_SENDVEO_API_KEY

Ámbitos

Cada conexión lleva ámbitos, y cada herramienta necesita uno. Al iniciar sesión, la pantalla de aprobación los enumera en lenguaje claro antes de que pulses Permitir. Una clave de API nueva recibe todos los ámbitos por defecto, salvo el atajo de solo lectura, así que funciona con todas las herramientas desde el principio. Si una herramienta informa de que falta un ámbito, ajusta la clave en Claves de API en tu panel, o vuelve a conectar y aprueba el permiso que falta.

messages:manage, chats:read, chats:manage, contacts:read, groups:read y groups:manage se añadieron el 16 de septiembre de 2026. Una clave de API creada antes de esa fecha no tiene ninguno de ellos y no puede recibirlos: crea una clave nueva en tu panel, o vuelve a conectar el asistente y aprueba los permisos. Todo lo demás sigue funcionando con la clave antigua.

Leer tu facturación lo cubre numbers:read. Comprar plazas de números con tu saldo (activate_slots) requiere numbers:write en una clave de API, y billing:spend en un asistente conectado iniciando sesión. El ámbito billing:spend está desactivado salvo que lo marques en la pantalla de aprobación, y las conexiones creadas antes de que existiera no lo tienen, así que un asistente que conectes sin marcarlo nunca podrá comprar plazas. Conectar no es comprar, pero puede costar: cuando connect_number o reconnect_number coloca un número en una plaza con saldo aún no pagada este mes, ese número se renueva desde tu saldo a su precio mensual en la revisión horaria que sigue al emparejamiento del teléfono, o queda como renovación impagada si tu saldo no es suficiente. Ocurre con o sin billing:spend, igual que cuando conectas un número desde tu panel.

Seguridad

• Iniciar sesión nunca da tu contraseña al asistente, y el servidor alojado no guarda ninguna clave de API. Cada solicitud se autentica con la credencial que lleva, y el servidor no conserva ninguna.
• Cada solicitud queda aislada en la cuenta que hay detrás de la conexión. Las funciones de operador no son accesibles por MCP.
• Hay límites de frecuencia, por clave y por origen. Una respuesta 429 significa: baja el ritmo y reintenta en un momento.
• Trata la clave como una contraseña. Prefiere una clave limitada a lo que el asistente necesita, y revócala desde el panel si se filtra.

Solución de problemas