API VEGA

JustCall MCP Server

Сервер JustCall Model Context Protocol (MCP) позволяет Large Language Models (LLMs) и ИИ-агентам осуществлять реальные голосовые звонки и отправлять SMS напрямую через API JustCall — безопасно, с учетом контекста и программно.

Он предоставляет интерфейс вызова функций для систем разговорного ИИ, позволяя:

  • 📞 Звонки с поддержкой ИИ: позвольте вашему LLM инициировать, управлять или расшифровывать звонки с использованием JustCall.
  • 💬 Умная отправка SMS: позвольте вашему ИИ-агенту отправлять и отвечать на SMS в рамках диалогов.
  • ⚙️ Бесшовная интеграция: используйте стандарт MCP для подключения возможностей телефонии JustCall к любому рантайму LLM или оркестрационной системе.

Короче говоря: он дает вашим LLM голос и номер телефона — превращая чат-ботов в по-настоящему разговорных агентов.

Claude Desktop Setup

  • Откройте Claude Desktop и нажмите CMD + , чтобы перейти в Settings.

  • Перейдите на вкладку Connectors.

  • Нажмите кнопку Add Custom Connector.

  • Укажите имя как JustCall и Remote Server Url как https://mcp.justcall.host/mcp.

  • Теперь в списке Connectors выберите JustCall и нажмите кнопку Connect.

  • Откроется страница JustCall, запрашивающая API key и secret.

  • Получите свой API Key и Secret в панели управления JustCall (URL: https://app.justcall.io/app/developersApiCredentials).

  • Введите API key и Secret и нажмите Continue, должно произойти перенаправление обратно в Claude.

Claude Web - https://claude.ai

  • Откройте в браузере URL для подключений — https://claude.ai/settings/connectors.

  • Перейдите на вкладку Connectors.

  • Нажмите кнопку Add Custom Connector.

  • Укажите имя как JustCall и Remote Server Url как https://mcp.justcall.host/mcp.

  • Теперь в списке Connectors выберите JustCall и нажмите кнопку Connect.

  • Откроется страница JustCall, запрашивающая API key и secret.

  • Получите свой API Key и Secret в панели управления JustCall (URL: https://app.justcall.io/app/developersApiCredentials).

  • Введите API key и Secret и нажмите Continue, должно произойти перенаправление обратно в Claude.

Chat GPT (Only available on Plus, Pro, Business and Enterprise)

  • Откройте в браузере URL подключений: https://chatgpt.com/#settings/Connectors.

  • Перейдите на вкладку Apps & Connectors.

  • Убедитесь, что режим разработчика включен в расширенных настройках.

  • Нажмите кнопку Create.

  • Укажите имя как JustCall и MCP Server Url как https://mcp.justcall.host/mcp. Остальные поля можно пропустить.

  • Теперь в списке Connectors выберите JustCall и нажмите кнопку Connect.

  • Откроется страница JustCall, запрашивающая API key и secret.

  • Получите свой API Key и Secret в панели управления JustCall (URL: https://app.justcall.io/app/developersApiCredentials).

  • Введите API key и Secret и нажмите Continue, после чего вы будете перенаправлены обратно в Chat GPT.

Remote MCP

Чтобы подключиться к MCP-серверу JustCall удаленно:

Streamable HTTP (рекомендуется)

Основной и рекомендуемый способ подключения — через Streamable HTTP Transport:

  • Подключайтесь к https://mcp.justcall.host/mcp из любого MCP-клиента с использованием Streamable HTTP Transport

  • Включите ваш JustCall API key в качестве Bearer-токена в заголовках запроса

  • Пример заголовка: Authorization: Bearer <JUSTCALL_API_KEY>:<JUSTCALL_API_SECRET>

Authentication & Security

Сервер JustCall MCP реализует аутентификацию OAuth2 для безопасного доступа ко всем конечным точкам.

Настройка OAuth2

Сервер поддерживает аутентификацию OAuth2 со следующими возможностями:

  • Authorization Endpoint: метаданные сервера авторизации OAuth2 доступны по /.well-known/oauth-authorization-server

  • Grant Type: Authorization code flow with PKCE (Proof Key for Code Exchange)

  • Code Challenge Method: S256 (SHA-256)

  • Token Authentication: Все MCP и SSE конечные точки требуют аутентификацию Bearer token

Защищённые конечные точки

Следующие конечные точки требуют действительного Bearer-токена:

  • /mcp - Основной MCP-эндпойнт

  • /sse - Эндпойнт Server-Sent Events

  • /sse/message - Эндпойнт SSE-сообщений

Формат заголовка аутентификации

Укажите ваши учетные данные API JustCall в виде Bearer-токена:

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


### Публичные конечные точки

Следующие конечные точки доступны без аутентификации:

- `/health` — эндпойнт проверки состояния (возвращает 200 OK)

- `/.well-known/oauth-authorization-server` — метаданные сервера авторизации OAuth2

### Использование API и ограничения по скорости

Этот MCP-сервер использует JustCall Developer API. Все API-запросы подлежат ограничениям по скорости, привязанным к вашему ключу JustCall API. Обратитесь к вашей конфигурации учетных данных JustCall API: [JustCall API credentials configuration](https://app.justcall.io/app/developersApiCredentials).

## Available Tools

JustCall MCP Server предоставляет 66 инструментов, сгруппированных в следующие категории:

### JustCall API Tools

#### 📞 Calls (6 tools)

- **list_calls** — перечисляет все звонки JustCall с различными опциями фильтрации
- **get_call** — получить конкретный звонок JustCall по ID
- **update_call** — обновить звонок JustCall (disposition, notes, rating)
- **get_call_journey** — получить последовательность событий для конкретного звонка
- **get_voice_agent_data** — получить данные голосового агента для конкретного звонка (устаревшее, используйте get_voice_agent_call)
- **get_voice_agent_call** — получить данные, связанные с голосовым агентом, для конкретного звонка

#### 👥 Users & Agents (3 tools)

- **list_users** — перечислить всех пользователей/агентов в аккаунте
- **get_user** — получить детальную информацию для конкретного пользователя/агента
- **update_user_availability** — обновить статус доступности пользователя для звонков (доступен/недоступен)

#### 💬 SMS & Messaging (11 tools)

- **send_sms** — отправить SMS/текстовое сообщение контакту
- **list_sms** — получить все SMS/текстовые сообщения
- **get_sms** — получить детальную информацию о конкретном SMS/текстовом сообщении
- **check_sms_reply** — проверить последний входящий ответ SMS от конкретного контакта
- **list_sms_tags** — получить все теги SMS, используемые для организации текстовых сообщений
- **get_sms_tag** — получить детальную информацию о конкретном теге SMS
- **create_sms_tag** — создать новый тег для организации SMS-диалогов
- **delete_sms_tag** — удалить конкретный тег SMS
- **list_sms_threads** — получить все SMS-ветки/диалоги, связанные с номером JustCall
- **get_sms_thread** — получить конкретную SMS-ветку/диалог по ID
- **add_sms_thread_tag** — добавить тег к SMS-ветке/диалогу

#### 📇 Contacts (6 tools)

- **list_contacts** — получить все контакты из CRM
- **get_contact** — получить детальную информацию о конкретном контакте по ID
- **create_contact** — создать новый контакт в CRM
- **update_contact** — обновить/изменить детали существующего контакта
- **update_contact_status** — добавить или удалить контакт из списков DND/DNM/Blacklist
- **add_contacts_blacklist** — пакетно добавить один или несколько контактов в глобальный blacklist

#### 📊 Analytics (4 tools)

- **get_agent_analytics** — получить данные аналитики агентов за указанный диапазон дат
- **get_account_analytics** — получить данные аналитики аккаунта за указанный диапазон дат
- **get_number_analytics** — получить данные аналитики номеров за указанный диапазон дат
- **get_sales_dialer_analytics** — получить исчерпывающие данные аналитики по кампаниям Sales Dialer

#### 🔔 Webhooks (2 tools)

- **list_webhooks** — получить все настроенные вебхуки
- **create_webhook** — создать новый webhook-эндпойнт для получения уведомлений в реальном времени

#### 📱 Phone Numbers (2 tools)

- **list_numbers** — получить все номера JustCall
- **get_number** — получить детальную информацию о конкретном номеров JustCall

#### 👥 User Groups (2 tools)

- **list_user_groups** — получить все группы пользователей, определенные в аккаунте
- **get_user_group** — получить детальную информацию о конкретной группе пользователей по ID

#### 📅 Appointments (3 tools)

- **list_appointment_slots** — получить все доступные слоты времени для встреч в конкретном календаре
- **create_appointment** — запланировать новую встречу в конкретном календаре
- **get_appointment** — получить детали конкретной встречи по её ID

#### 💚 WhatsApp (5 tools)

- **list_whatsapp_messages** — получить все сообщения WhatsApp, связанные с аккаунтом
- **get_whatsapp_message** — получить детальную информацию о конкретном сообщении WhatsApp по ID
- **send_whatsapp_message** — отправить новое сообщение WhatsApp контакту
- **list_whatsapp_templates** — получить все шаблоны сообщений WhatsApp, доступные в аккаунте
- **check_whatsapp_message_reply** — проверить последнее входящее сообщение WhatsApp от контакта

#### 🤖 AI Analysis (4 tools)

- **list_calls_ai_analysis** — получить AI-генерированную аналитику (транскрипцию, резюме, инсайты) по всем звонкам
- **get_call_ai_analysis** — получить AI-генерированный анализ для конкретного звонка по ID
- **list_meetings_ai_analysis** — получить AI-генерированную аналитику по записанным встречам (Zoom, Google Meet)
- **get_meeting_ai_analysis** — получить AI-генерированный анализ для конкретной встречи по ID

#### 🎙️ Voice Agents (2 tools)

- **list_voice_agents** — получить все AI-голосовые агенты, связанные с аккаунтом
- **create_voice_agent_call** — инициировать исходящий звонок от сконфигурированного AI-голосового агента к контакту

### Sales Dialer Tools

#### 📢 Campaigns (6 tools)

- **list_campaigns** — получить все кампании Sales Dialer
- **get_campaign** — получить детальную информацию о конкретной кампании Sales Dialer
- **create_campaign** — создать новую кампанию Sales Dialer
- **update_campaign** — обновить детали кампании: имя, описание, статус и назначения
- **list_salesdialer_campaign_contacts** — получить всех контактов в конкретной кампании
- **add_salesdialer_campaign_contact** — добавить контакт в конкретную кампанию

#### 👥 Contacts (8 tools)

- **list_salesdialer_contacts** — получить все контакты из Sales Dialer
- **get_salesdialer_contact** — получить детальную информацию о конкретном контакте по ID
- **create_salesdialer_contact** — создать новый контакт в Sales Dialer
- **update_salesdialer_contact** — обновить/изменить данные существующего контакта
- **import_salesdialer_contacts** — импортировать несколько контактов в Sales Dialer или кампанию пакетно
- **import_salesdialer_contacts_status** — проверить статус пакетной загрузки импорта по batch ID
- **add_salesdialer_contacts_dnca** — добавить один или несколько контактов в список Do Not Call Again пакетно
- **list_salesdialer_custom_fields** — получить все настраиваемые поля контактов, определённые в Sales Dialer

#### 📞 Calls (2 tools)

- **list_salesdialer_calls** — получить все звонки, сделанные через Sales Dialer
- **get_salesdialer_call** — получить детальную информацию о конкретном звонке Sales Dialer по ID

#### 📊 Analytics (2 tools)

- **get_sales_dialer_analytics** — получить исчерпывающие данные аналитики по кампаниям Sales Dialer
- **get_salesdialer_agent_analytics** — получить аналитику эффективности звонков конкретного агента по кампании