volai

API de telefonia tcheca e MCP para aplicativos e agentes de IA - números, chamadas, SMS, agente de voz (servidor remoto em https://volai.cz/mcp).

GitHub

Documentação

volai

API de telefonia tcheca e MCP para aplicativos e agentes de IA - números, chamadas, SMS, agente de voz. Este plugin conecta Codex e Claude Code ao servidor MCP volai (75 ferramentas: números, chamadas, SMS, agentes de voz, webhooks, calendários conectados e faturas) e inclui a habilidade completa volai para que o Claude conheça as convenções da API (números E.164, preços em hellers tchecos, chaves de idempotência) sem necessidade de prompts adicionais.

Instalação

claude plugin marketplace add https://volai.cz/.claude-plugin/marketplace.json
claude plugin install volai@volai

Entre com volai

O plugin usa OAuth. Conecte o servidor, abra a página de login e aprove o acesso à sua conta volai. A página de consentimento descreve o acesso aos dados da conta, agentes de voz, chamadas pagas, SMS e pedidos de números. Revogue o acesso a qualquer momento em API e MCP no portal volai.

Para uma conexão MCP direta no Claude Code:

claude mcp add --transport http volai https://volai.cz/mcp

Em seguida, use /mcp para autenticar. No Codex, adicione a URL MCP remota https://volai.cz/mcp e faça login. Este arquivo inclui tanto os manifestos de plugin para Claude quanto para Codex. A distribuição por meio do marketplace próprio deste projeto não implica aprovação por nenhum dos diretórios oficiais.

Alternativa com chave de API

As chaves de API existentes continuam suportadas. Para uma conexão manual no Claude Code:

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

Os exemplos REST em examples/ leem VOLAI_API_KEY:

export VOLAI_API_KEY=vk_YOUR_KEY

Obtenha uma chave no portal volai em API e MCP (https://volai.cz/en/api-and-mcp) após se cadastrar em https://volai.cz/en/auth/signup. Trate a chave como uma senha - qualquer pessoa que a possua pode gastar seu crédito (comprar números, fazer chamadas, enviar SMS).

O que você obtém

  • Servidor MCP (https://volai.cz/mcp) - as mesmas 75 ferramentas documentadas em https://volai.cz/en/docs/mcp, autenticadas via OAuth ou chave de API.
  • Habilidade volai (skills/volai/SKILL.md) - a referência completa da API (autenticação, convenções, endpoints, lista de ferramentas) para que o Claude escolha a ferramenta e os nomes de campos corretos sem adivinhar.
  • Exemplos (examples/) - dois pequenos scripts Node 20 (send-sms.mjs, make-call.mjs) que chamam a API REST diretamente com fetch, sem dependências.

Experimente

Depois de instalado, basta pedir ao Claude Code coisas como:

  • "Envie um SMS para +420777123456 dizendo que o pedido está pronto."
  • "Me ligue em +420777123456 e tente ser um recepcionista de café - não quero configurar meu próprio número ou agente para isso."
  • "Liste minhas últimas 10 chamadas e resuma-as."

Mais

Documentação completa: https://volai.cz/en/docs. Preços: https://volai.cz/en/pricing. Suporte: podpora@volai.cz.

Licença

MIT, veja LICENSE. (c) ANOVIA Finance s.r.o.