JustCall MCP Server

El servidor JustCall Model Context Protocol (MCP) permite que los modelos de lenguaje grandes (LLMs) y agentes de IA realicen llamadas de voz reales y envíen SMS directamente a través de las APIs de JustCall, de forma segura, contextual y programática.

GitHub
25
Prueba este MCPPatrocinado

Documentación

Servidor MCP de JustCall

El Protocolo de Contexto de Modelo (MCP) de JustCall permite que los Modelos de Lenguaje de Gran Tamaño (LLMs) y agentes de IA realicen llamadas de voz reales y envíen SMS directamente a través de las APIs de JustCall — de forma segura, contextual y programática.

Proporciona una interfaz de llamada a funciones para sistemas de IA conversacional, que permite:

  • 📞 Llamadas impulsadas por IA: Permite que tu LLM inicie, gestione o transcriba llamadas usando JustCall.
  • 💬 Mensajería inteligente: Permite que tu agente de IA envíe o responda SMS dentro de conversaciones.
  • ⚙️ Integración sin interrupciones: Usa el estándar MCP para conectar las capacidades de telefonía de JustCall con cualquier runtime de LLM o marco de orquestación.

En resumen: Le da a tus LLMs una voz y un número de teléfono — convirtiendo chatbots en agentes verdaderamente conversacionales.

