> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Gemini CLI a Profound MCP

Esta guía te muestra cómo conectar Gemini CLI al servidor de Profound MCP, para que Gemini pueda obtener tus datos de visibilidad de Profound y ejecutar acciones de Profound directamente desde la terminal.

## Antes de empezar

Asegúrate de tener:

* [Gemini CLI](https://geminicli.com/) instalado
* Una cuenta de [Profound](https://www.tryprofound.com/)

## Guía de configuración

<Steps>
  <Step title="Autentícate con Gemini CLI">
    1. Ejecuta Gemini CLI en tu terminal:
       ```bash theme={null}
       gemini
       ```

    2. Cuando se te pregunte **How would you like to authenticate for this project?**, selecciona **Sign in with Google**. Gemini abrirá una sesión del navegador.

    3. En el navegador, selecciona tu cuenta de Google e inicia sesión.

    Si todo sale bien, verás consejos para empezar y la línea de comandos.

    <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-startup-view.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=76d40e31a87646b8b53c7540d7bcd79c" alt="Captura de pantalla de la vista de inicio de Gemini CLI" width="2124" height="772" data-path="images/mcp/gemini-cli-startup-view.png" />
  </Step>

  <Step title="Añade el servidor de Profound MCP">
    1. Los servidores MCP se configuran en el archivo de configuración `~/.gemini/settings.json`. Para añadir el servidor de Profound, crea el bloque `mcpServers` con los detalles del servidor de Profound en `settings.json`:
       ```json theme={null}
         "mcpServers": {
           "profound": {
             "url": "https://mcp.tryprofound.com/mcp"
           }
         }
       ```
       Puedes hacerlo en tu editor de código preferido, o directamente desde Gemini CLI introduciendo el prompt:
       ```text theme={null}
       Add an MCP server called profound with url https://mcp.tryprofound.com/mcp
       ```

    2. Revisa los cambios y aplícalos si el bloque `mcpServers` es correcto.
           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-add-server-prompt.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=3fb9455f76c783cecbbfef87b017f109" alt="Captura de pantalla de Gemini CLI con el prompt para añadir un nuevo servidor MCP, un cambio en settings.json y la opción Apply this change - Allow once resaltada" width="2118" height="1478" data-path="images/mcp/gemini-cli-add-server-prompt.png" />

    3. Para que los cambios surtan efecto, cierra y vuelve a abrir Gemini CLI.

    4. Para verificar que se añadió el servidor, ejecuta el comando para listar los servidores MCP dentro de la CLI.

       ```bash theme={null}
         /mcp list
       ```

       Debería mostrar `profound` entre los servidores MCP configurados.

           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-server-added.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=c3e025c8441f3ebb942e06ba1bf11905" alt="Captura de pantalla de Gemini CLI con el servidor profound en la lista de servidores configurados" width="1084" height="331" data-path="images/mcp/gemini-cli-server-added.png" />
  </Step>

  <Step title="Inicia sesión en Profound">
    Profound se autentica con OAuth. Gemini CLI descubre automáticamente los endpoints de OAuth, por lo que no se necesitan claves de API, ID de cliente ni secreto.

    1. Dentro de la CLI, ejecuta el comando para autenticarte con Profound:

       ```bash theme={null}
       /mcp auth profound
       ```

    2. Selecciona **Yes** cuando se te pida autenticarte en el navegador. Esto abrirá el navegador en la página de inicio de sesión de Profound.
           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-auth-profound.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=ed557cad3e990f807e7046cc7bc02b64" alt="Captura de pantalla de Gemini CLI con el comando de autenticación y un cuadro de diálogo de autenticación con la opción Yes resaltada" width="2114" height="732" data-path="images/mcp/gemini-cli-auth-profound.png" />

    3. Si no has iniciado sesión, sigue las indicaciones para iniciar sesión en tu cuenta de Profound. Luego, aprueba el acceso.
           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-oauth.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=9a1874de714a746cb59a8224d20439b8" alt="Captura de pantalla del cuadro de diálogo de OAuth de Gemini CLI con la opción Allow access resaltada" style={{height: "30em", display: "block", margin: "0 auto"}} width="1182" height="1574" data-path="images/mcp/gemini-cli-oauth.png" />

    Cuando veas el mensaje de éxito, vuelve a la sesión de Gemini CLI en tu terminal.
  </Step>

  <Step title="Verifica la conexión">
    Todavía dentro de Gemini CLI, vuelve a ejecutar el comando de lista de MCP.

    ```bash theme={null}
      /mcp list
    ```

    Si el servidor de Profound aparece como **Ready** con un círculo verde y tiene herramientas disponibles en la lista, está conectado y listo para usarse.

    <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-profound-ready.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=5e602e680f2ba3321a39c9b8b9e1923f" alt="Captura de pantalla de Gemini CLI con el comando mcp list ejecutado y el servidor profound listado como listo " width="1382" height="477" data-path="images/mcp/gemini-cli-profound-ready.png" />
  </Step>
</Steps>

<Tip>
  Para obtener más detalles sobre cómo configurar conexiones a servidores MCP en Gemini CLI, consulta la [documentación de servidores MCP](https://geminicli.com/docs/tools/mcp-server) de Gemini CLI.
</Tip>

## Solución de problemas

### El navegador no se abre durante el inicio de sesión

Asegúrate de tener un navegador local instalado. OAuth no funciona en sesiones sin interfaz gráfica o remotas sin acceso a un navegador. Ejecuta la configuración en un lugar donde puedas abrir un navegador y vuelve a intentar iniciar sesión o autenticarte con Profound.

### El servidor de Profound aparece como desconectado

Vuelve a ejecutar `/mcp auth profound` para actualizar el token. Si sigue fallando, cierra sesión en Profound en tu navegador, vuelve a iniciarla y reinténtalo.
