> ## 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.

# Utiliser Linkly AI dans Gemini CLI

> Intégrez votre base de connaissances locale Linkly AI à Google Gemini CLI pour que l'agent IA en terminal puisse rechercher et lire vos documents privés

## Prérequis

* [Gemini CLI](https://github.com/google-gemini/gemini-cli) installé
* Linkly AI Desktop démarré, service MCP en cours d'exécution

<CodeGroup>
  `bash Installation via npm npm install -g @google/gemini-cli ` `bash
      Installation via Homebrew (macOS) brew install
      google-gemini/gemini-cli/gemini-cli `
</CodeGroup>

## Étapes de configuration

<Tabs>
  <Tab title="MCP HTTP (recommandé)" icon="globe">
    Éditez `~/.gemini/settings.json` et ajoutez dans `mcpServers` :

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

  <Tab title="MCP Stdio" icon="terminal">
    Vous devez d'abord [installer Linkly AI CLI](/docs/fr/use-cli).

    Éditez `~/.gemini/settings.json` et ajoutez dans `mcpServers` :

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

  <Tab title="Accès distant" icon="globe">
    Vous devez d'abord effectuer la [configuration de l'accès distant](/docs/fr/use-in-remote), et le tunnel de l'application de bureau doit afficher{" "}

    <Badge stroke color="green">
      ● Connecté
    </Badge>

    .

    Éditez `~/.gemini/settings.json` :

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

<Tip>
  Le fichier de configuration supporte la syntaxe `${env:VAR_NAME}` pour lire les variables d'environnement, évitant d'écrire l'API Key en clair dans le fichier :

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

## Commencer à utiliser

Une fois la configuration terminée, démarrez Gemini CLI et posez directement vos questions :

```bash theme={null}
gemini
> Recherche dans mes documents le contenu relatif à l'architecture du projet
```

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Le fichier de configuration n'existe pas">
    La première exécution de `gemini` crée automatiquement le répertoire
    `~/.gemini/`. Vous pouvez également le créer manuellement : `bash mkdir -p     ~/.gemini && touch ~/.gemini/settings.json `
  </Accordion>

  <Accordion title="Les outils ne sont pas appelés">
    Exécutez la commande `/mcp` dans Gemini CLI pour afficher la liste des
    serveurs MCP chargés et confirmez que linkly-ai y figure.
  </Accordion>
</AccordionGroup>