Pular para o conteúdo principal

Configurar o Codex para Kanera MCP

O aplicativo de desktop ChatGPT, Codex CLI e extensão Codex IDE se conectam ao Kanera por meio do Protocolo de Contexto do Modelo. Eles compartilham a configuração MCP para o mesmo host Codex, então normalmente você só precisa adicionar o Kanera uma vez.

No aplicativo de desktop ChatGPT, abra Plug-ins, procure por Kanera por Acontecer Software Limitadoe instale-o. Conecte sua conta Kanera por meio do OAuth quando solicitado, inicie um novo bate-papo do Codex e peça para usar o Kanera. O plug-in agrupa a conexão e a habilidade do MCP, portanto, nenhuma instalação de habilidade separada ou registro manual do servidor é necessária.

Na CLI do Codex, digite /plugins para abrir o navegador do plugin, instale o Kanera de um mercado disponível e inicie uma nova sessão. A conta, as políticas do espaço de trabalho e as fontes de mercado configuradas determinam a disponibilidade.

A extensão IDE não oferece suporte a plug-ins. Use o conexão manual e habilidade autônoma abaixo para o IDE, uma implantação Kanera auto-hospedada ou um cliente onde os plug-ins não estão disponíveis. Evite registrar um segundo servidor hospedado quando o plugin já estiver conectado.

Se o plugin não estiver disponível: conexão manual com OAuth​

Se Kanera estiver faltando em seu mercado de plug-ins ou a instalação do plug-in não estiver disponível, adicione o servidor MCP diretamente e conecte sua conta Kanera ao OAuth. O endereço MCP hospedado é https://mcp.kanera.app/mcp. Para auto-hospedagem, copie o endereço MCP da sua implantação de Configurações de perfil -> Chaves de API em vez disso. Não é necessário criar ou armazenar uma chave API.

codex mcp add kanera --url https://mcp.kanera.app/mcp
codex mcp login kanera

O comando de login abre o Kanera em seu navegador. Faça login, revise o acesso solicitado e escolha Permitir acesso. Corre codex mcp list para verificar se o servidor está registrado ou use /mcp na CLI do Codex para inspecionar a conexão.

No aplicativo de desktop ChatGPT, abra Configurações -> Servidores MCP -> Adicionar servidor. Na extensão IDE, abra o menu de engrenagem e selecione Servidores MCP -> Adicionar servidor. Entrar Kanera, escolha HTTP streamávele use o mesmo URL. Salve e reinicie quando solicitado e escolha Autenticar quando Kanera exige login.

Você também pode configurar o servidor remoto diretamente em ~/.codex/config.toml:

