title: Discord Web status: experimental version: 0.3.5 updated: 2026-09-20 tags: [discord, mcp, chrome-extension]

Discord Web

Локальный мост: агент пишет и читает открытую вкладку Discord Web от вашего аккаунта. Без бота, без user token и без discord.com/api.

Расширение Chrome (MV3, unpacked) кликает DOM. HTTP-мост слушает только 127.0.0.1. MCP отдаёт инструменты агенту.

Related MCP server: discord-mcp-server

Что умеет

Чтение — любой канал сервера в открытой вкладке. Запись — только URL из списка в настройках расширения.

Личные сообщения (@me) не поддерживаются.

Схема

flowchart LR
  A[агент] -->|MCP stdio| B[server/mcp.js]
  B -->|HTTP 127.0.0.1| C[server/bridge.js]
  D[расширение] -->|long-poll| C
  D --> E[вкладка discord.com]

discord-web/
├── README.md
├── LIVE-CHECK.md
├── mcp-config.example.json
├── server/                 # мост + MCP
├── extension/              # Chrome MV3, Load unpacked
├── tests/
└── bin/chrome-with-extension.sh

Требования

• Node.js 22+

• Google Chrome

• Открытая вкладка discord.com / ptb / canary, вход вы делаете сами

Установка

1. Клонируйте репозиторий и поставьте зависимости:

git clone https://github.com/VKirill/discord-web.git
cd discord-web
npm install

2. Запустите мост: npm start. При первом запуске появятся .local/bridge.json и extension/local-config.js. В лог идёт только 127.0.0.1:порт, не ключ.

3. Chrome → chrome://extensions → Developer mode → Load unpacked → папка extension/.

4. После первого запуска моста нажмите Reload у расширения, чтобы подтянуть local-config.js.

5. В Chrome Web Store ничего публиковать не нужно.

Порт: DISCORD_WEB_BRIDGE_PORT или поле в .local/bridge.json. Слушает только 127.0.0.1.

Discord и вход

1. В том же профиле Chrome откройте Discord.

2. Войдите сами: логин, капча и 2FA расширение не заполняет.

3. Откройте канал или тред сервера.

4. Нет вкладки Discord — tab_not_open. Расширение вкладку само не создаёт.

Список каналов на запись

1. Откройте настройки расширения.

2. Вставьте URL https://discord.com/channels/<guildId>/<channelId>.

3. Пустой список блокирует только отправку (channel_not_allowed). Читать можно без списка.

4. Список хранится в chrome.storage.local этого браузера.

MCP

Образец: mcp-config.example.json. cwd — корень клона, команда node server/mcp.js (или npm run mcp). Мост уже должен работать.

{
  "mcpServers": {
    "discord-web": {
      "command": "node",
      "args": ["server/mcp.js"],
      "cwd": "."
    }
  }
}

Проверка без отправки:

{
  "name": "discord_status",
  "arguments": {
    "url": "https://discord.com/channels/123456789012345678/987654321098765432"
  }
}

Отправка, ответ, реакция, GIF — только канал из allowlist:

{"name": "discord_send_message", "arguments": {"url": "https://discord.com/channels/…/…", "text": "тест из локального моста"}}
{"name": "discord_send_message", "arguments": {"url": "https://discord.com/channels/…/…", "text": "ответ", "replyTo": "111222333444555666"}}
{"name": "discord_add_reaction", "arguments": {"url": "https://discord.com/channels/…/…", "messageId": "111222333444555666", "emoji": "👍"}}
{"name": "discord_send_gif", "arguments": {"url": "https://discord.com/channels/…/…", "query": "cat"}}

Либо guildId + channelId. Для треда передайте threadId вместо channelId.

Перезагрузка unpacked-расширения (подхватывает файлы с диска):

{"name": "discord_reload_extension", "arguments": {"extension": true, "bridge": false}}

bridge: true перезапускает LaunchAgent, если вы его ставили сами.

Чтение ленты (DOM вкладки, не архив Discord):

{"name": "discord_list_guilds", "arguments": {}}
{"name": "discord_list_channels", "arguments": {"url": "https://discord.com/channels/…/…"}}
{"name": "discord_list_threads", "arguments": {"url": "https://discord.com/channels/…/…"}}
{"name": "discord_allowlist_add", "arguments": {"url": "https://discord.com/channels/…/…"}}
{"name": "discord_read_messages", "arguments": {"url": "https://discord.com/channels/…/…", "limit": 50, "after": "2026-09-01", "before": "2026-09-21", "scroll": true}}
{"name": "discord_collect_content", "arguments": {"url": "https://discord.com/channels/…/…", "scope": "visible", "includeThreads": true, "limit": 20, "maxChannels": 8, "maxThreads": 4}}

discord_read_messages возвращает author, text, timestamp (ISO), day. Дата в after / before режет уже загруженные сообщения. Если Discord не дорисовал историю в вкладке, мост её не достанет.

discord_collect_content обходит текстовые и форумные каналы сайдбара и треды. scope: visible — любой канал сервера; scope: allowlist — только список отправки. Лимит: до 12 каналов и 8 тредов на канал. Отправку не делает.

Ошибки

Нельзя

• Discord Bot Token, user token, cookies и discord.com/api/*

• Сторонние discord-mcp и публикация этого расширения в Chrome Web Store

• Чтение storage Discord, заголовка Authorization, webpack-модулей страницы

• Открывать вкладку за пользователя, проходить логин, капчу и 2FA

• Личные сообщения и рассылки

• Чужой аккаунт

Безопасность

• Ключ моста (≥32 байт hex) — в .local/bridge.json и extension/local-config.js. Оба в .gitignore. Значение не пишите в чаты и логи.

• Кроме GET /v1/health нужен заголовок x-bridge-key (timingSafeEqual). Неверный ключ → 401.

• Origin не из chrome-extension:// → 403.

• Пароль Discord, cookies и токены сессии компонент не хранит и не запрашивает.

Восстановление

1. Остановите node server/bridge.js.

2. Удалите .local/bridge.json и extension/local-config.js.

3. Снова npm start — ключ и порт создадутся заново.

4. Reload unpacked-расширения.

5. Список каналов в Chrome от удаления ключа не сбрасывается.

Ограничения

Селекторы Discord Web ([role="textbox"][data-slate-editor="true"], [data-list-id="chat-messages"], пикер GIF) могут смениться без предупреждения. Тогда будет composer_not_found, send_not_confirmed или gif_not_found. Диагностика: discord_status и LIVE-CHECK.md.

discord_read_messages не отдаёт вложения: у GIF в ленте часто пустой text.

Проверка

npm test

Проходят tests/server, tests/extension и tests/e2e (успех send_message и ошибки tab_not_open, not_logged_in, composer_not_found, extension_not_connected через настоящий мост и MCP stdio).

Живая отправка — только вами, по LIVE-CHECK.md.

Лицензия

MIT. См. LICENSE.