Saltar al contenido principal

Configurar Antigravity para Kanera MCP

Google Antigravity se conecta a Kanera a través del Model Context Protocol. Admite servidores HTTP Streamable remotos con descubrimiento de OAuth y registro dinámico de clientes, por lo que no necesita ningún cliente registrado previamente ni una clave de API. La misma configuración funciona en la aplicación Antigravity, el IDE y Antigravity CLI.

Añade Kanera a tu configuración global de MCP de Antigravity en ~/.gemini/config/mcp_config.json, o a .agents/mcp_config.json en un proyecto cuando la conexión solo deba estar disponible allí:

{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp"
}
}
}

Si el archivo ya incluye otros servidores, añade la entrada kanera dentro del objeto mcpServers existente. En el IDE puedes abrir este archivo desde el panel lateral del agente: elige … -> MCP Servers -> Manage MCP Servers -> View raw config.

Después, autentícate:

  1. En la aplicación Antigravity, abre Customizations -> Installed. En MCP Servers, elige Autenticarse junto a Kanera.
  2. Inicia sesión en Kanera en el navegador, revisa el acceso solicitado y elige Permitir acceso.
  3. Copia el código de autorización que muestra Antigravity, pégalo en Enter authorization code, y elige Submit.

Antigravity se vuelve a conectar a Kanera y renueva el token automáticamente cuando caduca. En Antigravity CLI, escribe /mcp para abrir el gestor de MCP, comprobar que Kanera está conectado y leer sus registros de conexión.

Antigravity pide confirmación antes de ejecutar una herramienta MCP que no tiene ninguna regla de permisos. Para que use las herramientas de Kanera sin preguntar cada vez, permite mcp(kanera/*) en tus permisos de Antigravity. Permite lo que permita el cliente, Kanera sigue comprobando en cada solicitud tu rol en cada tablero y la política de agentes de IA de su organización.

Consulta Conecta un agente de IA para conocer los alcances y cómo desconectar un agente.

Instalar la habilidad de Kanera​

La conexión MCP da a Antigravity acceso a las herramientas de Kanera. La opcional skill de agente de Kanera le enseña a resolver nombres en ID estables, leer el estado en vivo antes de informar o modificar el trabajo, distinguir el trabajo completado de la actividad de creación, usar claves de idempotencia y gestionar de forma segura los fallos de permisos o de límite de uso.

Instala la skill globalmente con el instalador abierto de Agent Skills:

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

Para una instalación manual, descarga el directorio completo de la skill kanera con todos sus archivos y colócalo en una de estas ubicaciones:

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

Antigravity muestra la skill a su agente y carga las instrucciones completas cuando una solicitud es pertinente. También puedes nombrar la skill en tu prompt o escribir /kanera en la aplicación o la CLI. En la CLI, ejecuta /skills reload si añadiste la skill durante una sesión.

Excepción: conectarse con una clave de API​

Usa OAuth siempre que puedas

Una clave de API es un secreto de larga duración que tú mismo guardas y rota, y el trabajo realizado con una clave personal se registra a tu nombre, sin la a través de <agente>. Úsala solo cuando OAuth realmente no pueda funcionar:

  • Tu versión de Antigravity no puede completar el flujo de OAuth remoto.
  • Necesitas un servidor stdio local y no puedes usar el Kanera CLI. kanera auth login inicia sesión con OAuth, y kanera mcp sirve stdio con ese inicio de sesión, sin necesidad de clave.
  • El equipo no tiene navegador para iniciar sesión. Prueba primero la autorización del dispositivo si tu cliente la admite.

Cuando uses una clave, créala como Solo lectura salvo que el agente deba modificar el trabajo.

Antigravity envía los valores de los encabezados tal como están escritos, por lo que la clave se guarda en el propio archivo de configuración. Usa el archivo global ~/.gemini/config/mcp_config.json en lugar de un archivo de proyecto, y no lo confirme nunca en el repositorio:

{
"mcpServers": {
"kanera": {
"serverUrl": "https://mcp.kanera.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_KANERA_API_KEY"
}
}
}
}

Crea una clave personal en Configuración del perfil -> Claves de API o una clave de espacio de trabajo en Configuración del espacio de trabajo -> API.

Referencia del cliente​