Extensions et intégrations

Périmètre : principalement l’application de bureau actuelle. La configuration MCP personnalisée inclut aussi une méthode CLI. Les exemples d’utilisation du navigateur et de l’ordinateur concernent l’application de bureau macOS.

Utilisez les règles du projet, les Skills, les plugins et les services MCP pour adapter Remy à votre travail et connecter les outils nécessaires. Après l’installation, vérifiez que la fonctionnalité est activée, que les autorisations requises sont accordées et qu’elle fonctionne dans une tâche réelle.

1. Choisir la bonne extension

MCP permet de connecter des outils et des services. Ce que Remy peut lire ou faire via une connexion dépend des capacités du service, du compte connecté et de l’accès accordé.

2. Installer et gérer les plugins

2.1 Installer depuis le catalogue

1. Ouvrez Paramètres → Plugins.
2. Cliquez sur Parcourir et trouvez le plugin dans le catalogue.
3. Ouvrez ses détails pour examiner son objectif, sa source et les fonctionnalités incluses.
4. Cliquez sur le bouton d’installation et attendez le résultat.
5. Si une connexion ou une autre configuration est nécessaire, suivez les instructions dans les détails.
6. Lorsque Essayer maintenant est disponible, cliquez dessus pour lancer une tâche et expliquez ce que vous souhaitez faire.

Par exemple, lorsque vous essayez un service de sources pour la première fois, commencez par une tâche de lecture ciblée :

Utilise le service que je viens de connecter pour trouver les documents d’intégration au projet auxquels j’ai le droit d’accéder.
Énumère leurs titres, sources et une brève description. Lecture seule ; ne crée, ne modifie et ne supprime aucun contenu.

Vérifiez les sources renvoyées pour confirmer le compte et les éléments avant de passer à des tâches plus complexes.

2.2 Vérifier si une fonctionnalité est activée

Dans Paramètres → Plugins, filtrez par type, source ou statut. Ouvrez les détails d’un élément pour examiner son état d’activation et les messages éventuels.

Un plugin, les Skills qu’il fournit et ses services MCP peuvent avoir des interrupteurs distincts. Un élément enfant peut rester indisponible si le plugin parent est désactivé, même si son propre interrupteur est activé. Fiez-vous à l’état effectif et à son explication plutôt qu’à un seul interrupteur.

Les politiques de l’organisation peuvent restreindre les fonctionnalités gérées par une équipe. Si une action est indisponible, lisez la raison et contactez l’administrateur de l’équipe.

2.3 Désactiver, désinstaller ou déconnecter

Désactiver, désinstaller et déconnecter sont des actions différentes. Pour mettre fin à l’autorisation d’un service externe, vérifiez aussi ses propres contrôles d’accès. Désactiver une fonctionnalité ne signifie pas que toutes les autorisations ont été révoquées.

3. Installer et utiliser un Skill

3.1 Installer un Skill existant

1. Ouvrez Paramètres → Plugins et filtrez par Skill.
2. Cliquez sur Installer un Skill….
3. Sélectionnez le dossier du Skill ou le fichier .skill fourni et attendez l’installation.
4. Ouvrez les détails du Skill et lisez son objectif et ses exigences.
5. Vérifiez qu’il est disponible, cliquez sur Essayer maintenant et saisissez une tâche réelle.

Pour un Skill fourni par un plugin, utilisez les commandes d’installation et de gestion de ce plugin. Si Désinstaller est indisponible, vérifiez la source du Skill et les informations de gestion.

3.2 Créer votre propre Skill

Si Créer un Skill est disponible sous le filtre Skill, cliquez dessus et expliquez dans la nouvelle conversation :

• La tâche que vous répétez.
• Les étapes ou références à suivre.
• La structure de sortie et les critères d’achèvement requis.

Par exemple :

Aide-moi à créer un Skill pour préparer les rapports hebdomadaires.
L’entrée est constituée des notes de travail que je fournis. La sortie doit inclure le travail terminé, les problèmes actuels et les projets pour la semaine suivante.
N’invente pas d’avancement, de responsables ni de dates. Indique les informations manquantes comme étant à confirmer.
Pose-moi d’abord les questions nécessaires sur les exigences, puis crée le Skill et explique comment l’essayer.

Essayez-le avec un petit ensemble d’éléments réels et vérifiez qu’il fonctionne comme prévu. Une installation ou création réussie ne signifie pas qu’il sera utilisé automatiquement pour chaque tâche. Vous pouvez nommer explicitement le Skill dans votre demande.

4. Connecter un service MCP

4.1 Utiliser un service fourni par un plugin

1. Installez le plugin et ouvrez l’entrée de son service MCP dans ses détails.
2. Si une autorisation de compte est nécessaire, cliquez sur Non connecté ou poursuivez le parcours de connexion ouvert après l’installation.
3. Vérifiez le compte et les autorisations sur la page d’autorisation. Terminez la connexion et revenez à Remy.
4. Attendez Connecté, puis exécutez une petite tâche pour vérifier que le service peut lire ou agir comme prévu.

Un service ne nécessitant pas de connexion de compte peut ne pas afficher de bouton d’autorisation. S’il nécessite une configuration supplémentaire, suivez ses instructions de configuration.

4.2 Ajouter un service personnalisé via le CLI

Suivez le guide CLI pour installer le CLI et vous connecter. Obtenez l’objet de configuration JSON d’un seul service MCP auprès de son fournisseur et enregistrez-le dans un fichier local, par exemple my-mcp-server.json.

