Pular para conteúdo

Conectar o MCP da OpsFactor Pro ao Claude Code e ao Codex

Este guia é para um ambiente OpsFactor Pro com MCP habilitado. O endpoint MCP remoto permite que um cliente de IA descubra e use as ferramentas de planejamento disponíveis para sua conta. O Claude Code e o Codex local se conectam via HTTP e concluem a autenticação da OpsFactor no navegador. Confirme que o MCP está habilitado no seu ambiente OpsFactor Pro antes de começar. Uma assinatura Claude Pro ou ChatGPT Pro é um produto separado e não concede acesso à OpsFactor Pro.

Antes de começar

  1. Obtenha a URL da aplicação para o ambiente específico da OpsFactor que você está autorizado a usar e confirme que sua conta consegue entrar nele. O endpoint MCP é a mesma URL base com /mcp acrescentado uma vez, por exemplo https://YOUR_OPSFACTOR_HOST/mcp. Substitua esse exemplo pelo endpoint real em todos os comandos abaixo.
  2. Instale e entre no cliente que usará. Siga o guia oficial de instalação do Claude Code ou a página de download e instalação do Codex. Para o fluxo de terminal, o repositório oficial do Codex CLI também traz as opções atuais de instalação. Basta um dos clientes para concluir este guia.
  3. Use um navegador interativo no mesmo computador para o login OAuth. Não coloque usuário, senha, token de acesso nem segredo do cliente nos comandos MCP, arquivos do projeto ou prompts. A tela de login da OpsFactor recebe essas credenciais.

O suporte nativo a MCP remoto do Claude Code e do Codex basta para essa configuração. Não é necessário um ZIP adicional nem um servidor MCP local.

Claude Code

  1. Abra um terminal e adicione o endpoint à configuração do usuário. Escolha um nome diferente para cada ambiente da OpsFactor caso conecte mais de um.
claude mcp add --transport http --scope user opsfactor "https://YOUR_OPSFACTOR_HOST/mcp"
  1. Inicie o fluxo OAuth e conclua o login da OpsFactor no navegador.
claude mcp login opsfactor
  1. Confirme a conexão com claude mcp list ou claude mcp get opsfactor. Dentro do Claude Code, /mcp mostra a mesma conexão e permite autenticar caso você tenha pulado o login no terminal.
  2. Confira se a URL configurada pertence ao ambiente da OpsFactor pretendido e peça ao Claude Code para chamar opsfactor_references e mostrar as categorias disponíveis. Valide o ambiente antes de pedir análise de dados ou alguma operação.

O guia MCP oficial do Claude Code confirma o suporte a servidores HTTP remotos, configuração por usuário e OAuth no navegador.

Codex

Escolha a interface desktop ou o terminal. Os clientes locais do Codex compartilham a configuração MCP no mesmo host.

Codex desktop

  1. Instale e abra o aplicativo Codex e entre na sua conta.
  2. Abra Settings > MCP servers > Add server. Nomeie o servidor como opsfactor, escolha Streamable HTTP e informe a URL completa /mcp do ambiente.
  3. Salve e selecione Restart. Quando o servidor indicar que precisa de autenticação, selecione Authenticate e conclua o login da OpsFactor no navegador.
  4. Digite /mcp no campo de mensagem para inspecionar o servidor conectado. Peça ao Codex para chamar opsfactor_references e mostrar as categorias disponíveis. Confira a URL do servidor contra o ambiente pretendido antes de usar qualquer ferramenta.

Codex CLI

Se preferir o terminal, instale o Codex CLI e execute:

codex mcp add opsfactor --url "https://YOUR_OPSFACTOR_HOST/mcp"
codex mcp login opsfactor
codex mcp list

Conclua o fluxo OAuth no navegador, inicie uma sessão do Codex e use /mcp para conferir a conexão. O guia MCP oficial do Codex descreve os caminhos desktop, CLI e extensão para IDE e a configuração compartilhada.

Conferir o acesso e resolver problemas de conexão

O que aparece O que conferir
Needs authentication Execute o login MCP do cliente ou selecione Authenticate e conclua o login no navegador.
Failed to connect Confira a URL completa do endpoint, inclusive um único /mcp, e o acesso ao ambiente a partir do seu computador. Alguns ambientes levam alguns minutos para iniciar após inatividade.
Access denied Confira se escolheu o ambiente da OpsFactor correto e se sua conta tem acesso MCP nele. Peça ao administrador desse ambiente para conferir as permissões.
Conexão com o ambiente errado Dê um nome distinto a cada ambiente, confira a URL selecionada no cliente e valide o ambiente antes de usar uma ferramenta.

As ferramentas MCP usam as permissões da conta conectada à OpsFactor. Confira o ambiente e o efeito esperado antes de autorizar uma ferramenta que altere dados de planejamento ou dispare um processo.

Para outras jornadas, volte aos guias. Para arquitetura e integrações, consulte a documentação técnica.