Comment configurer Raycast AI Tools sur macOS pour interagir avec des extensions tierces et des applications locales

Pour les développeurs, ingénieurs et utilisateurs chevronnés sur macOS, Raycast s'est imposé comme le centre névralgique de la productivité quotidienne. Pourtant, de nombreux utilisateurs continuent d'utiliser Raycast AI comme un simple chatbot textuel isolé : l'IA génère des réponses ou du code, mais l'utilisateur doit toujours basculer manuellement entre GitHub, Linear, Notion, le terminal et le Finder pour appliquer ces résultats.

Raycast élimine cette friction grâce aux AI Tools (également désignées sous le nom d'AI Extensions dans le manuel officiel). En intégrant l'appel de fonctions natif (Function Calling) directement dans AI Chat et Quick AI, les grands modèles de langage modernes tels que Claude 3.5 Sonnet et GPT-4o peuvent découvrir, interroger et déclencher des actions de manière autonome au sein d'extensions SaaS tierces et d'outils locaux du système.

Ce guide explique en détail comment installer des extensions compatibles, orchestrer des requêtes multi-outils grâce à la syntaxe @, définir des règles de sécurité avec Auto-review, affiner les réponses avec des instructions personnalisées et connecter des serveurs MCP (Model Context Protocol) pour faire de votre Mac un véritable hub d'agents de bureau.

1. Prérequis et principes de fonctionnement

Avant de configurer les AI Tools, assurez-vous de disposer des éléments requis :

• Abonnement Raycast Pro : L'accès aux AI Tools et l'utilisation complète d'AI Chat nécessitent un abonnement Raycast Pro. Cet abonnement donne accès aux modèles de pointe (comme Claude 3.5 Sonnet et GPT-4o), à des fenêtres de contexte étendues et au moteur d'exécution d'outils.
• Sélection d'un modèle prenant en charge les outils : Tous les modèles ne gèrent pas les appels de fonctions avec la même rigueur. Dans Settings → AI → Models ou dans le panneau latéral d'AI Chat, vérifiez qu'un modèle doté de capacités natives d'appel d'outils et de raisonnement complexe est actif.
• Commandes classiques vs AI Tools : Les commandes Raycast habituelles ouvrent des interfaces graphiques dans le lanceur (listes, formulaires). À l'inverse, les AI Tools sont des fonctions d'arrière-plan sans interface déclarées par les extensions, que le modèle appelle en fournissant automatiquement des arguments structurés en fonction de votre demande.

2. Découvrir et installer des extensions compatibles avec les outils

Raycast comprend une suite d'outils système intégrés prêts à l'emploi et permet d'installer des intégrations tierces depuis le Raycast Store.

Outils système natifs sous macOS

Les outils suivants sont disponibles sans installation supplémentaire :

• @finder : Recherche, examine et gère les fichiers et répertoires locaux dans le Finder.
• @file-search : Recherche ultra-rapide de fichiers locaux basée sur l'indexation système.
• @terminal : Exécute des scripts et commandes shell et permet à l'IA d'analyser directement les retours de la console.
• @clipboard : Interroge l'historique du presse-papiers, extrait des éléments et modifie le contenu actif.
• @browser : Lit et analyse le DOM de l'onglet actif dans votre navigateur (nécessite l'extension gratuite Raycast Browser Companion).
• @screen-awareness : Capture le contexte de l'application au premier plan, le texte sélectionné et des captures d'écran.
• @calendar : Consulte les réunions à venir, les créneaux disponibles et les plannings.
• @raycast-notes : Recherche, crée et complète des notes dans Raycast Notes.

Installer des extensions tierces depuis le Raycast Store

Pour connecter Raycast AI à des services collaboratifs tels que GitHub, Linear, Jira ou Notion :

1. Ouvrez le champ de recherche Raycast à l'aide de votre raccourci (par exemple ⌥ Espace ou ⌘ Espace).
2. Tapez Store et appuyez sur Entrée.
3. Appuyez sur ⌘ P dans la barre de navigation pour ouvrir le filtre des catégories.
4. Sélectionnez la catégorie AI Extensions. Cela isole uniquement les extensions qui implémentent des outils utilisables par l'IA.
5. Choisissez l'extension souhaitée (par exemple GitHub, Linear, Notion, Todoist ou Spotify) et appuyez sur Entrée pour l'installer.
6. Procédez à l'authentification. Suivez les instructions pour vous connecter en OAuth dans votre navigateur ou renseignez votre jeton d'accès personnel (PAT / clé API) dans les paramètres de l'extension.

