Настройка Discourse MCP в OpenAI Codex CLI

Вики Пользователи
, ,
1

Я экспериментировал с Discourse MCP, но обнаружил, что существующая документация на Meta по его использованию не содержит ничего для Codex CLI, и было немного запутанно разобраться, какие части документации применимы:

  • использовать npx или npm install?
  • какие части настройки относятся к Codex, а какие к Discourse MCP?
  • где размещать настройки вроде read_only: false?

Поэтому, после довольно долгого возни, вот проверенное руководство по установке Discourse MCP в Codex CLI. В ближайшие дни я дополню его руководством для Claude Code CLI и opencode. Если вы хотите использовать других клиентов MCP, дайте знать в комментариях, и я постараюсь помочь.

Редакция: 2026.03.13 - Я написал руководство для opencode, которое использует немного другой формат файла конфигурации для MCP, что может сбить с толку.

Требования:

  • Установлен Node.js (рекомендуется версия 24 LTS)
  • Установлен Codex CLI
  • Доступ к https://discourse.example.com как обычный пользователь

Важно понимать, что здесь есть три отдельных компонента:

  1. Удалённый форум Discourse — источник данных и цель для действий.

  1. Сервер Discourse MCP — это инструмент с открытым исходным кодом, запускаемый локально, который подключается к Discourse и предоставляет API для взаимодействия Codex с Discourse. Он устанавливается как STDIO-сервер и запускается по требованию Codex CLI.

  1. Codex CLI — клиент MCP, который подключается к серверу MCP и предоставляет интерфейс для взаимодействия с Discourse через API MCP.

1. Генерация ключа API пользователя

Это аутентифицирует вас на Discourse, и именно так вы получите свой ключ API. npx загрузит и выполнит код, установка в традиционном смысле не требуется.

В терминале выполните:

npx @discourse/mcp@latest generate-user-api-key \
  --site =DISCOURSE-FORUM= \
  --save-to =MCP-CONFIG=

Подтвердите согласие в браузере и скопируйте обратно зашифрованные данные, которые подтверждают вашу возможность входа и генерируют ключ API, сохраняемый в =MCP-CONFIG= для использования сервером MCP.

Ключ API будет иметь тот же уровень доступа к форуму, что и у вас как у пользователя.

2. Добавление сервера MCP в Codex CLI:

Запустите это в терминале (не внутри самого Codex CLI)

codex mcp add discourse \
  -- npx -y @discourse/mcp@latest \
  --profile =MCP-CONFIG=

Он устанавливается как STDIO-сервер, поэтому будет запускаться по требованию с помощью npx Codex CLI при запуске Codex CLI.

Он настроен на использование профиля по пути =MCP-CONFIG=, и по умолчанию доступен только для чтения.

3. Перезапуск Codex CLI

Полностью перезапустите Codex, чтобы он перезагрузил config.toml и профиль.

Если он запускается без ошибок, значит конфигурация корректна, и вы увидите сервер MCP в списке при выполнении команды /mcp в Codex CLI.

В Codex CLI вы можете попросить Codex обращаться к этому форуму Discourse за информацией — особенно за информацией, к которой у вас есть доступ, но которая не является публичной. Это подтвердит, что подключение осуществляется от вашего имени.

4. Включение функций записи (опционально)

По умолчанию сервер Discourse MCP работает в режиме только для чтения. Чтобы включить операции записи (создание постов, тем, пользователей и т.д.), необходимо добавить два флага в ваш файл профиля JSON.

Отредактируйте профиль Discourse по пути =MCP-CONFIG= и добавьте "read_only": false и "allow_writes": true как элементы на одном уровне с массивом auth_pairs:

{
  "read_only": false,
  "allow_writes": true,
  "auth_pairs": [
    {
      "site": "=DISCOURSE-FORUM=",
      "user_api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

Пример:

{
  "read_only": false,
  "allow_writes": true,
  "auth_pairs": [
    {
      "site": "https://meta.discourse.org",
      "user_api_key": "abc123def456ghi789jkl012mno345pqr",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

После добавления этих флагов перезапустите OpenCode CLI, чтобы изменения вступили в силу. Сервер MCP теперь позволит операции записи, такие как:

  • Создание и обновление тем
  • Создание постов и ответов
  • Управление черновиками
  • Загрузка файлов
  • Создание категорий (если у вас есть разрешение)
  • Управление пользователями (если у вас есть права администратора)

Предупреждение: Операции записи будут использовать разрешения вашей учётной записи пользователя. Любое созданное содержимое будет отображаться так, будто вы создали его вручную. Используйте функции записи ответственно.

Редактирование настроек

В какой-то момент вам может понадобиться изменить настройки, чтобы добавить возможность записи в Discourse, и это делается в настройках Discourse.

Путаница возникает из-за того, что настройки хранятся в двух местах, и между документацией Codex и документацией Discourse это действительно запутанно, особенно при определении, какие части относятся к Codex CLI, а какие — к самому STDIO-серверу MCP.

Есть два основных файла:

  1. =CODEX-CONFIG= — это файл конфигурации Codex CLI, который включает настройки сервера MCP.

  2. =MCP-CONFIG= — это профиль сервера Discourse MCP, который включает ключ API и другие настройки для подключения к Discourse.

Настройки Codex CLI

Настройки для подключения к MCP находятся в =CODEX-CONFIG= и должны выглядеть примерно так. Если вы хотите добавить опции для сервера MCP, добавьте их здесь.

# =CODEX-CONFIG=
[mcp_servers.discourse]
command = "npx"
args = ["-y", "@discourse/mcp@latest", "--profile", "=MCP-CONFIG="]

Документация по настройкам Codex MCP: Model Context Protocol – Codex | OpenAI Developers

Настройки Discourse MCP

Настройки самого сервера Discourse MCP находятся в =MCP-CONFIG=

# =MCP-CONFIG=
{
  "profiles": [
    {
      "site": "=DISCOURSE-FORUM=",
      "user_api_key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "user_api_client_id": "discourse-mcp"
    }
  ]
}

Справочник по настройкам Discourse MCP: GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub

4 лайка
Discourse MCP Setup in OpenCode CLI
Discourse MCP is here!