> ## 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 GitHub Copilot

> Intégrez votre base de connaissances locale Linkly AI à GitHub Copilot pour que l'assistant IA de programmation puisse rechercher et lire vos documents privés

## Prérequis

* [VS Code](https://code.visualstudio.com) installé avec l'extension GitHub Copilot activée
* Linkly AI Desktop démarré, service MCP en cours d'exécution

## Étapes de configuration

<Tabs>
  <Tab title="MCP HTTP (recommandé)" icon="globe">
    <Steps>
      <Step title="Ouvrir la palette de commandes">
        Dans VS Code, appuyez sur `Cmd+Shift+P` (macOS) ou `Ctrl+Shift+P` (Windows), puis tapez `MCP: Add Server`.
      </Step>

      <Step title="Sélectionner le type HTTP et renseigner les informations">
        Sélectionnez **HTTP or HTTPS endpoint** et renseignez :

        * URL : `http://127.0.0.1:60606/mcp`
        * Server ID : `linkly-ai`

        Choisissez l'emplacement de sauvegarde (User Settings pour une portée globale, Workspace Settings pour le projet actuel uniquement).
      </Step>
    </Steps>

    Vous pouvez également éditer directement le fichier de configuration en ajoutant dans `.vscode/mcp.json` ou dans la configuration MCP utilisateur :

    ```json theme={null}
    {
      "servers": {
        "linkly-ai": {
          "url": "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).

    Ajoutez dans `.vscode/mcp.json` ou dans la configuration MCP utilisateur :

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

<Tip>
  Il est recommandé d'[installer également les Linkly AI Skills](/docs/fr/use-skills)
  pour apprendre à l'assistant IA comment utiliser efficacement les outils de
  Linkly AI et améliorer les performances de recherche et de lecture.
</Tip>

## Commencer à utiliser

Une fois la configuration terminée, posez directement vos questions dans Copilot Chat (`Cmd+Shift+I`). GitHub Copilot appellera automatiquement les outils Linkly AI. Par exemple :

* "Recherche dans mes documents le contenu relatif à la conception de base de données"
* "Lis la documentation API du projet"

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Les outils Linkly AI ne sont pas visibles">
    Exécutez `MCP: List Servers` dans la palette de commandes et confirmez que
    le statut du serveur linkly-ai est Running. Si une erreur s'affiche,
    vérifiez que Linkly AI Desktop est démarré.
  </Accordion>

  <Accordion title="Différence entre Workspace Settings et User Settings">
    * **User Settings** : s'applique à tous les projets, adapté à un usage
      personnel - **Workspace Settings** (`.vscode/mcp.json`) : s'applique
      uniquement au projet actuel, peut être commité dans Git pour un partage en
      équipe
  </Accordion>
</AccordionGroup>