MCP-сервер: управляйте Discord-сервером из ИИ-ассистентов

Подключение клиента

Адрес сервера — https://console.botgg.app/mcp (MCP через Streamable HTTP). Клиенты входят одним из двух способов:

• Вход через Discord (OAuth) — рекомендуется. Клиенту нужен только адрес. Он откроет BotGG в браузере, вы войдёте через Discord, выберете один сервер и разрешения и подтвердите. Ничего копировать не нужно, а отключить приложение можно в любой момент.
• API-ключ. Для клиентов без OAuth: создайте ключ в консоли (см. авторизацию) и передавайте его как Authorization: Bearer botgg_….

Claude (claude.ai и Claude Desktop)

1. Откройте Settings → Connectors и выберите Add custom connector.
2. Назовите его BotGG, вставьте адрес https://console.botgg.app/mcp и нажмите Add.
3. Нажмите Connect: откроется BotGG, войдите через Discord и подтвердите (см. экран согласия).

ChatGPT

1. Откройте Settings → Apps & Connectors. Для своих коннекторов нужен Developer mode (в Advanced settings) на вашем тарифе.
2. Выберите Create, назовите коннектор BotGG, вставьте https://console.botgg.app/mcp как адрес MCP-сервера и выберите аутентификацию OAuth.
3. Создайте коннектор и войдите, когда ChatGPT откроет BotGG.

Cursor

Добавьте сервер в ~/.cursor/mcp.json (или в .cursor/mcp.json проекта). Рядом с ним Cursor покажет Needs login — нажмите, чтобы войти через Discord в браузере.

{
  "mcpServers": {
    "botgg": { "url": "https://console.botgg.app/mcp" }
  }
}

Claude Code

claude mcp add --transport http botgg https://console.botgg.app/mcp
# then run /mcp inside Claude Code and choose "Authenticate"

Любой клиент с API-ключом

{
  "mcpServers": {
    "botgg": {
      "type": "http",
      "url": "https://console.botgg.app/mcp",
      "headers": { "Authorization": "Bearer botgg_…" }
    }
  }
}

Экран согласия

Когда клиент входит, BotGG показывает, кто запрашивает доступ и куда вы вернётесь после ответа. Приложения регистрируются сами, поэтому их название не проверено — одобряйте только подключение, которое начали вы.

1. Войдите через Discord (если вы ещё не вошли в консоль).
2. Выберите один сервер. Показаны серверы, где у вас есть право «Управлять сервером»; на выбранном должен быть BotGG. Подключение всегда относится ровно к одному серверу.
3. Выберите разрешения. Это те же права, что и у API-ключей. Чувствительные (действия над участниками, данные модерации) по умолчанию не отмечены; для их выбора нужно дополнительное подтверждение.
4. Разрешите или отклоните. Приложение получает короткоживущий токен доступа (1 час) и токен обновления, который меняется при каждом использовании.

Каждое подключение видно в консоли в разделе Сервер → Подключённые приложения: права, кто подключил и когда приложение последний раз использовалось. Любой администратор сервера может отключить его там — доступ пропадает сразу. Если человек, подключивший приложение, теряет право «Управлять сервером», доступ прекращается автоматически при следующем вызове.

Инструменты

На каждый эндпоинт REST API приходится один инструмент — например, bank.getBalance становится инструментом bank_get_balance. Входные данные — поля пути, запроса и тела эндпоинта; ID сервера не передаётся, он берётся из подключения. Список инструментов всегда совпадает со справочником API, а клиент видит только инструменты, право на которые есть у его подключения.

• Инструменты только для чтения помечены соответственно; инструменты, которые меняют или удаляют данные, помечены как деструктивные, и ассистенту предписано сначала подтвердить точное действие у вас.
• Каждый вызов проходит тот же путь, что и запрос к REST API: проверки прав и модуля, валидацию, коды ошибок и лимит запросов тарифа для подключения (у API-ключа один общий лимит на REST и MCP).
• Ошибки возвращаются как результат инструмента с теми же кодами error, что и в REST API, поэтому ассистент может их объяснить или исправить.
• Изменения через MCP записываются в журнал аудита сервера с названием приложения.

Ограничения

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

• Подтверждение деструктивных действий запрашивает ваше ИИ-приложение на основе пометок инструментов — BotGG не видит ваш чат. Не отключайте подтверждения в клиенте.
• Запись через MCP не использует Idempotency-Key, поэтому ассистенту не стоит вслепую повторять неудавшуюся запись — сначала проверьте результат. Для автоматических записей с повторами используйте REST API.
• Токены привязаны к этому адресу и к одному Discord-серверу; BotGG хранит только их хеши. Повторно использованный токен обновления из предосторожности отключает приложение — просто подключите его снова.

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

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://console.botgg.app/.well-known/oauth-protected-resource/mcp"

HTTP/1.1 403 Forbidden
WWW-Authenticate: Bearer resource_metadata="…", error="insufficient_scope", scope="bank:write"