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

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

## Prérequis

* [Windsurf](https://windsurf.com) installé
* Linkly AI Desktop démarré, service MCP en cours d'exécution

## Étapes de configuration

<Tabs>
  <Tab title="MCP HTTP (recommandé)" icon="globe">
    Éditez le fichier de configuration MCP et ajoutez dans `mcpServers` :

    <CodeGroup>
      ```json macOS / Linux theme={null}
      // ~/.codeium/windsurf/mcp_config.json
      {
        "mcpServers": {
          "linkly-ai": {
            "serverUrl": "http://127.0.0.1:60606/mcp"
          }
        }
      }
      ```

      ```json Windows theme={null}
      // %USERPROFILE%\.codeium\windsurf\mcp_config.json
      {
        "mcpServers": {
          "linkly-ai": {
            "serverUrl": "http://127.0.0.1:60606/mcp"
          }
        }
      }
      ```
    </CodeGroup>

    Enregistrez et redémarrez Windsurf.
  </Tab>

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

    Éditez le fichier de configuration et ajoutez dans `mcpServers` :

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

    Enregistrez et redémarrez Windsurf.
  </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>

    .

    ```json theme={null}
    {
      "mcpServers": {
        "linkly-ai": {
          "serverUrl": "https://mcp.linkly.ai/mcp",
          "headers": {
            "Authorization": "Bearer ${env:LINKLY_API_KEY}"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Tip>
  Le fichier de configuration supporte la syntaxe `${env:VAR_NAME}` pour gérer l'API Key via des variables d'environnement, évitant ainsi de l'écrire en clair dans le fichier de configuration.
</Tip>

## Commencer à utiliser

Une fois la configuration terminée, posez directement vos questions dans le panneau Cascade de Windsurf. Cascade appellera automatiquement les outils Linkly AI. Par exemple :

* "Recherche dans mes documents le contenu relatif à la conception d'API"
* "Lis le document de spécifications du projet et résume les points clés"

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Les outils n'apparaissent pas dans Cascade">
    Confirmez que Windsurf a bien redémarré complètement (pas seulement fermer
    la fenêtre) et que le format JSON du fichier de configuration est correct.
    Vous pouvez consulter l'état du serveur MCP dans les paramètres de Cascade.
  </Accordion>

  <Accordion title="Limite du nombre d'outils">
    Windsurf Cascade supporte au maximum 100 outils (au total de tous les
    serveurs MCP). Si le nombre total d'outils dépasse cette limite, certains
    outils pourraient ne pas être disponibles.
  </Accordion>
</AccordionGroup>