Guía · Unos 3 minutos

Cómo conectar Onplana con Gemini CLI y Code Assist

Instalación en una línea. Onplana incluye un manifiesto de extensión de Gemini en la raíz del repositorio, así que toda la configuración es:gemini extensions install <repo>.

Después podrá pedirle a Gemini cosas como «resume mis tareas atrasadas de Onplana», «crea un plan de proyecto para el lanzamiento del Q3 con 5 hitos semanales» o «lista los miembros de mi equipo en el proyecto de la plataforma de datos», y Gemini lo ejecuta directamente en Onplana.

Abrir Onplana → Configuración → Agentes Gemini CLI en GitHub

En resumen: tres comandos

# 1. Set your Onplana token
export ONPLANA_PAT=pat_paste-your-token-here

# 2. Install the extension
gemini extensions install https://github.com/Onplana/onplana-mcp-server

# 3. Restart and verify
gemini
> list my Onplana projects via the onplana tool

Los pasos detallados, más abajo.

Los cinco pasos en detalle

  1. 1

    Instalar Gemini CLI (si aún no lo tiene)

    En macOS / Linux: npm install -g @google/gemini-cli. En Windows: el mismo comando en una consola con Node. Compruebe con `gemini --version`. Si usa Gemini Code Assist en VS Code o JetBrains, ya tiene lo que necesita: Code Assist comparte el archivo de configuración con la CLI.

  2. 2

    Generar un token de conexión de Onplana

    Inicie sesión en Onplana en app.onplana.com. Vaya a Configuración → Agentes → Conectar agente, elija el mosaico Gemini CLI + Code Assist, luego Token de acceso personal y después Generar token y mostrar el fragmento de conexión. Copie el token de acceso personal (empieza por `pat_`). Defínalo como variable de entorno: export ONPLANA_PAT=pat_your-token-here (añada la línea a ~/.bashrc o ~/.zshrc para que perdure).

  3. 3

    Instalar la extensión de Gemini de Onplana (un comando)

    Ejecute: gemini extensions install https://github.com/Onplana/onplana-mcp-server. El repositorio de Onplana incluye en la raíz un manifiesto gemini-extension.json, que Gemini CLI lee para configurar automáticamente la conexión con el servidor MCP. Como alternativa, edite ~/.gemini/settings.json a mano; el formato está documentado en developers.google.com/gemini-code-assist/docs.

  4. 4

    Reiniciar Gemini CLI o recargar el editor

    Para Gemini CLI: salga y vuelva a abrir `gemini`. Para Gemini Code Assist en VS Code: Cmd/Ctrl+Mayús+P → "Developer: Reload Window". Para JetBrains: reinicie el IDE. Las herramientas de Onplana aparecen en el selector /mcp tras reiniciar.

  5. 5

    Comprobar la conexión

    En una sesión nueva de Gemini, pregunte: «list my Onplana projects via the onplana tool». Gemini llama a la herramienta list_projects de Onplana y le muestra el resultado. Si recibe un error, compruebe que ONPLANA_PAT está definido en el entorno que usa Gemini y que el manifiesto de la extensión se instaló bien, con `gemini extensions list`.

O configúrelo a mano

Si prefiere no instalar la extensión, edite~/.gemini/settings.json(o .gemini/settings.json en la raíz del espacio de trabajo) directamente:

{
  "mcpServers": {
    "onplana": {
      "httpUrl": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      },
      "timeout": 5000
    }
  }
}

Fíjese en que la clave es httpUrl, no url. Gemini CLI usa httpUrl para servidores Streamable HTTP como Onplana y reserva url para servidores SSE. El token bearer en headers.Authorization autentica cada solicitud.

Cómo comprobar que funciona

Abra una sesión nueva de Gemini y pruebe cualquiera de estas:

  • «Con la herramienta onplana, lista mis proyectos.»
  • «Muéstrame las tareas atrasadas de Onplana asignadas a mí.»
  • «Crea una tarea de Onplana en el proyecto X llamada ‘Migrar Postgres a Aurora’.»
  • «Busca en mis páginas de Onplana notas sobre la migración de la API.»

