Configuración de Discourse MCP en la CLI de OpenAI Codex

pacharanero · 4 Marzo, 2026 21:49

He estado experimentando con Discourse MCP, pero descubrí que la documentación existente en Meta sobre su uso no incluía nada para Codex CLI, y fue un poco confuso descubrir qué partes de la documentación se aplicarían:

¿es npx o npm install?
¿Qué partes de la configuración son de Codex y cuáles son de Discourse MCP?
¿Dónde pongo la configuración como read_only: false?

Así que, después de mucho trastear, aquí tienes una guía probada para instalar Discourse MCP en Codex CLI, y en los próximos días publicaré una guía para Claude Code CLI y opencode. Si hay otros clientes de MCP que te gustaría usar, házmelo saber en las respuestas e intentaré ayudarte.

Edición: 2026.03.13 - He escrito una guía para opencode que tiene un formato de archivo de configuración ligeramente diferente para los MCP, lo que podría confundir a la gente.

Prerrequisitos:

Node.js instalado (se recomienda 24 LTS)
Codex CLI instalado
Acceso a https://discourse.example.com como usuario normal

Es importante darse cuenta de que hay tres componentes separados aquí:

El foro remoto de Discourse, que es la fuente de datos y el objetivo de las acciones.

El servidor Discourse MCP, que es una herramienta de código abierto que se ejecuta localmente y se conecta a Discourse para proporcionar una API para que Codex interactúe con Discourse. Se instala como un servidor STDIO y se inicia a demanda por Codex CLI.

Codex CLI, que es el cliente MCP que se conecta al servidor MCP y proporciona la interfaz para interactuar con Discourse a través de la API de MCP.

1. Generar la clave API de Usuario

Esto te autenticará en Discourse y es la forma en que obtendrás tu clave API. npx descargará y ejecutará el código, no es necesario instalar nada en el sentido tradicional.

En una terminal, ejecuta:

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

Acepta el consentimiento del navegador y copia los datos cifrados, lo que demuestra tu capacidad para iniciar sesión y genera una clave API que se guarda en =MCP-CONFIG= para que la utilice el servidor MCP.

La clave API tendrá el mismo nivel de acceso al foro que tienes como usuario.

2. Añadir el servidor MCP a Codex CLI:

Ejecuta esto en una terminal (no dentro del propio Codex CLI)

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

Se instala como un servidor STDIO, por lo que se iniciará a demanda con npx por Codex CLI cuando inicies Codex CLI.

Está configurado para usar el perfil en =MCP-CONFIG= y, por defecto, es de solo lectura.

3. Reiniciar Codex CLI

Reinicia completamente Codex para que recargue config.toml y el perfil.

Si se inicia sin errores, no hay problemas con la configuración y deberías ver el servidor MCP listado cuando ejecutes el comando de barra inclinada /mcp en Codex CLI.

En Codex CLI puedes pedirle a Codex que consulte este Discourse para obtener información, especialmente información a la que tienes acceso pero que no es pública, lo que verificará que se está conectando como tú.

4. Habilitar funciones de escritura (Opcional)

Por defecto, el servidor Discourse MCP se ejecuta en modo de solo lectura. Para habilitar operaciones de escritura (crear publicaciones, temas, usuarios, etc.), debes añadir dos indicadores a tu archivo JSON de perfil.

Edita el perfil de Discourse en =MCP-CONFIG= y añade "read_only": false y "allow_writes": true como elementos hermanos del array auth_pairs:

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

Ejemplo:

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

Después de añadir estos indicadores, reinicia OpenCode CLI para que los cambios surtan efecto. El servidor MCP ahora permitirá operaciones de escritura como:

Creación y actualización de temas
Creación de publicaciones y respuestas
Gestión de borradores
Subida de archivos
Creación de categorías (si tienes permiso)
Gestión de usuarios (si tienes permiso de administrador)

Advertencia: Las operaciones de escritura utilizarán los permisos de tu cuenta de usuario. Cualquier contenido creado aparecerá como si lo hubieras creado manualmente. Utiliza las funciones de escritura de forma responsable.

Edición de la configuración

En algún momento podrías querer editar la configuración para añadir la capacidad de escribir en Discourse, y lo harías en la configuración de Discourse.

Para confundir, hay dos lugares donde se almacena la configuración y entre la documentación de Codex y la de Discourse es realmente confuso, especialmente para averiguar qué partes pertenecen a Codex CLI y cuáles forman parte del propio servidor STDIO de MCP.

Hay dos archivos principales:

=CODEX-CONFIG= - este es el archivo de configuración de Codex CLI, que incluye la configuración del servidor MCP.
=MCP-CONFIG= - este es el perfil para el servidor Discourse MCP, que incluye la clave API y otra configuración para conectarse a Discourse.

Configuración de Codex CLI

La configuración para conectarse al MCP está en =CODEX-CONFIG= y debería parecerse a esto. Si quieres añadir opciones al servidor MCP, las añades aquí.

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

Documentación de la configuración de Codex MCP Model Context Protocol