Saltar al contenido principal

Configurar Codex para Kanera MCP

La aplicación de escritorio ChatGPT, Codex CLI y la extensión Codex IDE se conectan a Kanera a través de Protocolo de contexto modelo. Comparten la configuración de MCP para el mismo host Codex, por lo que normalmente solo es necesario agregar Kanera una vez.

En la aplicación de escritorio ChatGPT, abra Complementos, buscar Kanera por Sucede Software Limitede instalarlo. Conecte su cuenta de Kanera a través de OAuth cuando se le solicite, luego inicie un nuevo chat de Codex y pídale que use Kanera. El complemento incluye la conexión MCP y la habilidad, por lo que no es necesaria una instalación de habilidad por separado ni un registro manual del servidor.

En Codex CLI, ingrese /plugins para abrir el navegador de complementos, instale Kanera desde un mercado disponible e inicie una nueva sesión. La cuenta, las políticas del espacio de trabajo y las fuentes del mercado configuradas determinan la disponibilidad.

La extensión IDE no admite complementos. Utilice el conexión manual y la habilidad independiente a continuación para el IDE, una implementación Kanera autohospedada o un cliente donde los complementos no están disponibles. Evite registrar un segundo servidor alojado cuando el complemento ya esté conectado.

Si el complemento no está disponible: conexión manual con OAuth​

Si Kanera no se encuentra en su mercado de complementos o la instalación del complemento no está disponible, agregue el servidor MCP directamente y conecte su cuenta Kanera con OAuth. La dirección alojada MCP es https://mcp.kanera.app/mcp. Para el autohospedaje, copie la dirección MCP de su implementación desde Configuración de perfil -> Claves API en cambio. No es necesario crear ni almacenar una clave API.

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

El comando de inicio de sesión abre Kanera en su navegador. Inicie sesión, revise el acceso solicitado y elija Permitir acceso. correr codex mcp list para verificar que el servidor esté registrado, o utilice /mcp en la CLI del Codex para inspeccionar la conexión.

En la aplicación de escritorio ChatGPT, abra Configuración -> Servidores MCP -> Agregar servidor. En la extensión IDE, abra el menú de ajustes y seleccione Servidores MCP -> Agregar servidor. Entrar Kanera, elige HTTP transmitibley utilice la misma URL. Guarde y reinicie cuando se le solicite, luego elija autenticar cuando Kanera requiere iniciar sesión.

También puede configurar el servidor remoto directamente en ~/.codex/config.toml:

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

Entonces corre codex mcp login kanera. Ver Conecte un agente de IA para alcances y desconectar un agente.

Instalar la habilidad para una conexión manual.​

Si instaló el complemento, su habilidad incluida ya está disponible. Para una configuración manual, la conexión MCP le da a Codex acceso a las herramientas de Kanera. el Habilidad del agente Kanera le enseña cómo seleccionar esas herramientas de manera confiable: enrutar claves de tarjeta exactas como DEV-938 directamente a Kanera, prefiera MCP a la automatización del navegador para trabajos compatibles, resuelva nombres en ID estables, lea el estado en vivo antes de informar o cambiar el trabajo, use claves de idempotencia y maneje fallas de permisos o límites de velocidad de manera segura.

Instale la habilidad globalmente con el instalador abierto de Agent Skills:

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

Para una instalación manual, descargue el archivo completo kanera directorio de habilidades, incluyendo SKILL.md y agents/openai.yamly colóquelo en una de estas ubicaciones:

  • ~/.agents/skills/kanera/ para una habilidad personal disponible en todos los proyectos.
  • .agents/skills/kanera/ en un repositorio para compartir la habilidad con ese proyecto.

Codex normalmente detecta cambios de habilidades automáticamente. Si no aparece, reinicie Codex. Mención $kanera explícitamente en un mensaje para forzar su carga, o dejar que Codex lo seleccione automáticamente para el trabajo de Kanera.

uso /apps para adjuntar la aplicación Kanera, /plugins para inspeccionar si el complemento Kanera y la habilidad incluida están disponibles, y /mcp verbose para confirmar la conexión de la herramienta. Por ejemplo:

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

El Codex debería leer esa tarjeta detenidamente. cards.get y aplicar el cambio solicitado a través de cards.update. Debería abrir la interfaz web de Kanera solo para una tarea explícitamente visual o una operación de administración que MCP no expone.

Excepción: conectarse con una clave API​

:::precaución Utilice OAuth siempre que pueda Una clave API es un secreto de larga duración que usted mismo almacena y rota, y el trabajo realizado con una clave personal se registra como usted, sin la a través de <agente> etiqueta. Utilice uno sólo cuando OAuth realmente no pueda funcionar:

  • Su versión de Codex no puede completar el flujo OAuth remoto.
  • Necesita un servidor stdio local y no puede usar el Kanera CLI. kanera auth login inicia sesión con OAuth y kanera mcp sirve stdio con ese inicio de sesión, no se requiere clave.
  • La máquina no tiene un navegador para iniciar sesión. Pruebe autorización del dispositivo primero si su cliente lo admite.

Cuando uses una clave, créala Sólo lectura a menos que el agente deba cambiar el trabajo y mantenerlo en una variable de entorno en lugar de en un archivo confirmado. :::

Reemplazar kanera_live_... con una clave personal de Configuración de perfil -> Claves API o una clave de espacio de trabajo de Configuración del espacio de trabajo -> APIy establecer KANERA_PUBLIC_API_URL a https://api.kanera.app. Para una configuración personal de Codex, una clave personal suele ser la opción adecuada porque sigue el acceso a su propio tablero en todos los espacios de trabajo.

Configuración de la API del espacio de trabajo donde se puede crear una clave API del espacio de trabajo para Kanera MCP.

Aplicación de escritorio ChatGPT​

Abierto Configuración -> Servidores MCP, luego seleccione Agregar servidor. Puede agregar el servidor stdio local allí o editar config.toml utilizando la siguiente configuración. Guarde el servidor y seleccione Reiniciar.

Después de agregar Kanera, inicie una nueva conversación y confirme que sus herramientas estén disponibles.

Archivo de configuración (aplicación, CLI y extensión IDE)​

Codex almacena servidores MCP a nivel de usuario en ~/.codex/config.toml. Añadir un [mcp_servers.kanera] tabla para un servidor stdio local, que ejecuta el Kanera CLI como servidor (Nodo 22 o posterior). Si ya corriste kanera auth login, puedes omitir env; kanera mcp reutiliza la credencial almacenada.

[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 el servidor HTTP alojado con una clave API estática, mantenga la clave en una variable de entorno en lugar de escribirla en el archivo:

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

conjunto KANERA_API_KEY en el entorno que inicia Codex, luego reinicie la aplicación, CLI o extensión IDE.

línea de comando​

O agréguelo desde la línea 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

En la aplicación de escritorio, regrese a Configuración -> Servidores MCP para comprobar la conexión. En la extensión IDE, use el menú de ajustes y seleccione Servidores MCP.

Referencia del cliente​