Dale a Claude una línea telefónica con el MCP de Wixzel Voice

¿Qué necesitas antes de empezar?

• Una cuenta de Wixzel Voice con crédito. La recarga mínima es de $5 y no hay crédito de prueba gratuito para llamadas.
• Una troncal SIP en un operador que ya uses (Twilio, Telnyx, Plivo, Vonage, Bandwidth, Exotel, Vobiz o cualquier proveedor SIP) con un número de teléfono. Wixzel Voice no vende ni porta números. Si tu cuenta de operador es de Twilio, Telnyx, Plivo, Vobiz o Vonage y la conectas desde la consola, puedes comprar un número en esa cuenta desde Wixzel Voice, facturado por tu operador.
• Claude Code, o claude.ai o Claude Desktop con conectores personalizados disponibles en tu plan.

¿Cómo construyes esto en Wixzel Voice, paso a paso?

1. 01Añade el servidor a Claude Code

   El servidor alojado está en https://mcp.voice.wixzel.com/mcp y te hace iniciar sesión con OAuth, así que no pegas ninguna clave de API en ningún sitio. Añádelo desde una terminal:

   shellCopiar

   claude mcp add --transport http wixzel-voice https://mcp.voice.wixzel.com/mcp

   Después escribe /mcp dentro de Claude Code, elige el servidor wixzel-voice y selecciona Authenticate. El navegador abre la consola: inicias sesión, desmarcas los permisos (scopes) que no quieras dar al cliente y apruebas. Claude Code recibe su propia clave de API, limitada a los permisos que aprobaste.

2. 02O añádelo a claude.ai o Claude Desktop

   En Settings, abre Connectors y añade un conector personalizado con la misma URL, https://mcp.voice.wixzel.com/mcp. Pulsa Connect, inicia sesión en la consola y aprueba los permisos. El conector recibe su propia clave, y puedes desconectarlo en cualquier momento desde la página Clientes de IA de la consola; la clave deja de funcionar al instante.

   Los clientes que inician servidores localmente desde una configuración JSON mcpServers, como Cursor, ejecutan el mismo servidor desde npm con una clave de API en el entorno:

   shellCopiar

   claude mcp add wixzel-voice -e WIXZEL_API_KEY=wv_live_... -- npx -y wixzel-voice-mcp

   jsonCopiar

   {
     "mcpServers": {
       "wixzel-voice": {
         "command": "npx",
         "args": ["-y", "wixzel-voice-mcp"],
         "env": { "WIXZEL_API_KEY": "wv_live_..." }
       }
     }
   }

3. 03Deja que el prompt quickstart configure tu cuenta

   El servidor incluye un prompt quickstart, que Claude Code muestra como comando de barra. Acepta un objetivo opcional, como "confirmar citas dentales":

   Claude CodeCopiar

   /mcp__wixzel-voice__quickstart

   Claude primero lista lo que ya existe (list_sip_trunks, list_phone_numbers, list_agents, get_balance) para no duplicar nada. Después trabaja en el orden que marca la guía de operación del servidor: list_engines para ver qué hay disponible y cuánto cuesta, create_sip_trunk con las credenciales del operador que le des, create_phone_number en esa troncal y create_agent con unas instrucciones breves en estilo hablado, una frase de apertura y un identificador de llamada. Te pide las credenciales en lugar de inventarlas y se detiene antes de cualquier cosa que marque un número.

   Hay dos ajustes que solo tú puedes cambiar, y están en tu operador. Añade a la lista de IP permitidas la platform_ip que devuelve la nueva troncal, para que tu operador acepte llamadas salientes desde ella, y apunta la ruta entrante del operador al origination_uri de la troncal. Claude te lee ambos valores, y check_sip_trunk_status muestra si la troncal es accesible.

4. 04Pide una llamada y apruébala

   Con un agente y un número listos, pídelo con palabras normales:

   promptCopiar

   Call +14155551234 with the Support agent. Ask whether tomorrow's 10:00
   delivery slot still works, and tell me what they said.

   Claude elige place_call. Esa herramienta está marcada como una que gasta dinero y hace sonar un teléfono real, y su descripción le indica al modelo que te confirme primero, así que el cliente te pide aprobación antes de ejecutarla. Cada place_call lleva una clave de idempotencia; un reintento es seguro solo cuando Claude vuelve a pasar el mismo idempotency_key, como le pide la descripción de la herramienta.

   La conversación la lleva el agente de voz que creaste, no Claude. Después Claude consulta get_call hasta que la llamada termina y te lee la transcripción, el estado y cost_micros, el costo en millonésimas de dólar.

5. 05Conoce qué herramientas preguntan antes de ejecutarse

   Wixzel Voice marca cuatro herramientas como herramientas que gastan dinero o actúan en el mundo real: place_call marca un número, test_call_agent llama a un número y dice una frase, start_campaign llama a todos los leads de una campaña y create_topup inicia un pago. Las herramientas que solo leen, como get_call o list_usage_events, están marcadas como de solo lectura, así que un cliente puede ejecutarlas sin preguntar.

   create_topup nunca paga por sí sola: devuelve un enlace de pago que una persona tiene que abrir y completar.

   Los permisos (scopes) son la segunda barrera. A un cliente que no pide nada concreto se le ofrece el conjunto estándar para agentes; billing:write, que inicia una recarga, y api_keys:write, que crea claves, nunca se ofrecen por defecto y hay que concederlos expresamente. No existe un permiso de administrador.

6. 06Cuando una llamada falla, pregunta por qué

   El servidor incluye otros dos prompts:

   Claude CodeCopiar

   /mcp__wixzel-voice__diagnose_call
   /mcp__wixzel-voice__spend_report

   diagnose_call recibe un id de llamada, lee el failure_code y el failure_reason del registro, sus eventos de uso, el estado de la troncal y los logs SIP recientes, y te dice si la solución está en tu operador o en el agente. No hace ninguna llamada mientras trabaja. spend_report convierte el uso de un periodo en dólares por componente y por llamada.

¿Cuánto cuesta esto en Wixzel Voice?

¿Qué límites de Wixzel Voice se aplican a esto?

• Las llamadas telefónicas necesitan tu propia troncal SIP y un número en ella. Wixzel Voice no vende, porta ni aloja números. En una cuenta de Twilio, Telnyx, Plivo, Vobiz o Vonage conectada desde la consola, Claude puede comprarte un número con purchase_phone_number, facturado por tu operador, una vez que concedas el permiso phone_numbers:purchase.
• La aprobación antes de una herramienta de pago la muestra el cliente. El servidor marca esas herramientas y le indica al modelo que confirme; un cliente configurado para aprobar herramientas automáticamente no preguntará, así que deja desactivada la aprobación automática para este servidor.
• Por defecto, cada cuenta puede tener cinco llamadas en curso a la vez. El límite se amplía a petición.
• Una llamada de prueba es una llamada real: hace sonar un teléfono real a través de tu operador y el contador corre. No hay modo de prueba gratuito.
• Los cambios de comportamiento de Wixzel Voice se publican detrás de un encabezado Wixzel-Version con fecha.