Saltar para o conteúdo
MCP server

volai no Claude Code: um comando e o agente já sabe ligar

O servidor MCP da volai leva as chamadas telefónicas e as SMS para o Claude Code. Basta dizer o que pretende: o agente escolhe a ferramenta certa e usa-a - diretamente a partir da linha de comandos.

Ligar o assistente de IA

Depois de iniciar sessão, copia o pedido já pronto para o chat do seu assistente. O procedimento técnico abaixo é opcional.

Configuração manual

1Crie uma conta e uma chave

Registe-se na volai e confirme o e-mail de verificação - só depois é que o saldo de boas-vindas é creditado. No portal, em Assistente de IA, crie uma nova chave: começa por vk_ e serve também para a API REST.

2Adicione a volai como servidor MCP

No terminal, execute um único comando - regista a volai como servidor HTTP remoto e guarda a chave diretamente na configuração do Claude Code:

bash
claude mcp add --header 'Authorization: Bearer vk_A_SUA_CHAVE' --transport http --scope user volai 'https://volai.cz/mcp'

3Verifique a ligação

Escreva no Claude Code algo como «Vê quanto saldo me resta» - se responder com um valor, em vez de pedir uma chave de API, a volai está corretamente ligada.

4Experimente a primeira chamada

Diga ao editor «Liga-me e experimenta o papel de rececionista de um café» - o Claude Code usa a ferramenta make_call com o parâmetro systemPrompt e inicia uma chamada de teste a partir do número de demonstração partilhado, sem precisar de comprar um número próprio. Condição: e-mail verificado e, no máximo, 3 chamadas de teste por dia e por conta - acima desse limite, ligue através do seu próprio agente (agentId) no seu número, ao qual o limite de três chamadas de teste não se aplica.

Ou adicione a volai ao seu editor com um só clique

Claude Code

bash
claude mcp add --header 'Authorization: Bearer vk_YOUR_KEY' --transport http --scope user volai 'https://volai.cz/mcp'

After installing, replace vk_YOUR_KEY with your key from the AI assistant setup in the portal.

O que pode fazer com isto

Ligar diretamente a partir de um prompt

Diga a quem e porquê pretende ligar e o Claude Code inicia a chamada com a ferramenta make_call - sem mudar para o telemóvel ou para o portal, e também a partir de um script não interativo.

Gerir números e agentes por comandos

buy_number, create_agent, set_number_routing - configurar uma linha telefónica é tão natural como escrever código, com um único prompt.

Depurar chamadas sem mudar de janela

Quando algo não bate certo, peça ao Claude Code que use get_call com o ID da chamada e receba logo a transcrição e o resumo, sem abrir o portal.

Perguntas frequentes

Preciso de instalar alguma coisa?
Não - o claude mcp add limita-se a registar o endereço remoto https://volai.cz/mcp; nada é executado nem instalado localmente.
Onde obtenho a chave de API?
No portal, depois do registo, em Assistente de IA - a chave começa por vk_ e funciona da mesma forma para MCP e REST.
O que consegue o Claude Code fazer com a volai?
Ferramentas como make_call, send_sms, buy_number e create_agent cobrem chamadas, SMS, números, agentes de voz e outras áreas da conta. A lista completa e atualizada está em /docs/mcp.
É seguro dar uma chave de API a um agente?
A chave pode gastar o seu saldo tal como a API REST, por isso guarde-a apenas na configuração local e nunca a coloque num repositório. No portal pode eliminá-la a qualquer momento e criar uma nova.

Experimente já

Registe-se e os primeiros 50 kr são por nossa conta.