JustCall MCP Server

O servidor JustCall Model Context Protocol (MCP) permite que Modelos de Linguagem de Grande Escala (LLMs) e agentes de IA realizem chamadas de voz reais e enviem SMS diretamente pelas APIs do JustCall — de forma segura, contextual e programática.

GitHub
25
Experimente este MCPPatrocinado

Documentação

Servidor MCP JustCall

O servidor Model Context Protocol (MCP) da JustCall permite que Modelos de Linguagem de Grande Porte (LLMs) e agentes de IA façam chamadas de voz reais e enviem SMS diretamente por meio das APIs da JustCall — de forma segura, contextual e programática.

Ele fornece uma interface de chamada de funções para sistemas de IA conversacional, permitindo:

  • 📞 Chamadas com IA: Deixe seu LLM iniciar, gerenciar ou transcrever chamadas usando a JustCall.
  • 💬 Mensagens inteligentes: Permita que seu agente de IA envie ou responda SMS dentro de conversas.
  • ⚙️ Integração perfeita: Use o padrão MCP para conectar os recursos de telefonia da JustCall a qualquer runtime de LLM ou estrutura de orquestração.

Em resumo: Ele dá aos seus LLMs uma voz e um número de telefone — transformando chatbots em agentes verdadeiramente conversacionais.

