Detalhes técnicos

O servidor MCP da Vonage permite que agentes de IA e ferramentas de desenvolvimento interajam com as APIs da Vonage por meio do Model Context Protocol (MCP) — um padrão aberto que define como os grandes modelos de linguagem (LLMs) identificam, descrevem e utilizam ferramentas e APIs externas.

Ao implementar o MCP, a Vonage torna seus recursos de comunicação (voz, mensagens, vídeo e muito mais) acessíveis e utilizáveis em ambientes de agentes, como o Claude Desktop, o Cursor, o VS Code e outros clientes compatíveis com o MCP.

Visão geral

O MCP define uma interface estruturada entre um modelo de IA (o Cliente MCP) e um serviço que disponibiliza ferramentas padronizadas (o Servidor MCP), permitindo o acesso às APIs da Vonage por meio de linguagem natural.

Na prática:

  • O agente (como o Claude) recebe uma solicitação do usuário, como “Envie um SMS para o John”.
  • Ele consulta o servidor MCP da Vonage para encontrar a ferramenta correta (por exemplo, send_sms).
  • O servidor executa a chamada correspondente à API da Vonage e retorna o resultado.

Essa arquitetura permite que os desenvolvedores integrem as APIs de comunicação da Vonage a fluxos de trabalho assistidos por IA — sem precisar escrever código de ligação nem criar integrações personalizadas.

Principais recursos

  • Descoberta de ferramentas – Os clientes do MCP podem detectar e descrever automaticamente as ferramentas da Vonage disponíveis.
  • Acesso seguro – Cada ferramenta é executada dentro de um escopo definido, utilizando as credenciais da API da Vonage.
  • Integração de agentes – É compatível com ferramentas baseadas em IA, como Claude, Cursor, Windsurf e VS Code.
  • Extensibilidade – Os desenvolvedores podem adicionar ou personalizar ferramentas para APIs específicas da Vonage.

Arquitetura

O modelo MCP é composto por três componentes principais:

Componente Função
Agente de IA (LLM) Compreende a intenção do usuário e determina quando utilizar uma ferramenta.
Cliente MCP Um conector ou plug-in local (por exemplo, no Claude ou no VS Code) que se comunica com os servidores do MCP.
Servidor MCP Apresenta ferramentas e esquemas que descrevem quais ações são possíveis (por exemplo, enviar mensagens, consultar documentos).

Exemplo de fluxo de solicitação

MCP Flow Example
  1. Usuário: “Envie um SMS para +1-202-555-0183 dizendo que vou me atrasar 10 minutos.”
  2. O LLM identifica isso como uma ação de telefonia.
  3. O MCP Client consulta o servidor MCP de telefonia da Vonage para verificar as ferramentas disponíveis.
  4. O servidor expõe o send_sms ferramenta e a executa usando as APIs da Vonage.
  5. O LLM recebe a confirmação e informa ao usuário que a operação foi bem-sucedida.

Introdução

Veja o Introdução aos servidores MCP da Vonage guia para obter mais informações sobre os diferentes servidores MCP oferecidos pela Vonage.

Em seguida, siga nossos guias de instalação para obter instruções sobre como instalar o servidor MCP escolhido em seu ambiente de desenvolvimento:

Se tiver alguma dúvida, entre em contato conosco pelo Slack da Comunidade Vonage.