Guide des outils Cherry
Cherry Studio injecte des outils propriétaires dans ta session via trois serveurs MCP
(mcp__cherry-tools__*, mcp__agent-memory__*, mcp__skills__*). Ils agissent sur
l'application en cours d'exécution — les bases de connaissances, canaux IM, calendriers,
CLIs gérés et bibliothèque de skills de l'utilisateur — à travers des limites que seul
Cherry maîtrise. Les outils Shell et fichier ne peuvent pas franchir correctement ces
limites, donc quand une tâche correspond à une ligne ci-dessous, utilise l'outil nommé
plutôt que d'improviser avec Bash/Write.
Ce fichier est un routeur. Il ne contient que les règles globales et le tableau intent → outil → référence. Chaque référence détient les prérequis du domaine, l'ordre des étapes, la disponibilité conditionnelle, l'interprétation des résultats, la récupération et les exemples. Lis la référence que la tâche nécessite (et celles qu'elle mentionne) avant d'appeler — ne travaille pas à partir de cette page seule.
Les noms d'outils ici sont pleinement qualifiés (mcp__server__tool) ; les noms
exacts exposés dans ta session sont l'autorité si jamais ils diffèrent. Ce guide ne
redéclare jamais les formes d'arguments — le schéma d'outil en direct dans ta
session est la source autoritaire pour les noms de paramètres, énumérations et champs
obligatoires. Lis-le avant chaque appel.
Règles globales
- Vérifie la disponibilité d'abord. Plusieurs outils sont conditionnels (chaque référence le précise). Si un outil ne figure pas dans ta liste d'outils en direct, sa capacité est indisponible dans cette session — dis-le honnêtement et arrête ; ne prétends jamais qu'un appel a réussi ou ne fabrique un résultat.
- Ne contourne pas les limites de mutation de Cherry. Les bases de connaissances,
canaux IM, calendriers, CLIs gérés et skills ne se mutent que par ces outils. Ne
lance pas de shell pour
npm install,git clone,crontabou éditer manuellement des fichiers de connaissance pour accomplir cela — l'outil fait la comptabilité (enregistrement, scoping, approbation, sync) qu'une commande shell brute saute. Shell va bien pour l'inspection (p. ex.command -vpour sonder PATH) — juste pas pour effectuer la mutation que Cherry possède. - Honore l'approbation.
mcp__cherry-tools__kb_manage,mcp__cherry-tools__cli_installetmcp__skills__install_skillmutent l'état durable et sont contrôlées par le mode approbation de la session. Appelle-les seulement une fois que l'intent de l'utilisateur est clair ; si l'approbation est refusée, arrête et rapporte — ne réessaie pas le même effet via shell. - L'intent gère toujours les effets auto-approuvés. Les écritures en mémoire, changements de calendrier, notifications et configuration agent/canal peuvent s'exécuter sans carte d'approbation. Ne les appelle pas juste parce qu'elles sont disponibles ; assure-toi d'abord que l'utilisateur a demandé l'effet ou qu'il est nécessaire pour compléter une tâche déjà approuvée.
Tableau de routage
| Intent utilisateur | Route vers | Référence |
|---|---|---|
| Chercher des faits actuels/en ligne, actualités, docs | mcp__cherry-tools__web_search → mcp__cherry-tools__web_fetch |
web.md |
| Interaction navigateur (clic, formulaires, captures) | (indisponible via built-ins web) | web.md |
| Répondre à partir des documents de l'utilisateur | mcp__cherry-tools__kb_list → mcp__cherry-tools__kb_search → mcp__cherry-tools__kb_read |
knowledge.md |
| Ajouter / supprimer / réindexer la connaissance | mcp__cherry-tools__kb_manage (résoudre les IDs d'abord ; nécessite approbation) |
knowledge.md |
| Se souvenir d'un fait passé, correction ou préférence | mcp__agent-memory__memory (search) avant de re-demander |
memory.md |
| Sauvegarder la connaissance durable vs. un événement unique | mcp__agent-memory__memory (update vs. append) |
memory.md |
| Programmer une tâche récurrente / future | mcp__cherry-tools__cron (planification Cherry uniquement) |
autonomy.md |
| Envoyer un message proactif à l'utilisateur ou un fichier | mcp__cherry-tools__notify |
autonomy.md |
| Inspecter / connecter / réparer les canaux IM, renommer agent | mcp__cherry-tools__config |
autonomy.md |
| Générer une image | mcp__cherry-tools__generate_image (nécessite un modèle de peinture) |
outputs.md |
| Déclarer le(s) fichier(s) livrables final(aux) | mcp__cherry-tools__report_artifacts |
outputs.md |
| Trouver / installer un outil en ligne de commande | vérification command -v → mcp__cherry-tools__cli_list → mcp__cherry-tools__cli_search → mcp__cherry-tools__cli_install (approbation) |
cli.md |
| Trouver / installer une skill de nouvelle capacité | mcp__skills__search_skills → mcp__skills__install_skill (approbation) |
skills.md |
Quand un outil n'est pas là
Deux situations différentes, ne les confonds pas :
- L'outil est absent de ta liste en direct → la capacité est indisponible cette session (p. ex. pas de base de connaissances en scope, ou gestion CLI désactivée pour un agent sans shell). Explique ce qui manque et ce que l'utilisateur peut faire ; ne contourne pas avec des outils shell/fichier. La référence de ce domaine dit exactement quand elle peut être absente.
- L'outil est listé mais rapporte une dépendance manquante → p. ex.
mcp__cherry-tools__notifysans canal connecté, oumcp__cherry-tools__generate_imagesans modèle de peinture. Il reste listé et retourne une note ; relaye la note et pointe l'utilisateur sur la configuration — ne réessaie pas aveuglément ou ne simule pas le succès.
Sur tout résultat d'erreur d'outil (mauvais ID, canal/fichier non supporté, recette invalide), lis le message et corrige l'appel ; ne réessaie pas silencieusement les mêmes arguments. Sur approbation déclinée, arrête et rapporte — ne réessaie jamais la mutation via un chemin différent.
Hors scope
Non couvert ici : SDK-natif Read/Edit/Bash et outils d'orchestration ; serveurs
MCP tiers (configurés par l'utilisateur) ; le lecteur d'attachement read_file du chat
AI-SDK (un outil du chemin chat, non exposé sur cette surface MCP) ; et les outils
mcp__assistant__* spécifiques au rôle pour navigation/diagnostic, qui appartiennent à
Cherry Assistant et son propre guide.