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

# Usar Linkly AI en Gemini CLI

> Integra la base de conocimiento local de Linkly AI en Google Gemini CLI para que el agente de IA en la terminal pueda buscar y leer tus documentos privados

## Requisitos previos

* [Gemini CLI](https://github.com/google-gemini/gemini-cli) instalado
* Linkly AI Desktop iniciado con el servicio MCP en ejecución

<CodeGroup>
  ```bash Instalar via npm theme={null}
  npm install -g @google/gemini-cli
  ```

  ```bash Instalar via Homebrew (macOS) theme={null}
  brew install google-gemini/gemini-cli/gemini-cli
  ```
</CodeGroup>

## Pasos de configuración

<Tabs>
  <Tab title="MCP HTTP (recomendado)" icon="globe">
    Edita `~/.gemini/settings.json` y agrega en `mcpServers`:

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "httpUrl": "http://127.0.0.1:60606/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="MCP Stdio" icon="terminal">
    Primero debes [instalar Linkly AI CLI](/docs/es/use-cli).

    Edita `~/.gemini/settings.json` y agrega en `mcpServers`:

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "command": "linkly",
          "args": ["mcp"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Acceso remoto" icon="globe">
    Primero completa la [configuración de acceso remoto](/docs/es/use-in-remote), con el túnel de escritorio mostrando{" "}

    <Badge stroke color="green">
      ● Conectado
    </Badge>

    .

    Edita `~/.gemini/settings.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "httpUrl": "https://mcp.linkly.ai/mcp",
          "headers": {
            "Authorization": "Bearer <tu API Key>"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Tip>
  El archivo de configuración admite la sintaxis `${env:VAR_NAME}` para leer variables de entorno, evitando escribir la API Key en texto plano:

  ```json theme={null}
  "Authorization": "Bearer ${env:LINKLY_API_KEY}"
  ```
</Tip>

## Empezar a usar

Una vez completada la configuración, inicia Gemini CLI y haz preguntas directamente:

```bash theme={null}
gemini
> Busca en mis documentos contenido sobre arquitectura del proyecto
```

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="El archivo de configuración no existe">
    La primera ejecución de `gemini` creará automáticamente el directorio
    `~/.gemini/`. También puedes crearlo manualmente: `bash mkdir -p ~/.gemini
            && touch ~/.gemini/settings.json `
  </Accordion>

  <Accordion title="Las herramientas no son invocadas">
    Ejecuta el comando `/mcp` en Gemini CLI para ver la lista de servidores MCP
    cargados y confirmar que linkly-ai aparece en ella.
  </Accordion>
</AccordionGroup>