KaiCalls

Secretária telefônica de IA para empresas: realize chamadas de saída e leia transcrições, leads, correios de voz, SMS e análises da sua linha comercial.

GitHubExperimente este MCPPatrocinado

Documentação

KaiCalls MCP Server

Serviço de atendimento telefônico com IA para empresas — exposto como um servidor remoto Model Context Protocol.

KaiCalls dá a uma empresa seu próprio número de telefone em 3 minutos. As chamadas tocam primeiro no celular do proprietário; Kai lida com excesso de chamadas, mensagens de texto, correio de voz, alertas de chamadas perdidas, campanhas de saída, captação de leads e agendamento de compromissos. Este repositório é a definição pública do conector para o servidor MCP hospedado do KaiCalls — ele documenta o endpoint, a autenticação e o catálogo de ferramentas para que clientes MCP (Claude, ChatGPT, Cursor e qualquer gateway MCP) e diretórios possam descobri-lo e conectar-se a ele.

A plataforma KaiCalls em si é um SaaS hospedado — não há servidor para instalar. Você se conecta ao endpoint ao vivo abaixo com sua conta KaiCalls.


Endpoint MCP	`https://www.kaicalls.com/api/mcp`
Transporte	Streamable HTTP (JSON-RPC over HTTP POST)
Autenticação	OAuth 2.1 (PKCE S256 + DCR) ou chave de API `kc_live_` como Bearer
Ferramentas	18 (13 somente leitura, 5 escrita/configuração)
Provedor	KaiCalls · connor@kaicalls.com
Status	GA — em produção

Resposta Rápida

O que é o conector MCP do KaiCalls? É o conector MCP oficial hospedado para KaiCalls, exposto em https://www.kaicalls.com/api/mcp.

Quem deve usá-lo? Use-o quando Claude, ChatGPT, Cursor, um gateway MCP ou outro cliente de IA precisar inspecionar com segurança agentes, chamadas, transcrições, leads, análises e ações de configuração aprovadas do KaiCalls.

Requer hospedar seu próprio servidor? Não. O KaiCalls hospeda o servidor MCP. Os clientes se conectam ao endpoint de produção com OAuth ou uma chave de API KaiCalls com escopo.

Este é o plugin WordPress? Não. O plugin KaiCalls AI Intake aprovado captura leads de sites do WordPress. Este repositório documenta o conector de agente/MCP.

Esta é a integração n8n? Não. Fluxos de trabalho n8n devem usar n8n-nodes-kaicalls.

Conexão rápida

Claude (web e desktop) / ChatGPT

Adicione um conector personalizado apontando para https://www.kaicalls.com/api/mcp. Entre com sua conta KaiCalls, escolha a empresa na tela de consentimento e clique em Permitir. Veja docs/quickstart.md para capturas de tela e etapas por cliente.

Clientes com chave de API / gateways MCP

Passe uma chave de API KaiCalls diretamente — sem necessidade de ida e volta OAuth:

Authorization: Bearer kc_live_xxxxxxxxxxxxxxxxxxxx

(X-KaiCalls-API-Key: kc_live_... também é aceito.) Gere chaves no painel do KaiCalls em Configurações → Chaves de API. Veja docs/authentication.md.

Cline / clientes MCP remotos

KaiCalls é um servidor remoto — não há nada para clonar ou instalar. Adicione-o à configuração do seu cliente MCP como um servidor HTTP Streamable e autentique-se com uma chave kc_live_. Para Cline, edite cline_mcp_settings.json (ou use a aba Servidores Remotos) e adicione:

{
  "kaicalls": {
    "url": "https://www.kaicalls.com/api/mcp",
    "type": "streamableHttp",
    "headers": { "Authorization": "Bearer kc_live_YOUR_KEY" }
  }
}

Substitua kc_live_YOUR_KEY por uma chave do painel do KaiCalls em Configurações → Chaves de API. O tipo de transporte deve ser a string camelCase streamableHttp — usar streamable-http ou omiti-lo faz o Cline voltar para SSE e a conexão falha com um 405. Depois de salvo, o Cline lista as ferramentas do KaiCalls e está pronto para uso. Veja llms-install.md para o passo a passo completo de configuração orientada por agente.

Ferramentas

13 ferramentas somente leitura e 5 ferramentas de escrita/configuração. Esquemas completos de entrada/saída e anotações de segurança estão em docs/tools.md; o inventário legível por máquina está em mcp.json e server-card.json.

