Подключение Ringhum к Claude и другим ИИ-инструментам (MCP)

У Ringhum есть MCP-сервер. MCP (Model Context Protocol) — это стандартный способ для ИИ-приложений использовать внешние инструменты. Подключив Ringhum к ИИ-приложению, например Claude или ChatGPT, вы можете задавать ему вопросы о своём рабочем пространстве обычным языком. Например: «Подведи итог вчерашних пропущенных звонков», «Кто из звонящих на этой неделе просил перезвонить?» или «Добавь наши новые часы работы в частые вопросы». ИИ-приложение работает по тем же правилам и с теми же правами, что и API Ringhum.

Что вам понадобится

• URL сервера: https://ringhum.com/mcp. Он также указан в карточке MCP-сервер на странице Разработчикам с кнопкой Копировать.
• ИИ-приложение с поддержкой удалённых MCP-серверов, такое как Claude, ChatGPT, Claude Code, Cursor, Windsurf или VS Code.
• Роль владельца или администратора в рабочем пространстве. Подключать приложение или создавать API-ключ могут только владельцы и администраторы.

Есть два способа подключения. Вход в аккаунт — самый простой и подходит для чат-приложений, таких как Claude и ChatGPT. API-ключ подходит для инструментов разработчика, принимающих URL и заголовок.

Доступ только для чтения или для чтения и изменения

Вы выбираете, что может делать ИИ-приложение.

При доступе только для чтения инструменты для изменения данных приложению вообще не предоставляются.

Важно: При доступе с изменениями ИИ-приложение может отправлять настоящие сообщения и совершать настоящие звонки вашим клиентам. Ringhum помечает такие инструменты как выходящие за пределы вашего рабочего пространства, а удаления — как деструктивные, поэтому большинство ИИ-приложений спрашивают подтверждение перед их запуском. Прочитайте, что собирается сделать приложение, прежде чем одобрить действие.

Подключение Claude через вход в аккаунт

1. В Claude (в браузере, приложении для компьютера или мобильном) откройте Settings → Connectors и выберите Add custom connector.
2. Вставьте https://ringhum.com/mcp в качестве URL и сохраните.
3. Нажмите Connect. Откроется страница Ringhum. Войдите, если будет предложено.
4. На странице подключения выберите Рабочее пространство, которым может пользоваться приложение.
5. В разделе Что оно может делать выберите Только просмотр или Просмотр и изменения.
6. Нажмите Разрешить. Вы вернётесь в Claude.

Приложение никогда не видит ваш пароль. Точные названия пунктов меню в Claude со временем могут меняться; ищите коннекторы или интеграции в его настройках.

ChatGPT: добавьте URL как собственный коннектор (MCP-сервер) в Settings → Apps & Connectors, затем нажмите Connect и выполните шаги 3–6.

Claude Code: выполните команду ниже, затем запустите /mcp и выберите Authenticate.

claude mcp add --transport http ringhum https://ringhum.com/mcp

После того как вы разрешите доступ, подключение продлевается автоматически, пока вы им пользуетесь. Если приложение не используется 90 дней, его нужно будет подключить заново.

Подключение с помощью API-ключа

Используйте этот способ для инструментов, позволяющих задать заголовок запроса, либо если вы не хотите входить в аккаунт.

1. В разделе Разработчикам создайте API-ключ. Отметьте только read для доступа только на чтение или read и write, чтобы разрешить изменения. См. API-ключи и области доступа.
2. Добавьте сервер в своё приложение с ключом в заголовке Authorization.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf и Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Приложение, которое умеет запускать только локальные серверы, может подключиться через npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Что охватывают инструменты

Каждая операция API Ringhum доступна как инструмент: ваш аккаунт и использование, ассистенты, номера телефонов, звонки и транскрипты, контакты, записи на приём и доступность, заказы и товары, бронирования номеров, входящие, SMS- и WhatsApp-сообщения, кампании, вебхуки, профиль компании, услуги, частые вопросы и база знаний, вопросы без ответа, ссылки на оплату, запросы отзывов, доход и защита от спама. Единственное исключение — записи звонков: они недоступны как инструмент.

Каждый инструмент выполняет соответствующий запрос к API, поэтому действуют те же лимиты тарифа, проверки и ограничения частоты запросов. Вызовы инструментов учитываются в лимите API на 120 запросов в минуту. Полный список инструментов приведён в разделе MCP справочника API на /docs.

Просмотр и отключение подключённых приложений

Приложения, которые вы подключили через вход в аккаунт, перечислены на странице Разработчикам в разделе Подключённые ИИ-приложения, с указанием, кто их подключил, их Доступа (Только чтение или Чтение и изменение) и когда они использовались в последний раз.

Чтобы удалить приложение, нажмите Отключить и подтвердите действие. Оно немедленно теряет доступ, и его нужно будет одобрить заново. Чтобы изменить доступ приложения, отключите его и подключите снова с другим выбором.

Для подключения, сделанного с помощью API-ключа, отзовите ключ в разделе API-ключи.

Решение проблем

«Подключать приложения могут только владельцы и администраторы рабочего пространства». Попросите владельца рабочего пространства подключить приложение или сделать вас администратором. См. Приглашение команды.

«Срок запроса на вход истёк. Начните подключение заново из вашего ИИ-приложения». Страница подтверждения была открыта слишком долго. Начните заново из ИИ-приложения.

Приложение сообщает, что не авторизовано, или просит войти снова. Приложение было отключено, ключ был отозван, либо вы больше не участник рабочего пространства. Подключите его заново.

Приложение не может вносить изменения. Оно было подключено с доступом только для чтения, либо у его API-ключа нет области доступа write.

Приложение смотрит не в то рабочее пространство. Попросите его вызвать who_am_i, чтобы проверить. Каждое подключение использует одно рабочее пространство. Отключите его и подключите заново, чтобы выбрать другое.