Configuração no Claude Desktop

  1. Abra Claude Desktop e pressione CMD + , para ir para Settings.
  2. Clique na aba Connectors.
  3. Clique no botão Add Custom Connector.
  4. Adicione o nome como JustCall e a URL do Servidor Remoto como https://mcp.justcall.host/mcp.
  5. Agora em JustCall, na lista de Conectores, clique no botão Connect para JustCall.
  6. Será aberta uma página da JustCall solicitando chave e segredo da API.
  7. Obtenha sua Chave e Segredo da API JustCall no painel da JustCall (https://app.justcall.io/app/developersApiCredentials).
  8. Insira a chave e o segredo da API e pressione Continuar; você será redirecionado de volta ao Claude.

Claude Web - https://claude.ai

  1. Abra a URL de conectores no seu navegador - https://claude.ai/settings/connectors.
  2. Clique na aba Connectors.
  3. Clique no botão Add Custom Connector.
  4. Adicione o nome como JustCall e a URL do Servidor Remoto como https://mcp.justcall.host/mcp.
  5. Agora em JustCall, na lista de Conectores, clique no botão Connect para JustCall.
  6. Será aberta uma página da JustCall solicitando chave e segredo da API.
  7. Obtenha sua Chave e Segredo da API JustCall no painel da JustCall (https://app.justcall.io/app/developersApiCredentials).
  8. Insira a chave e o segredo da API e pressione Continuar; você será redirecionado de volta ao Claude.

Chat GPT (Disponível apenas nos planos Plus, Pro, Business e Enterprise)

  1. Abra a URL de conectores no seu navegador - https://chatgpt.com/#settings/Connectors.
  2. Clique na aba Apps & Connectors.
  3. Certifique-se de que o modo de desenvolvedor esteja ativado nas configurações avançadas
  4. Clique no botão Create.
  5. Adicione o nome como JustCall e a URL do Servidor MCP como https://mcp.justcall.host/mcp. Você pode pular os outros campos.
  6. Agora em JustCall, na lista de Conectores, clique no botão Connect para JustCall.
  7. Será aberta uma página da JustCall solicitando chave e segredo da API.
  8. Obtenha sua Chave e Segredo da API JustCall no painel da JustCall (https://app.justcall.io/app/developersApiCredentials).
  9. Insira a chave e o segredo da API e pressione Continuar; você será redirecionado de volta ao Chat GPT.

MCP Remoto

Para conectar-se ao servidor MCP da JustCall remotamente:

HTTP Transmissível (Recomendado)

A forma padrão e recomendada de conexão é via Transporte HTTP Transmissível:

  • Conecte-se a https://mcp.justcall.host/mcp a partir de qualquer cliente MCP usando o Transporte HTTP Transmissível
  • Inclua sua chave de API da JustCall como um token de portador nos cabeçalhos da solicitação
  • Exemplo de cabeçalho: Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>

Autenticação e Segurança

O Servidor MCP da JustCall implementa autenticação OAuth2 para acesso seguro a todos os endpoints.

Configuração OAuth2

O servidor suporta autorização OAuth2 com os seguintes recursos:

  • Endpoint de Autorização: Os metadados do servidor de autorização OAuth2 estão disponíveis em /.well-known/oauth-authorization-server
  • Tipo de Concessão: Fluxo de código de autorização com PKCE (Proof Key for Code Exchange)
  • Método de Desafio de Código: S256 (SHA-256)
  • Autenticação de Token: Todos os endpoints MCP e SSE exigem autenticação de token de portador

Endpoints Protegidos

Os seguintes endpoints exigem autenticação válida de token de portador:

  • /mcp - Endpoint MCP principal
  • /sse - Endpoint Server-Sent Events
  • /sse/message - Endpoint de mensagens SSE

Formato do Cabeçalho de Autenticação

Inclua suas credenciais de API da JustCall como um token de portador:

Authorization: Bearer <JWT_TOKEN_BY_OAUTH>
Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>

Endpoints Públicos

Os seguintes endpoints são de acesso público:

  • /health - Endpoint de verificação de saúde (retorna 200 OK)
  • /.well-known/oauth-authorization-server - Metadados do servidor de autorização OAuth2

Uso da API e Limites de Taxa

Este servidor MCP usa a API de Desenvolvedor da JustCall. Todas as solicitações de API estão sujeitas aos limites de taxa associados à sua chave de API da JustCall. Consulte a configuração de credenciais da API JustCall.

Ferramentas Disponíveis

O Servidor MCP da JustCall fornece 66 ferramentas organizadas nas seguintes categorias:

Ferramentas da API JustCall

📞 Chamadas (6 ferramentas)

  • list_calls - Lista todas as chamadas da JustCall com várias opções de filtro
  • get_call - Obtém uma chamada específica da JustCall por ID
  • update_call - Atualiza uma chamada da JustCall (disposição, notas, avaliação)
  • get_call_journey - Busca a sequência de eventos de uma chamada específica
  • get_voice_agent_data - Obtém dados do agente de voz para uma chamada específica (obsoleto, use get_voice_agent_call)
  • get_voice_agent_call - Recupera dados relacionados ao agente de voz para uma chamada específica

👥 Usuários e Agentes (3 ferramentas)

  • list_users - Lista todos os usuários/agentes na conta
  • get_user - Obtém informações detalhadas de um usuário/agente específico
  • update_user_availability - Atualiza o status de disponibilidade de um usuário para disponível ou indisponível para chamadas

💬 SMS e Mensagens (11 ferramentas)

  • send_sms - Envia uma mensagem SMS/texto para um contato
  • list_sms - Recupera todas as mensagens SMS/texto
  • get_sms - Obtém informações detalhadas de uma mensagem SMS/texto específica
  • check_sms_reply - Verifica a resposta SMS de entrada mais recente de um contato específico
  • list_sms_tags - Recupera todas as tags de SMS usadas para organizar mensagens de texto
  • get_sms_tag - Obtém informações detalhadas de uma tag de SMS específica
  • create_sms_tag - Cria uma nova tag para organizar conversas de SMS
  • delete_sms_tag - Exclui uma tag de SMS específica
  • list_sms_threads - Recupera todos os tópicos/conversas de SMS associados a um número da JustCall
  • get_sms_thread - Recupera um tópico/conversa de SMS específico por ID
  • add_sms_thread_tag - Adiciona tag a um tópico/conversa de SMS

📇 Contatos (6 ferramentas)

  • list_contacts - Recupera todos os contatos do CRM
  • get_contact - Recupera informações detalhadas de um contato específico por ID
  • create_contact - Cria um novo contato no CRM
  • update_contact - Atualiza/modifica detalhes de um contato existente
  • update_contact_status - Adiciona ou remove um contato das listas DND/DNM/Blacklist
  • add_contacts_blacklist - Adiciona um ou mais contatos à lista negra global em massa

📊 Análises (4 ferramentas)

  • get_agent_analytics - Recupera dados analíticos de agentes para um intervalo de datas especificado
  • get_account_analytics - Recupera dados analíticos da conta para um intervalo de datas especificado
  • get_number_analytics - Recupera dados analíticos de números para um intervalo de datas especificado
  • get_sales_dialer_analytics - Recupera dados analíticos abrangentes para campanhas do discador de vendas

🔔 Webhooks (2 ferramentas)

  • list_webhooks - Recupera todos os webhooks configurados
  • create_webhook - Cria um novo endpoint de webhook para receber notificações em tempo real

📱 Números de Telefone (2 ferramentas)

  • list_numbers - Recupera todos os números de telefone da JustCall
  • get_number - Recupera informações detalhadas de um número de telefone específico da JustCall

👥 Grupos de Usuários (2 ferramentas)

  • list_user_groups - Recupera todos os grupos de usuários definidos na conta
  • get_user_group - Recupera informações detalhadas de um grupo de usuários específico por ID

📅 Compromissos (3 ferramentas)

  • list_appointment_slots - Recupera todos os horários disponíveis para compromissos em um calendário específico
  • create_appointment - Agenda um novo compromisso em um calendário específico
  • get_appointment - Recupera detalhes de um compromisso específico pelo seu ID

💚 WhatsApp (5 ferramentas)

  • list_whatsapp_messages - Recupera todas as mensagens do WhatsApp associadas à conta
  • get_whatsapp_message - Recupera informações detalhadas de uma mensagem específica do WhatsApp por ID
  • send_whatsapp_message - Envia uma nova mensagem do WhatsApp para um número de contato
  • list_whatsapp_templates - Recupera todos os modelos de mensagem do WhatsApp disponíveis na conta
  • check_whatsapp_message_reply - Verifica a mensagem do WhatsApp de entrada mais recente de um contato

🤖 Análise de IA (4 ferramentas)

  • list_calls_ai_analysis - Recupera análises geradas por IA (transcrição, resumo, insights) para todas as chamadas
  • get_call_ai_analysis - Recupera análises geradas por IA para uma chamada específica por ID de Chamada
  • list_meetings_ai_analysis - Recupera análises geradas por IA para reuniões gravadas (Zoom, Google Meet)
  • get_meeting_ai_analysis - Recupera análises geradas por IA para uma reunião específica por ID de Instância

🎙️ Agentes de Voz (2 ferramentas)

  • list_voice_agents - Recupera todos os agentes de voz de IA associados à conta
  • create_voice_agent_call - Inicia uma chamada de saída de um agente de voz de IA configurado para um contato

Ferramentas do Discador de Vendas

📢 Campanhas (6 ferramentas)

  • list_campaigns - Recupera todas as campanhas do discador de vendas
  • get_campaign - Recupera informações detalhadas de uma campanha específica do discador de vendas
  • create_campaign - Cria uma nova campanha do discador de vendas
  • update_campaign - Atualiza detalhes da campanha, incluindo nome, descrição, status e atribuições
  • list_salesdialer_campaign_contacts - Recupera todos os contatos em uma campanha específica
  • add_salesdialer_campaign_contact - Adiciona contato a uma campanha específica

👥 Contatos (8 ferramentas)

  • list_salesdialer_contacts - Recupera todos os contatos do Discador de Vendas
  • get_salesdialer_contact - Recupera informações detalhadas de um contato específico por ID
  • create_salesdialer_contact - Cria um novo contato no Discador de Vendas
  • update_salesdialer_contact - Atualiza/modifica detalhes de um contato existente
  • import_salesdialer_contacts - Importa vários contatos para o Discador de Vendas ou uma campanha em massa
  • import_salesdialer_contacts_status - Verifica o status de um trabalho de importação em massa por ID de lote
  • add_salesdialer_contacts_dnca - Adiciona um ou mais contatos à lista "Não Ligar Novamente" em massa
  • list_salesdialer_custom_fields - Busca todos os campos personalizados de contato definidos no Discador de Vendas

📞 Chamadas (2 ferramentas)

  • list_salesdialer_calls - Recupera todas as chamadas feitas pelo Discador de Vendas
  • get_salesdialer_call - Recupera informações detalhadas de uma chamada específica do Discador de Vendas por ID

📊 Análises (2 ferramentas)

  • get_sales_dialer_analytics - Recupera dados analíticos abrangentes para campanhas do discador de vendas
  • get_salesdialer_agent_analytics - Recupera análises de desempenho de chamadas de um agente específico para uma campanha.