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

> Intégrez votre base de connaissances locale Linkly AI à Raycast AI pour que cet outil de productivité macOS puisse rechercher et lire vos documents privés

## Prérequis

* [Raycast](https://raycast.com) installé (abonnement Raycast Pro requis pour les fonctionnalités IA)
* [Linkly AI CLI](/docs/fr/use-cli) installé (Raycast ne supporte que le transport Stdio, le CLI est obligatoire)
* Linkly AI Desktop démarré, service MCP en cours d'exécution

## Étapes de configuration

<Steps>
  <Step title="Ouvrir l'extension MCP">
    Dans Raycast, recherchez **Install Server**, ou rendez-vous dans le
    **Raycast Store** pour installer l'extension MCP (si elle n'est pas encore
    installée).
  </Step>

  <Step title="Ajouter Linkly AI">
    Exécutez la commande **Install Server** et renseignez : - **Name** :
    `linkly-ai` - **Type** : `stdio` - **Command** : `linkly` - **Arguments** :
    `mcp`
  </Step>

  <Step title="Redémarrer Raycast">
    Après avoir enregistré, quittez complètement et redémarrez Raycast pour que
    la configuration prenne effet.
  </Step>
</Steps>

<Note>
  Raycast **ne supporte actuellement que le transport Stdio**, pas la méthode
  par URL HTTP. Il est donc obligatoire d'installer d'abord le Linkly AI CLI,
  qui servira de passerelle pour communiquer avec l'application de bureau.
</Note>

## Commencer à utiliser

Une fois la configuration terminée, dans Raycast AI Chat, tapez `@linkly-ai` pour invoquer l'outil, ou posez directement votre question — Raycast appellera automatiquement les outils Linkly AI. Par exemple :

* "Recherche dans mes documents le contenu relatif à la conception produit"
* "@linkly-ai read my project readme"

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Message indiquant que la commande linkly est introuvable">
    Raycast utilise un environnement PATH indépendant. Assurez-vous que la
    commande `linkly` est installée dans un chemin standard (comme
    `/usr/local/bin` ou `/opt/homebrew/bin`). Exécutez `which linkly` dans le
    terminal pour confirmer le chemin, et assurez-vous que ce chemin est inclus
    dans le PATH de Raycast. Une modification du PATH nécessite un redémarrage
    complet de Raycast pour prendre effet.
  </Accordion>

  <Accordion title="Liste d'outils vide">
    Confirmez que Linkly AI Desktop est démarré et que le service MCP est en
    cours d'exécution. Raycast se connecte au CLI à chaque appel, l'application
    de bureau doit donc être en cours d'exécution.
  </Accordion>
</AccordionGroup>