3. Déclencher et chaîner des outils dans AI Chat

Dès qu'une extension est installée, ses outils sont enregistrés dans le contexte et utilisables dans AI Chat (commande AI Chat ou via ⌘ J depuis Quick AI).

La syntaxe de mention @

Dans la zone de saisie d'AI Chat, tapez @. Un menu déroulant affiche l'ensemble des outils et extensions disponibles sur votre Mac. Sélectionnez-en un ou poursuivez la saisie de son identifiant :

@github Liste les pull requests ouvertes où ma revue est requise et résume les commentaires bloquants.

@linear Crée un ticket intitulé "Mettre en place un rate limiting sur les webhooks" avec une priorité haute dans l'équipe Platform pour le cycle actif.

@browser Résume la page de documentation d'API ouverte dans mon navigateur et mets en évidence les changements cassants.

Lorsque vous validez par Entrée, le modèle détermine les paramètres nécessaires et exécute l'outil en arrière-plan. Une carte d'état apparaît dans le fil de discussion, affichant les arguments envoyés et les données structurées reçues.

Chaîner plusieurs outils dans un seul prompt

La véritable force de cette approche réside dans la coordination de plusieurs services au sein d'une même requête :

@calendar @linear Vérifie si j'ai un créneau libre de plus d'une heure cet après-midi ; si oui, liste mes tickets Linear en cours dans le sprint actuel.

@terminal @github Vérifie le git status dans mon répertoire actuel, résume les commits récents et prépare une description standard de PR pour GitHub.

Le modèle élabore un plan séquentiel : il interroge d'abord le calendrier ou l'état Git local, consolide les sorties intermédiaires dans son contexte, puis exécute l'action suivante sans nécessiter de copier-coller manuel.

4. Gestion des permissions, règles d'Auto-review et sécurité

Comme les AI Tools peuvent lancer des commandes shell, modifier des fichiers locaux ou altérer des données sur vos plateformes cloud, Raycast fournit un cadre de contrôle précis pour prévenir les effets de bord indésirables.

Niveaux de permission globaux

Rendez-vous dans Settings → AI → Tools pour choisir votre niveau de sécurité global :

Critères d'arbitrage du mode Auto

Le moteur Auto applique des critères stricts :

• Approuvé automatiquement sans invite : Consultations en lecture seule (lire des tickets, vérifier le calendrier, rechercher des fichiers), modifications de fichiers limitées au répertoire de travail actif du chat, et commandes courantes de développement (telles que git status, git log, npm test).
• Pause obligatoire avec confirmation : Actions destructives (supprimer des fichiers, vider des tables de base de données, fermer des tickets en masse), scripts modifiant la configuration système, et tentatives de lecture de fichiers d'identifiants (fichiers .env, clés SSH privées ou clés cloud).

Vous pouvez affiner ces règles en langage naturel dans Settings → AI → Tools sous Auto-review Rules, en liant des actions spécifiques à "Allow automatically" ou "Ask first".

Interaction avec les invites d'approbation

Lorsqu'un appel d'outil nécessite une autorisation, le chat s'interrompt et présente une carte descriptive :

• Touche Entrée : Autoriser une fois (Allow), pour cette exécution précise.
• Touches ⌘ Entrée : Toujours autoriser (Always Allow). L'outil est consigné dans Globally Allowed Tools, supprimant les futures demandes.
• Touche Échap : Refuser (Deny). L'IA est notifiée du refus et poursuit la conversation sans exécuter l'outil.
• Pour les commandes via @terminal, cliquez sur Show Command afin de vérifier la commande exacte avant de l'autoriser.

Remplacement des permissions par conversation

Si vous souhaitez adopter une politique de sécurité distincte pour une session précise, il n'est pas nécessaire de modifier vos réglages globaux. Ouvrez la barre latérale de réglages dans AI Chat (ou tapez ⌘ K et choisissez Change Permissions…) pour basculer ce chat sur Inherited, Ask, Auto ou Always Allow.

