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

# Démarrage rapide

> Suivez ce guide pour installer et intégrer Linkly AI en quelques minutes

Ce guide de démarrage rapide vous permettra de construire votre première base de connaissances locale prête pour l'IA en quelques minutes, et de découvrir les fonctionnalités de base.

## Avant de commencer

Linkly AI comprend les composants et fonctionnalités principaux suivants :

<CardGroup cols={2}>
  <Card title="Linkly AI Desktop" icon="desktop" iconType="duotone">
    Application de bureau (abrégée Linkly AI). Après l'installation, elle crée
    automatiquement l'index des documents et fournit des outils de recherche, de
    sommaire et de lecture.
  </Card>

  <Card title="Linkly AI CLI" icon="terminal" iconType="duotone">
    Outil en ligne de commande permettant de se connecter à votre application
    Linkly AI depuis le terminal et d'appeler ses outils. Idéal pour les AI
    Agents.
  </Card>

  <Card title="MCP Server" icon="plug" iconType="duotone">
    Protocole ouvert pour l'obtention de contexte par les Agents. Après
    l'installation de Linkly AI, le service MCP démarre automatiquement, adapté
    aux appels des AI Agents.
  </Card>

  <Card title="linkly-ai-skills" icon="wand-magic-sparkles" iconType="duotone">
    Skills officiels pour les Agents, guidant l'Agent dans la connexion et
    l'utilisation des outils de Linkly AI. Fortement recommandé.
  </Card>
</CardGroup>

## Étape 1 : Installer Linkly AI

Rendez-vous sur la page de téléchargement du site officiel et choisissez la version correspondant à votre système d'exploitation :

<Card title="Télécharger Linkly AI" icon="download" href="https://linkly.ai/#download">
  Choisissez la version adaptée à votre système d'exploitation
</Card>

Ensuite, double-cliquez sur le programme d'installation. Voici les étapes pour chaque plateforme :

<Tabs>
  <Tab title="macOS" icon="apple">
    <Steps>
      <Step title="Ouvrir le programme d'installation">
        Double-cliquez sur le fichier `.dmg` téléchargé pour monter l'image
        disque
      </Step>

      <Step title="Glisser dans Applications">
        Faites glisser l'icône **LinklyAI** dans le dossier **Applications**
      </Step>

      <Step title="Lancer l'application">
        Trouvez **LinklyAI** dans le Launchpad ou le dossier Applications du
        Finder, puis double-cliquez pour lancer
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows" icon="windows">
    <Steps>
      <Step title="Exécuter le programme d'installation">
        Double-cliquez sur le fichier `.exe` téléchargé
      </Step>

      <Step title="Terminer l'installation">
        Suivez les instructions de l'assistant d'installation. L'installation se
        fait par défaut dans le répertoire utilisateur
      </Step>

      <Step title="Lancer l'application">
        Lancez **LinklyAI** depuis le menu Démarrer ou le raccourci sur le
        bureau
      </Step>
    </Steps>
  </Tab>

  <Tab title="Linux" icon="linux">
    <Steps>
      <Step title="Méthode AppImage">
        `bash chmod +x LinklyAI-*.AppImage ./LinklyAI-*.AppImage `
      </Step>

      <Step title="Ou méthode paquet DEB">
        `bash sudo dpkg -i linkly-ai-*.deb `
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Étape 2 : Initialiser Linkly AI

Lors du premier lancement de Linkly AI, un assistant de configuration vous guidera à travers 3 étapes d'initialisation :