Ejecute gemini extensions list para confirmar que la extensión de Onplana está instalada. Tras una instalación correcta, el selector /mcp debería mostrar la lista completa de herramientas de Onplana.

Preguntas frecuentes

¿Funciona con Gemini Code Assist en VS Code?

Sí. Gemini CLI y Gemini Code Assist comparten el mismo archivo de configuración (~/.gemini/settings.json para todo el usuario o .gemini/settings.json en un espacio de trabajo). Una instalación con `gemini extensions install` cubre ambos. Después, recargue la ventana de VS Code (Cmd/Ctrl+Mayús+P → "Developer: Reload Window") para que Code Assist tome la nueva configuración.

¿Y la app de Gemini en gemini.google.com?

gemini.google.com todavía no admite servidores MCP personalizados a mayo de 2026. Google remite a quien quiera conectarse con servidores MCP de terceros a Gemini CLI o Gemini Code Assist. Lo seguimos; si la app añade soporte MCP, la instalación será de un clic mediante una interfaz de conectores parecida a la de Claude.ai.

¿Y Gemini Enterprise / Vertex AI Agent Builder?

Gemini Enterprise es una configuración distinta de Gemini CLI: un administrador añade Onplana en la consola de Google Cloud como almacén de datos Custom MCP Server, con un ID de cliente OAuth y un secreto. Está en acceso anticipado y lo gestiona el administrador, no es de autoservicio: Onplana emite el cliente para su organización a petición. La guía en docs.onplana.com/ai-agents/connect-onplana-to-gemini-enterprise/ tiene la configuración, las 20 acciones que conviene activar primero y el enlace para pedir acceso.

¿Qué plan de Onplana incluye MCP?

MCP está incluido en todos los planes, incluido el gratuito. El número de conexiones de agentes simultáneas crece con el plan (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ ilimitadas), y su saldo de tokens de IA (una asignación mensual en los planes de pago, un bono único en Free, más el crédito que compre) es lo que limita el uso real de la IA. Puede cambiar de plan cuando quiera en app.onplana.com/billing.

¿Qué diferencia hay entre instalar con gemini-extension.json y editar settings.json directamente?

Funcionalmente son equivalentes. La instalación de la extensión es un comando y usa un manifiesto en la raíz del repositorio, así que es reproducible. Editar settings.json a mano sirve cuando quiere poner Onplana junto a varios servidores MCP (por ejemplo, uno para Onplana, otro para Linear y otro para una API interna) dentro del mismo objeto `mcpServers`. Ambos funcionan y comparten la misma configuración.

¿Por qué la clave se llama httpUrl y no url?

Gemini CLI distingue entre servidores MCP por stdio (clave: command), por SSE (clave: url) y por Streamable HTTP (clave: httpUrl). El servidor MCP de Onplana usa Streamable HTTP, el estándar de transporte más reciente, que gestiona solicitud y respuesta sobre HTTPS simple sin SSE. La clave `url` en las configuraciones de Claude Desktop, Cursor y ChatGPT es la equivalente.

¿Puedo revocar la conexión?

Sí, de dos maneras: (1) Onplana → Configuración → Agentes → Conexiones → Revocar en la fila del token. (2) Quite ONPLANA_PAT de su entorno Y ejecute `gemini extensions uninstall onplana`. Cualquiera surte efecto de inmediato; la siguiente llamada de Gemini a una herramienta devuelve 401.

¿A qué herramientas tiene acceso Gemini?

346 herramientas, las mismas que reciben Claude Desktop, Cursor y ChatGPT: lectura (list_projects, list_my_tasks, get_task, search_org_knowledge, etc.) y escritura (create_task, update_task, assign_task, create_milestone, etc.), además de las áreas de gobernanza, control de cambios, cumplimiento, documentos y flujos de trabajo. El catálogo es el mismo sea cual sea el cliente conectado. El plan habilita algunas herramientas; el catálogo completo está en onplana.com/mcp.

Relacionado