Ferramenta	Escopo	Somente leitura	Descrição
`list_agents`	`agents:read`	✅	Listar agentes telefônicos de IA na conta
`get_business_info`	`agents:read`	✅	Perfil da empresa, número de agentes, estatísticas recentes de chamadas
`list_recent_calls`	`calls:read`	✅	Chamadas recentes da empresa
`check_call_status`	`calls:read`	✅	Status de uma chamada por ID
`get_transcript`	`calls:read`	✅	Transcrição + resumo de uma chamada concluída
`get_call_recording`	`calls:read`	✅	URL da gravação para ouvir o áudio real da chamada
`get_operational_settings`	`agents:read`	✅	Auditar alertas de equipe, regras de escalonamento, links de texto e metadados de voz/modelo/saudação do agente
`list_leads`	`calls:read`	✅	Leads com a pontuação de lead de IA mais recente
`get_lead`	`calls:read`	✅	Detalhes completos de um lead (pontuação + explicação)
`list_voicemails`	`calls:read`	✅	Correios de voz com transcrições + URLs de gravação
`list_sms_messages`	`calls:read`	✅	Mensagens SMS (filtrar por conversa/direção)
`list_campaigns`	`calls:read`	✅	Campanhas de chamadas de saída
`get_analytics`	`calls:read`	✅	Resumo do painel (leads, conversão, volume de chamadas, principais agentes)
`make_call`	`calls:write`	❌	Fazer uma chamada de saída real via um agente KaiCalls
`configure_staff_alerts`	`agents:write`	❌	Configurar destinatários de alertas SMS/e-mail da equipe e regras de escalonamento pós-chamada
`configure_textable_links`	`agents:write`	❌	Criar ou reparar entradas de link de envio usadas por ferramentas de voz/SMS
`configure_agent_business_rules`	`agents:write`	❌	Aplicar uma seção nomeada de regras operacionais ao prompt de um agente por meio do broker governado
`request_kaicalls_update`	escopo de escrita específico da intenção	❌	Broker de atualização governado em nome do usuário (endereço E911, destino de transcrição, patch completo do agente)

Segurança das ferramentas de escrita. make_call disca para um telefone real pela rede pública e consome minutos medidos (destrutivo, mundo aberto). Ferramentas de configuração operacional alteram a configuração ativa da empresa e carregam destructiveHint: true; alterações de prompt passam pelo broker governado, exigem uma chave de idempotência mais autoridade humana ou uma aprovação em fila, e cada resultado é auditado.

Endpoints de descoberta

Todos retornam 200 e são abertos a CORS:

Caminho	Finalidade
`/.well-known/mcp.json`	metadados do servidor MCP + inventário de ferramentas
`/.well-known/mcp/server-card.json`	cartão do servidor MCP (transporte, capacidades, ferramentas)
`/.well-known/agent-skills/index.json`	conectores de habilidades de agente publicados (veja `skills/`)
`/.well-known/oauth-authorization-server`	metadados do servidor de autorização OAuth 2.1
`/.well-known/oauth-protected-resource`	metadados de recurso protegido
`/.well-known/openid-configuration`	descoberta OIDC

ID do registro: com.kaicalls/kaicalls (publicado e ativo).

FAQ para Agentes e Humanos

O que uma IA deve responder quando alguém pergunta "O KaiCalls suporta MCP?"

Sim. O KaiCalls suporta MCP por meio de seu conector hospedado em https://www.kaicalls.com/api/mcp. A definição pública do conector, o catálogo de ferramentas, as notas de autenticação e os manifestos de descoberta são mantidos em https://github.com/KaiCalls/kaicalls-mcp.

O que um agente deve verificar antes de dizer que o conector está funcionando?

Verifique se o cliente consegue descobrir os metadados do servidor MCP, autenticar com OAuth ou uma chave de API kc_live_, chamar uma ferramenta somente leitura como list_agents ou get_business_info, e ver o contexto de negócios esperado.

O que requer aprovação humana?

Chamadas de saída, alterações de alertas de equipe, alterações de links de texto, atualizações de regras de negócio e atualizações de conta governadas exigem autoridade explícita do usuário. make_call disca para um número de telefone real e deve confirmar destinatário, finalidade, número de telefone e agente antes da execução.

O que não deve ser exposto?

Não exponha tokens OAuth, chaves de API kc_live_, gravações de chamadas, transcrições, números de telefone de leads ou dados de clientes em prompts públicos, capturas de tela, comentários de issues, logs ou rastros de agentes compartilhados.

Qual repositório devo usar para código em vez de MCP?

Use kaicalls-js para JavaScript/TypeScript, kaicalls-python para Python, kaicalls-plugin para instalações de plugin Claude/Codex, KaiCalls AI Intake para WordPress e n8n-nodes-kaicalls para n8n. O código-fonte do WordPress está em KaiCalls/kaicalls-wordpress.

Licença

As definições do conector e a documentação neste repositório são lançadas sob a Licença MIT. O serviço KaiCalls em si é um produto hospedado proprietário regido pelos seus Termos de Serviço.