Перейти до основного вмісту
Discord Agent Proxy — це сервіс з окремим розгортанням: він зберігає облікові дані вашого власного Discord-акаунта, підтримує постійне з’єднання з Discord і відкриває можливості цього акаунта через два інтерфейси — MCP та REST API, дозволяючи ШІ або програмам керувати Discord замість вас. Контейнер не містить жодної ШІ-моделі, він відповідає лише за виконання — виклики здійснюються вашим ШІ-клієнтом (Claude, Cursor тощо) або власною програмою.

⚠️ Обов’язково прочитайте перед використанням

Автоматизація операцій з особистим акаунтом (self-bot) за допомогою програм порушує Умови надання послуг Discord, і існує ризик блокування акаунта. Це є невід’ємною передумовою цього сервісу: ви надаєте облікові дані власного акаунта та самостійно берете на себе ризики. Наполегливо рекомендується використовувати спеціально створений додатковий акаунт, а не ваш основний акаунт.

Розгортання сервісу

Перейдіть до Консоль → Застосунки, знайдіть Discord Agent Proxy та створіть застосунок. Після створення спочатку активуйте підписку, а потім перейдіть на сторінку конфігурації, введіть облікові дані вашого Discord-акаунта та виконайте розгортання. Ресурси інстансу автоматично налаштовуються платформою, вибирати конфігурацію не потрібно. Після надсилання розгортання ви перейдете на сторінку керування застосунком із таким самим макетом «Огляд / Журнали / Документація», як для розгортання Telegram і WeChat. «Огляд» відображає стан інстансу та підписки, а також підтверджує, чи підключено Discord, через запит до акаунта; нормальна робота контейнера не обов’язково означає, що акаунт підключений. Картка Discord-акаунта в «Огляді» надає два пункти інформації для підключення:

Перегляд і тестування інтерфейсів у консолі

Відкрийте вкладку «Документація» цього застосунку, щоб переглянути параметри запитів, структури відповідей для всіх 14 REST-операцій, а також приклади для Shell, Python, JavaScript та інших мов. Адреса інстансу й токен доступу буде заповнено автоматично; токен за замовчуванням приховано. Виберіть GET /api/whoami і натисніть «Тест», щоб підтвердити акаунт, підключений проксі. Операції надсилання, редагування або видалення повідомлень впливають на реальний Discord-акаунт, тому перед тестуванням підтвердьте вміст запиту. «Завантажити OpenAPI (JSON)» дозволяє експортувати повне визначення інтерфейсу. Файл містить адресу інстансу, але не містить токена доступу. Якщо потрібно змінити облікові дані Discord-акаунта, виберіть «Повторне розгортання» в «Огляді», введіть нові облікові дані та надішліть їх.

Як отримати облікові дані Discord-акаунта

  1. Увійдіть у Discord у браузері на комп’ютері (discord.com/app)
  2. Натисніть F12, щоб відкрити інструменти розробника, і перейдіть на панель Network (Мережа)
  3. Довільно натисніть будь-який канал у Discord і перегляньте список запитів
  4. Відкрийте будь-який запит, надісланий до discord.com/api, і знайдіть поле authorization у Request Headers (Заголовки запиту)
  5. Скопіюйте його значення
Цей рядок облікових даних еквівалентний стану входу у ваш акаунт, не діліться ним ні з ким. Якщо він витече, зміна пароля в Discord негайно зробить його недійсним.

Спосіб автентифікації

Усі інтерфейси, крім /health і /readyz, вимагають передавання токена доступу в заголовку запиту:
Увага: цей сервіс приймає автентифікацію лише через заголовок запиту та не підтримує спосіб додавання токена після URL, як-от ?token=xxx. Безпосереднє відкриття адреси інтерфейсу в браузері поверне 401 unauthorized, це нормальне явище й не означає збою розгортання. Щоб підтвердити, що процес активний, перейдіть до /health; щоб підтвердити, що Discord-з’єднання здатне обробляти запити, перейдіть до /readyz. Обидві ці перевірки не потребують автентифікації. Якщо токен доступу проксі не налаштовано, захищені інтерфейси повертають 503 і не відкриваються анонімно.

