Faça uma chamada Voice pedindo ao Claude

Introdução

Já mostrei a vocês como o servidor MCP do Vonage Tooling pode ser acessado pelo Postman. Na postagem de hoje, vou mostrar como acessá-lo pelo Claude Desktop, e o caso de uso em que vou me concentrar é acionar uma chamada de voz de saída real usando a mesma forma como você se comunicaria com LLMs, ou seja, por meio de um prompt em linguagem natural. Vamos usar o Claude Desktop, criar um Account na Vonage, obter algumas chaves de API, adicioná-las ao Claude e ver tudo em ação.

Pré-requisitos

Antes de começarmos e fazermos essa ligação, você vai precisar de:

• Claude Desktop instalado

• Node.js instalado

• A Account da Vonage

Selecione “Voice” na seção “Recursos”, pois vamos usar a Voice API para fazer chamadas.

Clique para salvar seu aplicativo Vonage recém-criado com a funcionalidade de Voice, localizado no canto inferior direito.

Adicione o servidor MCP da Vonage Tooling ao Claude Desktop

Abra o Claude Desktop e, na guia “Configurações”, clique em “Desenvolvedor” e, em seguida, em “Editar configuração”. Isso o levará ao arquivo “claude_desktop_config.json”, mas você também pode abri-lo diretamente, conforme mostrado abaixo:

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

• Windows: %APPDATA%\Claude\claude_desktop_config.json, que geralmente corresponde a algo como C:\Users\username\AppData\Local\Packages\Claude\LocalCache\Roaming\Claude

{

  "mcpServers": {

    "vonage-tooling": {

      "command": "npx",

      "args": [

        "-y",

        "@vonage/vonage-mcp-server-api-bindings"

      ],

      "env": {

        "VONAGE_API_KEY": "YOUR_API_KEY",

        "VONAGE_API_SECRET": "YOUR_API_SECRET",

        "VONAGE_APPLICATION_ID": "YOUR_APP_ID",

        "VONAGE_PRIVATE_KEY64": "YOUR_BASE64_PRIVATE_KEY",

        "VONAGE_VIRTUAL_NUMBER": "+1234567890"

      }

    }

  }

}

Observação: VONAGE_PRIVATE_KEY64 é o seu arquivo de chave privada codificado em base64. No macOS/Linux, você pode gerá-lo com base64 -i private.key | tr -d '\n' . Eu queria copiá-lo para a área de transferência enquanto fazia isso no GitHub Codespaces e usei o seguinte comando: base64 -i private.key | tr -d '\n' > b64_key.txt && code b64_key.txt para copiá-lo para um novo arquivo .txt, mas você pode usar | pbcopy no macOS para copiá-lo para a área de transferência.

Salve o arquivo e não se esqueça de reiniciar o Claude Desktop para que todas as alterações feitas sejam aplicadas. Você deverá ver as ferramentas da Vonage aparecerem na aba “Conectores” das configurações. Certifique-se de conceder permissão à ferramenta “Mensagem de voz de saída”.

Tools Permissions

Fazer uma chamada de voz de saída

Agora que a configuração está concluída, abra uma nova conversa no Claude Desktop e digite algo como: “Use a ferramenta de mensagens de voz de saída da Vonage para ligar para +44XXXXXXXXX e dizer: Olá, esta é uma ligação de teste do Claude.”

Claude identificará a ferramenta de mensagens de voz de saída da MCP da Vonage, que, nos bastidores, se conecta diretamente à Voice API da Vonage. O servidor MCP cuida da autenticação e da chamada à API; basta você descrever o que deseja em linguagem simples. Ele confirma os parâmetros e realiza a chamada.

Seu celular toca e lê a mensagem em voz alta usando a função de conversão de texto em fala. Você pode tentar escrever um texto diferente que gostaria que fosse lido em voz alta.

Claude Conversation

Conclusão

Por que não experimentar as outras ferramentas com o Claude? Verifique o saldo da sua Account antes de fazer a ligação, liste suas Applications e Numbers para escolher o mais adequado, envie um SMS de acompanhamento após a ligação — tudo isso usando as mesmas instruções em linguagem natural.

É muito legal o que podemos fazer com o Claude Desktop e os servidores MCP da Vonage. Na minha próxima postagem no blog, vou mostrar como você pode interagir com os MCPs da Vonage usando o Google Antigravity. Fique ligado.