Remplacez le chemin du projet, l’identifiant du service et le chemin du fichier de configuration ci-dessous par vos valeurs :

remy --workspace "/path/to/project" config mcp list
remy --workspace "/path/to/project" config mcp set my-server --file "./my-mcp-server.json"
remy --workspace "/path/to/project" config mcp show my-server

set crée ou remplace un service personnalisé portant cet identifiant. Vérifiez l’existence d’une configuration avant de l’exécuter. Ne l’utilisez pas pour écraser un service appartenant à un plugin.

Pour activer ou désactiver le service :

remy --workspace "/path/to/project" config mcp enable my-server
remy --workspace "/path/to/project" config mcp disable my-server

Ces commandes activent et désactivent respectivement le service ; choisissez celle qui vous convient. Examinez le résultat de la commande et le périmètre indiqué. La configuration doit être lue par une nouvelle session d’exécution. Rechargez l’environnement d’exécution ou redémarrez une session Desktop ou CLI existante avant de vérifier le changement.

Les fichiers de configuration peuvent contenir des identifiants. Ne placez pas de véritables secrets directement dans les arguments de commande ou les messages de conversation. Enregistrer la configuration ne confirme pas que le service distant est connecté. Vérifiez ses exigences d’exécution, son autorisation et un appel d’outil réel.

5. Utiliser les règles du projet

Si votre projet contient des instructions comme AGENTS.md ou CLAUDE.md, demandez à Remy de lire les consignes applicables avant de commencer. Les règles doivent expliquer la structure du projet, le périmètre des modifications, les vérifications et les exigences de livraison.

Lis d’abord les fichiers AGENTS.md, CLAUDE.md et README applicables dans ce projet.
Résume les conventions et vérifications pertinentes pour cette tâche avant de travailler sur l’exigence.
Si les instructions se contredisent ou si des éléments probants manquent, explique d’abord le problème.

Les règles du projet décrivent comment le travail doit être effectué. L’accès aux fichiers, l’exécution des commandes et les actions externes restent soumis aux contrôles réels des autorisations. Modifier un fichier d’instructions ne remplace pas l’octroi d’un accès.

6. Utiliser les navigateurs et les applications de bureau

6.1 Travailler avec une page Web

Précisez la page et le navigateur dans votre tâche. Le navigateur intégré de Remy et Chrome connecté via l’extension sont des points d’entrée distincts. Ne supposez pas qu’ils partagent le même état de connexion.

Ouvre l’URL que je fournis dans le navigateur intégré, lis la page d’aide et énumère les étapes d’installation.
Lecture seule. Ne soumets pas de formulaires et ne change pas les paramètres du compte.

Si vous avez besoin de votre navigateur Chrome local, précisez-le dans la tâche. Lorsque Remy in Chrome — non installé apparaît, cliquez sur Obtenir l’extension, terminez l’installation, puis revenez et renouvelez la demande. Si l’extension est installée mais inaccessible, vérifiez d’abord que Chrome est en cours d’exécution et lisez le message de connexion. Installé ne signifie pas connecté. Connectez-vous au site dans le navigateur concerné si nécessaire.

6.2 Accorder les autorisations système pour l’utilisation de l’ordinateur

1. Dans Paramètres → Plugins, ouvrez les détails de la fonctionnalité d’utilisation de l’ordinateur.
2. Repérez Autorisations et vérifiez Accessibilité et Enregistrement de l’écran.
3. Si un accès est nécessaire, cliquez sur Ouvrir les Réglages Système et accordez-le à l’application ou au composant correspondant dans les réglages macOS.
4. Revenez à Remy, cliquez sur Vérifier à nouveau et examinez l’état.
5. Si le système vous demande de rouvrir l’application, suivez cette instruction avant de réessayer la tâche.

Vous accordez ces autorisations dans les Réglages Système. Remy ne peut pas les activer pour vous. Si Composant auxiliaire manquant apparaît, il faut résoudre l’absence du composant de l’application ; accorder les autorisations à répétition ne corrigera pas ce problème.

Pour une première tâche, demandez à Remy de lire un contenu précis dans une application ouverte. Vérifiez le résultat avant d’autoriser des modifications. Arrêter l’exécution ou désactiver une fonctionnalité n’annule pas automatiquement les actions externes déjà effectuées.

7. Utiliser GitHub et Slack

Tâches sur des dépôts GitHub : autorisez GitHub depuis l’entrée de connexion Cloud, choisissez un dépôt et une branche, puis lancez une tâche. Suivez le guide Cloud pour toutes les étapes.

Accéder à Slack depuis Remy : utilisez le plugin ou la connexion MCP correspondante, autorisez votre compte et donnez la tâche dans une conversation Remy. Les accès en lecture et en écriture sont limités par les autorisations du compte Slack et le périmètre de la connexion.

Appeler Remy depuis Slack : dans un environnement Slack où Remy Tag est déjà activé, mentionnez @Remy pour lancer des tâches cloud et examiner leurs résultats. Cela fonctionne dans le sens inverse de la connexion de Slack dans Remy. Installer un plugin Slack n’active pas Remy Tag.

8. Questions courantes

Si le problème persiste, notez le nom de la fonctionnalité, l’étape en échec, le message d’erreur et votre version de Remy. Suivez le guide de l’application de bureau pour envoyer un retour. N’incluez pas de véritables secrets dans le rapport.