Configuración de Claude Desktop

  1. Abre Claude Desktop y presiona CMD + , para ir a Settings.
  2. Haz clic en la pestaña Connectors.
  3. Haz clic en el botón Add Custom Connector.
  4. Agrega el nombre como JustCall y la URL del servidor remoto como https://mcp.justcall.host/mcp.
  5. Ahora en JustCall de la lista de conectores, haz clic en el botón Connect para JustCall.
  6. Se abrirá una página de JustCall solicitando la clave y el secreto de la API.
  7. Obtén tu clave y secreto de la API de JustCall desde el panel de JustCall (https://app.justcall.io/app/developersApiCredentials).
  8. Ingresa la clave y el secreto de la API y presiona Continuar; debería redirigirte de vuelta a Claude.

Claude Web - https://claude.ai

  1. Abre la URL de conectores en tu navegador - https://claude.ai/settings/connectors.
  2. Haz clic en la pestaña Connectors.
  3. Haz clic en el botón Add Custom Connector.
  4. Agrega el nombre como JustCall y la URL del servidor remoto como https://mcp.justcall.host/mcp.
  5. Ahora en JustCall de la lista de conectores, haz clic en el botón Connect para JustCall.
  6. Se abrirá una página de JustCall solicitando la clave y el secreto de la API.
  7. Obtén tu clave y secreto de la API de JustCall desde el panel de JustCall (https://app.justcall.io/app/developersApiCredentials).
  8. Ingresa la clave y el secreto de la API y presiona Continuar; debería redirigirte de vuelta a Claude.

Chat GPT (Solo disponible en Plus, Pro, Business y Enterprise)

  1. Abre la URL de conectores en tu navegador - https://chatgpt.com/#settings/Connectors.
  2. Haz clic en la pestaña Apps & Connectors.
  3. Asegúrate de que el modo desarrollador esté habilitado en la configuración avanzada.
  4. Haz clic en el botón Create.
  5. Agrega el nombre como JustCall y la URL del servidor MCP como https://mcp.justcall.host/mcp. Puedes omitir otros campos.
  6. Ahora en JustCall de la lista de conectores, haz clic en el botón Connect para JustCall.
  7. Se abrirá una página de JustCall solicitando la clave y el secreto de la API.
  8. Obtén tu clave y secreto de la API de JustCall desde el panel de JustCall (https://app.justcall.io/app/developersApiCredentials).
  9. Ingresa la clave y el secreto de la API y presiona Continuar; debería redirigirte de vuelta a Chat GPT.

MCP Remoto

Para conectarte al servidor MCP de JustCall de forma remota:

HTTP Transmisible (Recomendado)

La forma predeterminada y recomendada de conectarse es a través del Transporte HTTP Transmisible:

  • Conéctate a https://mcp.justcall.host/mcp desde cualquier cliente MCP usando el Transporte HTTP Transmisible.
  • Incluye tu clave de API de JustCall como token de portador en los encabezados de la solicitud.
  • Ejemplo de encabezado: Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>

Autenticación y Seguridad

El servidor MCP de JustCall implementa autenticación OAuth2 para acceso seguro a todos los endpoints.

Configuración de OAuth2

El servidor admite autorización OAuth2 con las siguientes características:

  • Endpoint de Autorización: Los metadatos del servidor de autorización OAuth2 están disponibles en /.well-known/oauth-authorization-server
  • Tipo de Concesión: Flujo de código de autorización con PKCE (Clave de Prueba para Intercambio de Código)
  • Método de Desafío de Código: S256 (SHA-256)
  • Autenticación de Token: Todos los endpoints MCP y SSE requieren autenticación de token de portador

Endpoints Protegidos

Los siguientes endpoints requieren autenticación válida de token de portador:

  • /mcp - Endpoint MCP principal
  • /sse - Endpoint de Eventos Enviados por el Servidor
  • /sse/message - Endpoint de mensajes SSE

Formato del Encabezado de Autenticación

Incluye tus credenciales de la API de JustCall como token de portador:

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

Endpoints Públicos

Los siguientes endpoints son de acceso público:

  • /health - Endpoint de verificación de salud (devuelve 200 OK)
  • /.well-known/oauth-authorization-server - Metadatos del servidor de autorización OAuth2

Uso de la API y Límites de Velocidad

Este servidor MCP utiliza la API de Desarrollador de JustCall. Todas las solicitudes de API están sujetas a los límites de velocidad asociados con tu clave de API de JustCall. Consulta tu configuración de credenciales de la API de JustCall.

Herramientas Disponibles

El servidor MCP de JustCall proporciona 66 herramientas organizadas en las siguientes categorías:

Herramientas de la API de JustCall

📞 Llamadas (6 herramientas)

  • list_calls - Lista todas las llamadas de JustCall con varias opciones de filtrado
  • get_call - Obtiene una llamada específica de JustCall por ID
  • update_call - Actualiza una llamada de JustCall (disposición, notas, calificación)
  • get_call_journey - Obtiene la secuencia de eventos de una llamada específica
  • get_voice_agent_data - Obtiene datos del agente de voz para una llamada específica (obsoleto, usa get_voice_agent_call)
  • get_voice_agent_call - Recupera datos relacionados con el agente de voz para una llamada específica

👥 Usuarios y Agentes (3 herramientas)

  • list_users - Lista todos los usuarios/agentes en la cuenta
  • get_user - Obtiene información detallada de un usuario/agente específico
  • update_user_availability - Actualiza el estado de disponibilidad de un usuario a disponible o no disponible para llamadas

💬 SMS y Mensajería (11 herramientas)

  • send_sms - Envía un SMS/mensaje de texto a un contacto
  • list_sms - Recupera todos los SMS/mensajes de texto
  • get_sms - Obtiene información detallada de un SMS/mensaje de texto específico
  • check_sms_reply - Verifica la respuesta SMS entrante más reciente de un contacto específico
  • list_sms_tags - Recupera todas las etiquetas SMS utilizadas para organizar mensajes de texto
  • get_sms_tag - Obtiene información detallada de una etiqueta SMS específica
  • create_sms_tag - Crea una nueva etiqueta para organizar conversaciones SMS
  • delete_sms_tag - Elimina una etiqueta SMS específica
  • list_sms_threads - Recupera todos los hilos/conversaciones SMS asociados con un número de JustCall
  • get_sms_thread - Recupera un hilo/conversación SMS específico por ID
  • add_sms_thread_tag - Agrega una etiqueta a un hilo/conversación SMS

📇 Contactos (6 herramientas)

  • list_contacts - Recupera todos los contactos del CRM
  • get_contact - Recupera información detallada de un contacto específico por ID
  • create_contact - Crea un nuevo contacto en el CRM
  • update_contact - Actualiza/modifica detalles de un contacto existente
  • update_contact_status - Agrega o elimina un contacto de las listas DND/DNM/Lista negra
  • add_contacts_blacklist - Agrega uno o más contactos a la lista negra global en masa

📊 Analíticas (4 herramientas)

  • get_agent_analytics - Recupera datos analíticos de agentes para un rango de fechas específico
  • get_account_analytics - Recupera datos analíticos de la cuenta para un rango de fechas específico
  • get_number_analytics - Recupera datos analíticos de números para un rango de fechas específico
  • get_sales_dialer_analytics - Recupera datos analíticos completos para campañas del marcador de ventas

🔔 Webhooks (2 herramientas)

  • list_webhooks - Recupera todos los webhooks configurados
  • create_webhook - Crea un nuevo endpoint de webhook para recibir notificaciones en tiempo real

📱 Números de Teléfono (2 herramientas)

  • list_numbers - Recupera todos los números de teléfono de JustCall
  • get_number - Recupera información detallada de un número de teléfono específico de JustCall

👥 Grupos de Usuarios (2 herramientas)

  • list_user_groups - Recupera todos los grupos de usuarios definidos en la cuenta
  • get_user_group - Recupera información detallada de un grupo de usuarios específico por ID

📅 Citas (3 herramientas)

  • list_appointment_slots - Recupera todos los espacios de tiempo disponibles para citas en un calendario específico
  • create_appointment - Programa una nueva cita en un calendario específico
  • get_appointment - Recupera detalles de una cita específica por su ID

💚 WhatsApp (5 herramientas)

  • list_whatsapp_messages - Recupera todos los mensajes de WhatsApp asociados con la cuenta
  • get_whatsapp_message - Recupera información detallada de un mensaje de WhatsApp específico por ID
  • send_whatsapp_message - Envía un nuevo mensaje de WhatsApp a un número de contacto
  • list_whatsapp_templates - Recupera todas las plantillas de mensajes de WhatsApp disponibles en la cuenta
  • check_whatsapp_message_reply - Verifica el mensaje entrante de WhatsApp más reciente de un contacto

🤖 Análisis de IA (4 herramientas)

  • list_calls_ai_analysis - Recupera análisis generados por IA (transcripción, resumen, información) para todas las llamadas
  • get_call_ai_analysis - Recupera análisis generados por IA para una llamada específica por ID de llamada
  • list_meetings_ai_analysis - Recupera análisis generados por IA para reuniones grabadas (Zoom, Google Meet)
  • get_meeting_ai_analysis - Recupera análisis generados por IA para una reunión específica por ID de instancia

🎙️ Agentes de Voz (2 herramientas)

  • list_voice_agents - Recupera todos los agentes de voz de IA asociados con la cuenta
  • create_voice_agent_call - Inicia una llamada saliente desde un agente de voz de IA configurado a un contacto

Herramientas del Marcador de Ventas

📢 Campañas (6 herramientas)

  • list_campaigns - Recupera todas las campañas del marcador de ventas
  • get_campaign - Recupera información detallada de una campaña específica del marcador de ventas
  • create_campaign - Crea una nueva campaña del marcador de ventas
  • update_campaign - Actualiza detalles de la campaña, incluidos nombre, descripción, estado y asignaciones
  • list_salesdialer_campaign_contacts - Recupera todos los contactos en una campaña específica
  • add_salesdialer_campaign_contact - Agrega un contacto a una campaña específica

👥 Contactos (8 herramientas)

  • list_salesdialer_contacts - Recupera todos los contactos del Marcador de Ventas
  • get_salesdialer_contact - Recupera información detallada de un contacto específico por ID
  • create_salesdialer_contact - Crea un nuevo contacto en el Marcador de Ventas
  • update_salesdialer_contact - Actualiza/modifica detalles de un contacto existente
  • import_salesdialer_contacts - Importa múltiples contactos al Marcador de Ventas o a una campaña en masa
  • import_salesdialer_contacts_status - Verifica el estado de un trabajo de importación masiva por ID de lote
  • add_salesdialer_contacts_dnca - Agrega uno o más contactos a la lista "No Volver a Llamar" en masa
  • list_salesdialer_custom_fields - Obtiene todos los campos personalizados de contactos definidos en el Marcador de Ventas

📞 Llamadas (2 herramientas)

  • list_salesdialer_calls - Recupera todas las llamadas realizadas a través del Marcador de Ventas
  • get_salesdialer_call - Recupera información detallada de una llamada específica del Marcador de Ventas por ID

📊 Analíticas (2 herramientas)

  • get_sales_dialer_analytics - Recupera datos analíticos completos para campañas del marcador de ventas
  • get_salesdialer_agent_analytics - Recupera analíticas de rendimiento de llamadas de un agente específico para una campaña.