[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"

Então corra codex mcp login kanera. Veja Conecte um agente de IA para escopos e desconectar um agente.

Instale a habilidade para uma conexão manual​

Se você instalou o plug-in, a habilidade incluída já estará disponível. Para uma configuração manual, a conexão MCP dá ao Codex acesso às ferramentas do Kanera. O Habilidade do agente Kanera ensina como selecionar essas ferramentas de forma confiável: rotear chaves de cartão exatas, como DEV-938 diretamente para Kanera, prefira o MCP em vez da automação do navegador para trabalho com suporte, resolva nomes para IDs estáveis, leia o estado ao vivo antes de relatar ou alterar o trabalho, use chaves de idempotência e lide com falhas de permissão ou limite de taxa com segurança.

Instale a habilidade globalmente com o instalador aberto do Agent Skills:

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global

Para uma instalação manual, baixe o arquivo completo kanera diretório de habilidades, incluindo SKILL.md e agents/openai.yamle coloque-o em um destes locais:

  • ~/.agents/skills/kanera/ para uma habilidade pessoal disponível em todos os projetos.
  • .agents/skills/kanera/ em um repositório para compartilhar a habilidade com esse projeto.

O Codex normalmente detecta mudanças de habilidade automaticamente. Se não aparecer, reinicie o Codex. Menção $kanera explicitamente em um prompt para forçar o carregamento ou deixar o Codex selecioná-lo automaticamente para o trabalho do Kanera.

Usar /apps para anexar o aplicativo Kanera, /plugins para inspecionar se o plugin Kanera e a habilidade incluída estão disponíveis, e /mcp verbose para confirmar a conexão da ferramenta. Por exemplo:

$kanera Update DEV-938 with the investigation findings and agreed implementation plan.

Codex deve ler esse cartão cards.get e aplique a alteração solicitada através cards.update. Ele deve abrir a interface da web do Kanera apenas para uma tarefa explicitamente visual ou uma operação de administração que o MCP não expõe.

Exceção: conecte-se com uma chave de API​

Use OAuth sempre que puder Uma chave de API é um segredo de longa duração que você mesmo armazena e alterna, e o trabalho realizado com uma chave pessoal é registrado como você, sem o via <agente> rótulo. Use um somente quando o OAuth realmente não funcionar:
  • Sua versão do Codex não pode concluir o fluxo OAuth remoto.
  • Você precisa de um servidor stdio local e não pode usar o Kanera CLI. kanera auth login faz login com OAuth e kanera mcp atende stdio com esse login, nenhuma chave é necessária.
  • A máquina não possui navegador para login. Experimente autorização do dispositivo primeiro se o seu cliente suportar.

Quando você usa uma chave, crie-a Somente leitura a menos que o agente precise alterar o trabalho e mantê-lo em uma variável de ambiente em vez de em um arquivo confirmado. :::

Substituir kanera_live_... com uma chave pessoal de Configurações de perfil -> Chaves de API ou uma chave de espaço de trabalho de Configurações do espaço de trabalho -> APIe definir KANERA_PUBLIC_API_URL para https://api.kanera.app. Para uma configuração pessoal do Codex, uma chave pessoal geralmente é a opção certa porque segue o acesso do seu próprio quadro em todos os espaços de trabalho.

Configurações de API do espaço de trabalho onde uma chave de API do espaço de trabalho pode ser criada para Kanera MCP.

Aplicativo de desktop ChatGPT​

Abrir Configurações -> Servidores MCPe selecione Adicionar servidor. Você pode adicionar o servidor stdio local ou editar config.toml usando a configuração abaixo. Salve o servidor e selecione Reiniciar.

Após adicionar Kanera, inicie uma nova conversa e confirme se suas ferramentas estão disponíveis.

Arquivo de configuração (aplicativo, CLI e extensão IDE)​

Codex armazena servidores MCP em nível de usuário em ~/.codex/config.toml. Adicione um [mcp_servers.kanera] tabela para um servidor stdio local, que executa o Kanera CLI como o servidor (Nó 22 ou posterior). Se você já correu kanera auth login, você pode omitir env; kanera mcp reutiliza a credencial armazenada.

[mcp_servers.kanera]
command = "npx"
args = ["-y", "@kanera/cli", "mcp"]
env = { KANERA_API_KEY = "kanera_live_...", KANERA_PUBLIC_API_URL = "https://api.kanera.app" }

Para o servidor HTTP hospedado com uma chave de API estática, mantenha a chave em uma variável de ambiente em vez de gravá-la no arquivo:

[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
bearer_token_env_var = "KANERA_API_KEY"

Definir KANERA_API_KEY no ambiente que inicia o Codex e reinicie o aplicativo, CLI ou extensão IDE.

Linha de comando​

Ou adicione-o na linha de comando:

codex mcp add kanera \
  --env KANERA_API_KEY=kanera_live_... \
  --env KANERA_PUBLIC_API_URL=https://api.kanera.app \
  -- npx -y @kanera/cli mcp

No aplicativo de desktop, retorne para Configurações -> Servidores MCP para verificar a conexão. Na extensão IDE, use o menu de engrenagem e selecione Servidores MCP.

Referência do cliente​