Como instalar os bindings da API do servidor Vonage no servidor MCP

O Ligações da API do servidor Vonage ao servidor MCP, também conhecido como Tooling MCP Server, permite que você execute várias ações da API diretamente por meio do seu LLM Assistant ou do IDE de sua preferência. Seja trabalhando em VS Code, Cursor, ou Área de trabalho do Claude, agora você pode obter informações que antes precisava visitar o Painel do Cliente da Vonage para.

Configuração no VS Code ou no Cursor

O processo de configuração é idêntico nos dois editores.

Passo 1: Abra a configuração do MCP

  1. Imprensa Command+Shift+P (macOS) ou Ctrl+Shift+P (Windows/Linux).
  2. Pesquisar por “MCP: Abrir configuração do usuário.”
  3. No mcp.json No arquivo que for aberto, adicione a seguinte configuração:
{
  "servers": {
    "vonage-mcp-server-api-bindings": {
        "type": "stdio",
        "command": "npx",
        "args": [
            "-y",
            "@vonage/vonage-mcp-server-api-bindings"
        ],
        "env": {
            "VONAGE_APPLICATION_ID": "<YOUR_VONAGE_APPLICATION_ID>",
            "VONAGE_PRIVATE_KEY64": "<YOUR_VONAGE_PRIVATE_KEY64>",
            "VONAGE_API_KEY": "<YOUR_VONAGE_API_KEY>",
            "VONAGE_API_SECRET": "<YOUR_VONAGE_API_SECRET>",
            "VONAGE_VIRTUAL_NUMBER": "<YOUR_VONAGE_VIRTUAL_NUMBER>",
            "VONAGE_WHATSAPP_NUMBER": "<YOUR_VONAGE_WHATSAPP_NUMBER>",
            "RCS_SENDER_ID": "<YOUR_RCS_SENDER_ID>"
        }
    }
  },
  "inputs": []
}

Observe que só aceitamos a chave privada no formato Base64. Recomendamos usar https://mylight.work/private-key-to-environment-variable para converter sua chave privada para o formato base64, já que essa ferramenta funciona inteiramente no seu navegador e não transmite nada para um servidor de terceiros.

Etapa 2: Salvar e atualizar a página

Salve o arquivo, feche o editor e reinicie VS Code ou Cursor.
A extensão MCP fará o download e iniciará automaticamente o Servidor MCP da Vonage Tooling.

Agora você pode realizar ações comuns no painel, como:

“Você poderia criar um novo aplicativo da Vonage chamado ‘My Chat App’?”

Configuração no Claude Desktop

Passo 1: Localize o arquivo de configuração

Abra (ou crie) seu arquivo de configuração do Claude MCP:

  • macOS:
    ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows:
    %APPDATA%\Claude\claude_desktop_config.json

Etapa 2: Adicionar o servidor do Vonage Docs

Adicione o trecho a seguir dentro do "servers" seção:

{
  "servers": {
    "vonage-mcp-server-api-bindings": {
        "type": "stdio",
        "command": "npx",
        "args": [
            "-y",
            "@vonage/vonage-mcp-server-api-bindings"
        ],
        "env": {
            "VONAGE_APPLICATION_ID": "<YOUR_VONAGE_APPLICATION_ID>",
            "VONAGE_PRIVATE_KEY64": "<YOUR_VONAGE_PRIVATE_KEY64>",
            "VONAGE_API_KEY": "<YOUR_VONAGE_API_KEY>",
            "VONAGE_API_SECRET": "<YOUR_VONAGE_API_SECRET>",
            "VONAGE_VIRTUAL_NUMBER": "<YOUR_VONAGE_VIRTUAL_NUMBER>",
            "VONAGE_WHATSAPP_NUMBER": "<YOUR_VONAGE_WHATSAPP_NUMBER>",
            "RCS_SENDER_ID": "<YOUR_RCS_SENDER_ID>"
        }
    }
  },
  "inputs": []
}

Etapa 3: Reinicie o Claude

Reiniciar Área de trabalho do Claude. Ele se conectará automaticamente ao Documentação da Vonage: Servidor MCP.

Agora você pode fazer perguntas ao Claude, como:

“Você poderia listar as Applications que configurei no meu Account?”

Claude obterá a resposta diretamente de API da Vonage e exibi-los para você.