ПІДКЛЮЧЕННЯ ШІ · MCP

Підключи свого ШІ-помічника.

Знаходь платежі, перевіряй баланси й створюй рахунки через власну інсталяцію Wholly Crypto.

Твій сервер. Один URL MCP.

Включено до мерчанта 5.0.0+. Без додаткового демона, середовища Node.js чи розміщеного реле. Використовуй налаштований домен API інсталяції, наприклад https://api.example.com/mcp.

Відкрий Налаштування → Доступ API. Створи окремі дані доступу й признач проєкти, потрібні помічнику. Почни лише з читання.
У Підключення ШІ · MCP, увімкни MCP. Обери дані доступу, вибери Лише читання і збережи.
Додай показаний URL до налаштувань віддаленого HTTP/MCP свого помічника.
Для OAuth увійди до панелі мерчанта. Перевір назву клієнта, адресу повернення й дозволи даних доступу, а потім схвали. Наявні Basic Auth і TOTP залишаються чинними.

{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Заміни приклад домену. Формати конфігурації залежать від клієнта; обери Streamable HTTP, не локальну команду чи застарілий URL SSE.

Запитуй про свої платежі.

«Покажи останні неоплачені рахунки мого магазину».
«Які активи може приймати цей магазин?»
«Перевір баланси гаманців і невдалі доставки вебхуків».
«Створи рахунок на 25 EUR для замовлення 1042». Потребує дозволу на створення рахунків.

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

Результати включають ID проєкту й магазину. Суми залишаються десятковими рядками. Кешовані курси й баланси зберігають інформацію про свіжість; конвертація не є гарантованим котируванням рахунку.

Обери, до чого має доступ помічник.

MCP вимкнено за замовчуванням, зокрема після оновлення. Наявні ключі API не отримують доступ автоматично. Помічник бачить лише схвалені проєкти; IP-обмеження й REST-ліміт даних доступу також діють для MCP.

Для створення рахунків обери дані доступу для читання/запису та Читання + створення рахунків. Клієнти OAuth мають запитати mcp:invoice:create, а ти маєш позначити Також дозволити створення рахунків під час схвалення.

Повторно використовуй той самий idempotency_key і тіло рахунку після перевищення часу. Новий ключ створює новий рахунок. Звичайні правила спреду, допуску, оплати й балансу залишаються чинними.

Без експорту ключів та інструментів надсилання грошей. MCP не може розкривати фрази відновлення, надсилати кошти, робити sweep або повернення, повторно надсилати зворотні виклики чи змінювати облікові записи, домени й розрахунки.

OAuth, bearer-ключі й відкликання

Токени доступу OAuth діють 15 хвилин. Токени оновлення ротуються, а підключення діє до 30 днів. Повторне використання старого токена оновлення відкликає підключення. Приймаються лише зареєстровані HTTPS- або loopback-URL повернення.

Використовуй Підключені клієнти → Відкликати , щоб видалити доступ. Вимкнення MCP відкликає OAuth-підключення. Ротація даних доступу, зміни політики MCP і канонічного домену API потребують нового підключення.

Клієнти з підтримкою власних заголовків можуть використовувати ключ API з увімкненим MCP у Authorization: Bearer …. Цей ключ зберігає окремі REST-дозволи, тому для доступу лише до MCP віддавай перевагу OAuth. Ніколи не вставляй секрети в чат, URL або вихідний код.

Схвалюй лише клієнта, якого впізнаєш. Назви клієнтів не перевіряються. Твій ШІ-провайдер отримує інформацію, яку ти дозволяєш читати, зокрема дані клієнтів, повернуті інструментами рахунків.

Якщо підключення не працює.

404: увімкни MCP і використовуй хост API, не хост панелі чи оплати.
401: підключися знову через OAuth або перевір чинність bearer-даних доступу.
403: перевір дозволи даних доступу, схвалені проєкти, origin та обмеження IP-джерела.
405 на GET: очікувано. Ця кінцева точка без стану використовує POST і скінченні JSON-відповіді без окремого потоку SSE.
429: дочекайся Retry-After. MCP і REST ділять квоту даних доступу.
Не вдається створити рахунки: перевір усі дозволи запису, стан проєкту/магазину, готовність платежів і перевірку рахунку для обробки.

Залиш кешування Cloudflare й інтерактивні перевірки вимкненими для /mcp, /mcp/oauth/* та шляхів виявлення OAuth. Списки дозволених IP мають включати задокументовані вихідні адреси сервісу помічника.

Підтримувані версії протоколу: 2025-11-25, 2025-06-18 і 2025-03-26. Клієнт має підтримувати одну з них. Переглянь Довідник API щодо кожного інструмента, кінцевої точки й формату помилки.

Обирай способи оплати для кожного рахунку.

Використовуй invoice.payment_methods з chain_slug: "ethereum" і asset_tickers: ["USDC", "USDT"]. Знайди slug і тикери в Способах оплати магазину або через list_payment_methods.

Мерчант 5.4.0+ ігнорує неактивні або неприйнятні варіанти. Якщо збігів немає, діють стандартні способи магазину. Вибір лише блокчейна включає всі активні прийнятні активи. Спільні тикери потребують точного asset_ids. Перевірки готовності й курсів залишаються чинними, з помилками для конкретних блокчейнів. Lightning окремий; порожній масив вибору недійсний. Формат запиту →