Detalles técnicos

El servidor MCP de Vonage permite que los agentes de IA y las herramientas de desarrollo interactúen con las API de Vonage a través del protocolo de contexto de modelo (MCP), un estándar abierto que define cómo los grandes modelos de lenguaje (LLM) descubren, describen y utilizan herramientas y API externas.

Al implementar MCP, Vonage hace que sus capacidades de comunicación (voz, mensajería, vídeo y más) sean detectables y utilizables en entornos agénticos como Claude Desktop, Cursor, VS Code y otros clientes habilitados para MCP.

Visión general

MCP define una interfaz estructurada entre un modelo de IA (el Cliente MCP) y un servicio de exposición de herramientas estandarizadas (el servicio Servidor MCP), que permite el acceso a las API de Vonage mediante lenguaje natural.

En la práctica:

  • El agente (por ejemplo, Claude) recibe una solicitud del usuario, como "Enviar un SMS a Juan".
  • Consulta el servidor MCP de Vonage para encontrar la herramienta adecuada (p. ej. send_sms).
  • El servidor ejecuta la correspondiente llamada a la API de Vonage y devuelve el resultado.

Esta arquitectura permite a los desarrolladores integrar las API de comunicación de Vonage en flujos de trabajo asistidos por IA, sin necesidad de escribir código de cola o integraciones personalizadas.

Características principales

  • Descubrimiento de herramientas - Los clientes MCP pueden detectar y describir automáticamente las herramientas de Vonage disponibles.
  • Acceso seguro - Cada herramienta se ejecuta dentro de un ámbito definido utilizando las credenciales de la API de Vonage.
  • Integración de agentes - Funciona con herramientas basadas en IA como Claude, Cursor, Windsurf y VS Code.
  • Extensibilidad - Los desarrolladores pueden agregar o personalizar herramientas para API específicas de Vonage.

Arquitectura

El modelo MCP consta de tres componentes principales:

Componente Papel
Agente de IA (LLM) Comprende la intención del usuario y determina cuándo utilizar una herramienta.
Cliente MCP Un conector local o plugin (por ejemplo, en Claude o VS Code) que se comunica con los servidores MCP.
Servidor MCP Expone herramientas y esquemas que describen qué acciones son posibles (por ejemplo, enviar mensajes, consultar documentos).

Ejemplo de flujo de solicitudes

MCP Flow Example
  1. Usuario: "Envía un SMS al +1-202-555-0183 diciendo que llegaré 10 minutos tarde".
  2. LLM identifica esto como una acción de telefonía.
  3. El cliente MCP consulta el servidor MCP de telefonía de Vonage para obtener las herramientas disponibles.
  4. Server expone el send_sms y la ejecuta utilizando las API de Vonage.
  5. El LLM recibe la confirmación e informa del éxito al usuario.

Primeros pasos

Véase el Introducción a los servidores MCP de Vonage para obtener más información sobre los diferentes servidores MCP que ofrece Vonage.

A continuación, siga nuestras guías de instalación para obtener instrucciones sobre cómo instalar el servidor MCP elegido en su entorno de desarrollo:

Si tiene alguna pregunta, puede ponerse en contacto con nosotros en el Comunidad de Vonage Slack.