Configuração do Discourse MCP no CLI do OpenAI Codex

Wiki da comunidade Usuários
, ,
1

Tenho experimentado com o Discourse MCP, mas descobri que a documentação existente na Meta para usá-lo não incluía nada sobre o Codex CLI, e foi um pouco confuso descobrir quais partes da documentação se aplicariam:

  • é npx ou npm install?
  • quais partes da configuração são do Codex e quais são do Discourse MCP?
  • onde eu coloco as configurações como read_only: false?

Então, depois de muita confusão, aqui está um guia testado para instalar o Discourse MCP no Codex CLI, e darei seguimento nos próximos dias com um guia para o Claude Code CLI e opencode. Se houver outros clientes MCP que você gostaria de usar, me avise nas respostas e tentarei ajudar.

Pré-requisitos:

É importante perceber que existem três componentes separados aqui:

  1. O fórum Discourse remoto, que é a fonte dos dados e o destino das ações.

  1. O servidor Discourse MCP, que é uma ferramenta de código aberto executada localmente que se conecta ao Discourse e fornece uma API para o Codex interagir com o Discourse. Ele é instalado como um servidor STDIO e iniciado sob demanda pelo Codex CLI.

  1. O Codex CLI, que é o cliente MCP que se conecta ao servidor MCP e fornece a interface para interagir com o Discourse através da API MCP.

1. Gerar a chave de API de Usuário

Isso o autenticará no Discourse e é como você obterá sua chave de API. O npx baixará e executará o código, nada precisa ser instalado no sentido tradicional.

Em um terminal, execute:

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

Aprove o consentimento do navegador e copie os dados criptografados de volta, o que prova sua capacidade de fazer login e gera uma chave de API que é salva em =MCP-CONFIG= para uso pelo servidor MCP.

A chave de API terá o mesmo nível de acesso ao fórum que você tem como usuário.

2. Adicionar o servidor MCP ao Codex CLI:

Execute isso em um terminal (não no próprio Codex CLI)

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

Ele é instalado como um servidor STDIO, portanto, será iniciado sob demanda com npx pelo Codex CLI quando você iniciar o Codex CLI.

Ele é configurado para usar o perfil em =MCP-CONFIG= e, por padrão, é somente leitura.

3. Reiniciar o Codex CLI

Reinicie totalmente o Codex para que ele recarregue config.toml e o perfil.

Se ele iniciar sem erros, não há problemas com a configuração e você deverá ver o servidor MCP listado quando executar o comando de ‘barra’ /mcp no Codex CLI.

No Codex CLI, você pode pedir ao Codex para consultar este Discourse para obter informações - especialmente informações às quais você tem acesso, mas que não são públicas - isso verificará se ele está se conectando como você.

Editando Configurações

Em algum momento, você pode querer editar as configurações para adicionar a capacidade de escrever no Discourse, e você faria isso nas configurações do Discourse.

Confusamente, existem dois locais onde as configurações são armazenadas e, entre a documentação do Codex e a do Discourse, é realmente muito confuso, especialmente para descobrir quais partes pertencem ao Codex CLI e quais fazem parte do próprio servidor STDIO do MCP.

Existem dois arquivos principais:

  1. =CODEX-CONFIG= - este é o arquivo de configuração do Codex CLI, que inclui as configurações do servidor MCP.

  2. =MCP-CONFIG= - este é o perfil para o servidor Discourse MCP, que inclui a chave de API e outras configurações para conexão com o Discourse.

Configurações do Codex CLI

As configurações para conectar ao MCP estão em =CODEX-CONFIG= e devem ser parecidas com isto. Se você quiser adicionar opções ao servidor MCP, adicione-as aqui.

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

Documentação das configurações do Codex MCP Model Context Protocol

Configurações do Discourse MCP

As configurações para o próprio servidor Discourse MCP estão em =CODEX-CONFIG=

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

Referência da documentação das configurações do Discourse MCP GitHub - discourse/discourse-mcp: MCP client for Discourse sites · GitHub

2 curtidas
Discourse MCP is here!