Підключіть 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 (у вебі, на десктопі чи мобільному) відкрийте Налаштування → Конектори й оберіть Додати власний конектор.
2. Вставте https://ringhum.com/mcp як URL-адресу й збережіть.
3. Натисніть Підключити. Відкриється сторінка Ringhum. Увійдіть, якщо буде запитано.
4. На сторінці Підключити оберіть Робочий простір, який може використовувати застосунок.
5. У розділі Що йому дозволено оберіть Шукати дані чи Шукати дані та вносити зміни.
6. Натисніть Дозволити. Вас поверне назад у Claude.

Застосунок ніколи не бачить ваш пароль. Точні назви меню в Claude можуть з часом змінюватися; шукайте конектори чи інтеграції в його налаштуваннях.

ChatGPT: додайте URL-адресу як власний конектор (сервер MCP) у Налаштування → Застосунки й конектори, потім натисніть Підключити й дотримуйтеся кроків 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 доступна як інструмент: ваш обліковий запис і використання, асистенти, номери телефонів, дзвінки й розшифрування, контакти, записи на прийом і доступність, замовлення й товари, бронювання номерів, скринька вхідних, текстові повідомлення й WhatsApp, кампанії, вебхуки, профіль компанії, послуги, поширені запитання й база знань, запитання без відповіді, платіжні посилання, запити на відгук, дохід і захист від спаму. Записи дзвінків — єдиний виняток: вони недоступні як інструмент.

Кожен інструмент виконує відповідний запит API, тож застосовуються ті самі ліміти тарифу, перевірки та обмеження швидкості. Виклики інструментів враховуються в ліміт API у 120 запитів на хвилину. Повний список інструментів — у розділі MCP довідника API на /docs.

Перегляньте й відключіть підключені застосунки

Застосунки, підключені через вхід, перелічені на сторінці Розробники в розділі Підключені ШІ-застосунки, із зазначенням, хто їх підключив, їхнього Доступу (Лише читання чи Читання й зміна) і коли їх востаннє використовували.

Щоб видалити застосунок, натисніть Відключити й підтвердьте. Він одразу втрачає доступ, і його потрібно схвалювати знову. Щоб змінити доступ застосунку, відключіть його й підключіть знову з іншим вибором.

Для з'єднання, зробленого за допомогою ключа API, відкличте ключ у розділі Ключі API.

Усунення несправностей

"Лише власники й адміністратори робочого простору можуть підключати застосунки." Попросіть власника робочого простору підключити застосунок, чи зробити вас Адміністратором. Див. Запросіть свою команду.

"Термін дії запиту на вхід минув. Почніть підключення знову зі свого ШІ-застосунку." Сторінка схвалення була відкрита занадто довго. Почніть знову зі ШІ-застосунку.

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

Застосунок не може вносити зміни. Він був підключений з доступом лише для читання, або його ключ API не має області write.

Застосунок дивиться на неправильний робочий простір. Попросіть його викликати who_am_i, щоб перевірити. Кожне з'єднання використовує один робочий простір. Відключіть його й підключіть знову, щоб обрати інший.