Introdução aos servidores MCP da Vonage

O que é o Protocolo de Contexto do Modelo (MCP)?

O Protocolo de Contexto de Modelo (MCP) é um padrão aberto que define como os modelos de IA podem identificar e utilizar ferramentas externas, APIs e fontes de dados de maneira consistente e segura.

Assim como OpenAPI Para ajudar os desenvolvedores a entender como chamar uma API, o MCP oferece Agentes de IA uma maneira estruturada de compreender e utilizar ferramentas.

Cada ferramenta do MCP define claramente:

  • O que ele faz
  • Quais são os dados necessários?
  • O que ela retorna

Ao utilizar essa estrutura compartilhada, os agentes podem realizar chamadas de API com segurança — sem nenhuma integração codificada de forma rígida.

O que são os servidores MCP da Vonage?

A Vonage oferece algumas implementações diferentes do MCP, de acordo com suas necessidades. Contamos com um Servidor de Documentação que disponibiliza nossa documentação para modelos LLM, para que você possa obter respostas atualizadas, e um servidor MCP de ligação de API que expõe as APIs da Vonage e as ferramentas de desenvolvimento em um formato nativo de IA, que pode ser usado diretamente por clientes compatíveis com o MCP — como o Claude Desktop ou a extensão MCP do VS Code.

Na prática, isso significa que desenvolvedores e agentes de IA podem consultar a documentação, gerenciar Applications da Vonage e automatizar tarefas de comunicação simplesmente usando linguagem natural, o que traz diversos benefícios:

  • Descoberta baseada em IA – Disponibilizar as APIs da Vonage diretamente para ferramentas e assistentes de IA.
  • Configuração mais rápida – Acesse a documentação e as ferramentas da Account instantaneamente.
  • Seguro e estruturado – Todas as interações com a ferramenta seguem um formato claro e baseado em esquema.
  • Experiência consistente para o desenvolvedor – O mesmo padrão MCP é utilizado na documentação, na configuração e em outros serviços da Vonage.

Tipos de servidores MCP da Vonage

A Vonage oferece dois servidores MCP projetados para finalidades diferentes:

Servidor MCP Descrição Objetivo
Documentação do MCP Server Permite que os assistentes de IA pesquisem e retornem informações da documentação da API da Vonage. Encontre rapidamente detalhes da API, guias e trechos de código sem sair do seu IDE.
Ligações de API do servidor MCP Server Também conhecido como nosso Servidor MCP de Ferramentas, ele oferece ferramentas para gerenciar Applications, Numbers e relatórios da Vonage de forma programática. Permite a configuração e o gerenciamento de contas diretamente por meio de comandos de IA.

Cada servidor segue a mesma estrutura MCP, o que os torna interoperáveis e fáceis de usar em conjunto.

Como funciona

Aqui está um exemplo de como o servidor MCP da Vonage se integra a um fluxo de trabalho de IA:

  1. Um desenvolvedor pergunta ao seu assistente de IA:

    “Mostre-me como enviar uma mensagem pelo WhatsApp usando as APIs da Vonage.”

  2. Do assistente Cliente MCP verifica quais servidores estão disponíveis e identifica o Documentação do MCP Server.

  3. O servidor retorna seções relevantes da documentação diretamente do Portal Oficial de Desenvolvedores da Vonage.

  4. Mais tarde, o desenvolvedor pergunta:

    “Crie um novo aplicativo da Vonage com a função de mensagens ativada.”

  5. O assistente muda para o Ferramentas do servidor MCP, que chama a API apropriada para criar e configurar o aplicativo — sem necessidade de configuração manual.

Esse fluxo de trabalho faz a ponte entre a linguagem natural e as ações da API, permitindo que os desenvolvedores se concentrem na criação, em vez de se dedicarem a pesquisas ou à criação de scripts.

Clientes compatíveis

O servidor MCP da Vonage é compatível com qualquer ambiente de IA ou IDE que ofereça suporte ao Protocolo de Contexto de Modelo, incluindo:

  • Área de trabalho do Claude
  • Extensão MCP do VS Code
  • IDE do Cursor

Os guias de configuração estão disponíveis para cada ambiente nos guias de instalação para o servidor de documentação e para o ligações à API do servidor