5. Piloter le comportement des outils avec les Custom Instructions

Lors de l'utilisation d'outils comme Linear ou GitHub, le modèle ne connaît pas les conventions spécifiques de votre équipe. Raycast permet de définir des Custom Instructions propres à chaque extension :

1. Accédez à Raycast Settings → Extensions.
2. Sélectionnez l'extension voulue dans la liste de gauche (par exemple Linear ou Calendar).
3. Dans le panneau de droite, repérez l'outil généralement nommé Ask.
4. Dépliez cet outil et localisez le champ Custom Instructions.
5. Renseignez les règles et directives que l'IA doit respecter lorsqu'elle utilise cette extension.

Exemples d'instructions éprouvées

Pour Linear :

Cible systématiquement les recherches et créations de tickets sur l'équipe "Platform Engineering". Lors de la création, attribue par défaut la priorité "Medium" sauf indication contraire, et rattache le ticket au cycle actif.

Pour Calendar :

Ne planifie et ne propose aucun rendez-vous avant 10h00 ou après 17h30. Conserve toujours un intervalle de sécurité d'au moins 15 minutes entre deux réunions consécutives.

Pour GitHub :

Limite la recherche de pull requests aux dépôts de l'organisation "octocorp-dev". Ignore les PR générées automatiquement par dependabot lors de la compilation des revues en attente.

Une fois ces règles enregistrées, Raycast les transmet automatiquement dans le contexte système dès que vous mentionnez @linear ou @calendar, évitant d'avoir à repréciser ces contraintes à chaque échange.

6. Extension avancée : Serveurs Model Context Protocol (MCP)

Si les extensions du Store ne suffisent pas pour interagir avec des bases de données privées, des microservices locaux ou des outils internes, vous pouvez connecter des serveurs Model Context Protocol (MCP) à Raycast AI.

1. Lancez la commande Install MCP Server dans Raycast (ou ouvrez Manage MCP Servers → Install New Server).
2. Configurez les paramètres du serveur :
   • Name & Icon : Nom et icône sous lesquels le serveur sera mentionné avec @.
   • Transport : Choisissez Standard Input/Output (stdio) pour les processus locaux ou HTTP pour les serveurs distants.
   • Command & Arguments : Pour les outils locaux en ligne de commande, spécifiez l'exécutable et ses arguments (par exemple npx -y @modelcontextprotocol/server-postgres ou un script Python local).
   • Environment : Déclarez les variables d'environnement nécessaires (chaînes de connexion, clés API).
3. Enregistrez avec ⌘ Entrée. Raycast lance le processus en arrière-plan et découvre la liste des outils exposés via le protocole JSON-RPC.

Une fois configurés, les serveurs MCP fonctionnent exactement comme des extensions natives : vous pouvez taper @postgres Calcule le nombre d'utilisateurs actifs sur les 7 derniers jours tout en bénéficiant de la même gestion stricte des autorisations.

7. Bonnes pratiques pour maximiser votre efficacité

• Attribuez un raccourci global à AI Chat : Dans Settings → Extensions → AI → AI Chat, associez un raccourci dédié (comme ⌥ C ou ⌃ Espace) pour faire apparaître instantanément votre console d'outils depuis n'importe quel écran.
• Associez la conscience d'écran au texte sélectionné : Surlignez un message d'erreur dans votre éditeur ou terminal, ouvrez Quick AI et saisissez @github cherche des issues résolues contenant cette erreur pour relier votre contexte local à vos services SaaS sans manipulation intermédiaire.
• Auditez périodiquement la liste des outils autorisés : Consultez régulièrement Settings → AI → Tools → See Allow List. Si une extension a été mise à jour ou si vos exigences de sécurité évoluent, cliquez sur Reset All pour rétablir les demandes de confirmation systématiques.

En configurant soigneusement Raycast AI Tools, vous transformez un simple lanceur applicatif en un véritable agent de bureau autonome, capable d'orchestrer l'ensemble de votre environnement macOS et de vos outils de travail au clavier.

Références

• AI Extensions | Raycast Manual
• AI Chat | Raycast Manual
• Model Context Protocol | Raycast Manual
• AI | Raycast Manual