<Steps>
  <Step title="Choisir les répertoires à indexer">
    Sélectionnez les répertoires de documents que vous souhaitez indexer avec Linkly AI :

    * **Mes documents** : indexe uniquement les documents dans le répertoire `~/Documents`
    * **Tout l'ordinateur** : analyse tous les documents accessibles, couverture maximale, nécessite une autorisation
    * **Dossier personnalisé** : sélectionnez manuellement un dossier spécifique
  </Step>

  <Step title="Vérifier les permissions d'accès">
    Le système vérifie automatiquement les permissions d'accès au dossier sélectionné. Si les permissions sont insuffisantes (courant sous macOS), rendez-vous dans **Réglages du système → Confidentialité et sécurité → Accès complet au disque**, ajoutez Linkly AI, puis redémarrez l'application.
  </Step>

  <Step title="Connecter vos outils IA">
    Ajoutez le service MCP de Linkly AI à vos outils IA habituels pour activer la recherche documentaire intelligente.

    <Card>
      Nous vous recommandons d'utiliser les Skills pour faciliter l'intégration. C'est la méthode la plus simple : copiez simplement le Prompt suivant dans votre assistant IA et suivez les instructions pour compléter l'intégration des outils et des Skills :

      <Prompt description="Veuillez installer l'Agent Skill linkly-ai-skills et...">
        Veuillez installer l'Agent Skill linkly-ai-skills et compléter l'intégration des outils LinklyAI, en suivant : [https://linkly.ai/docs/fr/use-skills](https://linkly.ai/docs/fr/use-skills)
      </Prompt>
    </Card>

    Vous pouvez également intégrer manuellement les outils MCP, mais nous vous recommandons toujours d'[installer les Skills](use-skills) pour une meilleure expérience :

    <Tabs>
      <Tab title="Claude Code">
        Exécutez dans le terminal :

        ```bash theme={null}
        claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
        ```
      </Tab>

      <Tab title="Cursor">
        1. Ouvrez Settings → MCP Servers → Add Server
        2. Name: `linkly-ai`
        3. Type: `StreamableHTTP`
        4. URL: `http://127.0.0.1:60606/mcp`
      </Tab>

      <Tab title="Codex">
        Exécutez dans le terminal :

        ```bash theme={null}
        codex mcp add linkly-ai --url http://127.0.0.1:60606/mcp
        ```
      </Tab>

      <Tab title="Cherry Studio">
        1. Ouvrez Settings → MCP Servers → Add
        2. Name: `linkly-ai`
        3. Type: `StreamableHTTP`
        4. URL: `http://127.0.0.1:60606/mcp`
      </Tab>
    </Tabs>

    <Tip>Le port `60606` est le port par défaut du service MCP de Linkly AI. Si la connexion échoue, vérifiez le numéro de port réel dans les paramètres de l'application.</Tip>
  </Step>
</Steps>

## Étape 3 : Première utilisation

Après le lancement, Linkly AI commence immédiatement à indexer vos documents et à les surveiller en continu. L'indexation complète prend entre quelques minutes et quelques dizaines de minutes (selon le nombre de documents et les performances de la machine).

<Note>
  Au premier lancement, un fichier modèle d'environ 100 Mo doit être téléchargé, ce qui peut prendre de quelques minutes à quelques dizaines de minutes. Cela n'affecte pas l'utilisation de la recherche par mots-clés.

  Une fois le téléchargement terminé et l'indexation complète achevée, la recherche en langage naturel sera disponible.
</Note>

Vous pouvez utiliser LinklyAI de deux manières :

<Card title="Rechercher des documents avec le lanceur" icon="keyboard">
  Vous pouvez cliquer sur l'icône de l'application dans la barre des tâches (Logo L), ou utiliser le raccourci global `CMD/Ctrl + Shift + L` pour ouvrir la fenêtre du lanceur de recherche. Saisissez des mots-clés ou une description en langage naturel pour trouver vos documents cibles.

  Vous pouvez également prévisualiser, consulter les métadonnées, ouvrir le document, copier le lien, etc. Pour plus d'informations, consultez la [documentation du lanceur de recherche plein texte](use-launcher).
</Card>

<Card title="Utiliser avec un AI Agent" icon="robot">
  C'est la méthode que nous recommandons le plus. Vous bénéficierez d'une expérience d'interaction et d'une efficacité de recherche sans précédent.

  Après avoir complété l'intégration avec votre assistant IA ou installé les [Skills](use-skills), ajoutez simplement `use linkly-ai` après n'importe quel Prompt pour exploiter activement les puissantes capacités de recherche de Linkly AI.
</Card>