Перевірка стану сервісу

/health лише означає, що HTTP-процес активний:
/readyz означає, чи доступний Discord Gateway. За нормального з’єднання повертається HTTP 200:
Під час з’єднання, за недійсних облікових даних або розриву з’єднання пряме зондування Pod з боку Kubernetes повертає HTTP 503, а бекенд інстансу автоматично повторює спробу. У цей час Pod тимчасово вилучається з публічного Service, тому не гарантується можливість прочитати цей діагностичний JSON через доменне ім’я інстансу; перегляньте стан Deployment у консолі та викликайте MCP / REST після відновлення Ready.

Використання в ШІ-клієнті (MCP)

На прикладі Claude Code:
Для клієнтів на кшталт Cursor, які підтримують статичні заголовки запитів, налаштуйте адресу Streamable HTTP відповідно до їхньої поточної документації. Клієнти, що приймають наведену нижче структуру, можуть використовувати її:
Це не універсальний формат конфігурації для всіх MCP-клієнтів. Віддалений конектор Claude Desktop / Claude.ai встановлюється з хмари й не зчитує жодних HTTP-заголовків запиту з локального claude_desktop_config.json; якщо наразі потрібен статичний Bearer-заголовок, використовуйте Claude Code або клієнт, який явно підтримує цю можливість. Після завершення налаштування можна безпосередньо керувати Discord через ШІ природною мовою, наприклад:
Перевір, чи є нові повідомлення в моєму каналі «Обговорення проєкту», і якщо хтось запитував про дату випуску, допоможи мені відповісти, що це буде цієї п’ятниці.

Доступні інструменти

Використання в програмі (REST API)

Усі REST-інтерфейси розміщені під /api, тіло відповіді уніфіковано як {"data": ...}, а у разі помилки — {"error": "..."}.

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

Надсилання повідомлення

Під час повторної спроби того самого надсилання повторно використовуйте той самий Idempotency-Key, процес поверне перший результат без повторного надсилання. Перезапуск екземпляра очистить до 5 000 записів дедуплікації в пам’яті, тому викликачеві все одно потрібно самостійно відстежувати довгостроковий статус доставки. Необов’язковий параметр reply_to використовується для відповіді на вказане повідомлення:

Читання повідомлень

Повний список інтерфейсів

Як отримати ID каналу та ID користувача

У клієнті Discord послідовно відкрийте Налаштування користувача → Розширені налаштування, увімкніть Режим розробника. Після цього клацніть правою кнопкою миші на будь-якому каналі або користувачі — у меню з’явиться «Копіювати ID». Також можна безпосередньо викликати GET /api/guilds і GET /api/guilds/{guild_id}/channels для переліку.

Поширені запитання

Повертається 401 unauthorized Токен доступу неправильний або його передано способом ?token=. Переконайтеся, що токен передається через заголовок запиту Authorization: Bearer <令牌> і збігається з тим, що відображається в консолі. Повертається 503 З’єднання з Discord ще не встановлено. Спершу перейдіть до /readyz, щоб переглянути gateway_ready. Якщо протягом тривалого часу відображається false, імовірно, облікові дані акаунта стали недійсними — отримайте їх повторно та виконайте повторне розгортання. Повертається 403 або 404 Сам акаунт не має відповідних дозволів (наприклад, він не перебуває на цьому сервері або не має права писати в цьому каналі), або ID вказано неправильно. Такі помилки надходять від Discord, а не від проксі-сервісу. Повертається 429 Спрацювало обмеження частоти Discord. Поле retry_after у відповіді містить рекомендовану кількість секунд очікування. Зменште частоту викликів. Обліковий запис заблоковано після надсилання повідомлення Як зазначалося раніше, автоматизація операцій з особистим обліковим записом порушує Умови використання Discord. Використовуйте окремий додатковий обліковий запис і контролюйте частоту операцій, уникаючи масового розсилання та інших чутливих дій.