Outils MCP

Neuronz.ai met à la disposition de votre agent un ensemble d'outils via le Model Context Protocol (MCP), la façon standard pour un agent d'appeler des outils externes. Une fois Neuronz.ai connecté (le plugin dans Claude Code et Oh-My-Pi, ou le connecteur dans l'application de bureau Claude), les outils ci-dessous sont disponibles pour votre agent. Il s'en sert de lui-même, et vous pouvez lui demander d'en appeler un pour vous (« liste mes conflits ouverts », « lis mes règles »).

Les outils sont regroupés selon ce sur quoi ils agissent. La plupart lisent et écrivent les enregistrements décrits dans Concepts clés et détaillés dans Fonctionnalités. Chacun agit sur le profil courant, sauf si vous en nommez un autre.

Mémoire et rappel

L'usage quotidien — les faits durables et la recherche unifiée qui les parcourt. Voir mémoire persistante et rappel automatique.

Outil	Ce qu'il fait
recall	Une seule recherche dans la mémoire, les actions passées et les connaissances — votre réflexe pour « que sais-je déjà sur X ».
fact_search	Rechercher uniquement dans les faits.
fact_add	Enregistrer un fait. Si des faits existants disent presque la même chose, la réponse les liste (jusqu'à 10, chacun résumé en une ligne) pour que votre agent les règle avec fact_resolve ; passez subject pour l'attribuer à un collègue plutôt qu'à vous.
fact_resolve	Régler un fait similaire signalé par fact_add : duplicate retire le nouveau fait et garde l'ancien, supersedes archive l'ancien et garde le nouveau, conflicts met la paire en litige jusqu'à ce que vous tranchiez. Peut être répété sans risque.
fact_get · fact_list	Récupérer ou lister des faits.
fact_update · fact_delete	Modifier un fait (l'ancienne version est conservée dans l'historique) ou le retirer.
list_conflicts	Lister les contradictions — chacune est un ensemble de faits en désaccord, tous tenus à l'écart du rappel jusqu'à leur règlement.
resolve_conflict	Régler une contradiction en une seule décision : garder une affirmation, les retirer toutes, les remplacer par une correction ou remettre à plus tard.

Contacts

La carte sociale : votre propre profil plus celui de chaque collègue. Voir personas et carte sociale.

Outil	Ce qu'il fait
get_persona	Lire le résumé et les traits d'un contact — omettez le nom pour les vôtres, passez le nom d'un collègue pour les siens. Quand un prompt mentionne un collègue, l'agent apprend combien de traits sont enregistrés à son sujet et qu'il doit appeler cet outil avant d'écrire à cette personne ou à propos d'elle. Le résumé est fait pour être lu par vous ; l'agent, lui, écrit dans les traits.
list_persona_subjects	Lister tous les contacts (vous-même plus chaque collègue) de ce profil.
add_persona_subject · update_persona_subject · delete_persona_subject	Tenir à jour la liste des contacts — les personnes avec qui vous travaillez, ou des groupes de destinataires comme « clients » (nom, type, alias, résumé).
update_persona_summary	Rafraîchir le résumé lisible d'un contact — passez subject pour un collègue, omettez-le pour vous-même. Ajouter, modifier ou retirer un trait indique à quel point le résumé est devenu obsolète, pour que l'agent puisse le rafraîchir dans le même tour.

Règles

Des règles durables qui appartiennent à un humain. Les règles proposées attendent qu'un humain les approuve. Voir règles.

Outil	Ce qu'il fait
read_rules	Lire les règles applicables. Omettez tout sélecteur pour lire l'ensemble du profil, ou ciblez des règles précises avec slugs et/ou ids (cumulés ; les ids ignorent les tirets et la casse). Accepte aussi deliveryToken — voir plus bas.
propose_rule	Suggérer une règle (elle arrive comme proposée). Accepte conditions — quand la règle s'applique — et force — voir plus bas.
create_rule · update_rule · delete_rule	Gérer les règles (la création suppose une confirmation humaine). create_rule et update_rule acceptent conditions, le champ unique qui décrit quand la règle s'applique : un mode all ou any sur une liste plate de tests, chacun étant soit un match sur le nom de l'outil, le chemin du fichier, le dossier de travail, la branche git, l'entrée de l'outil, le prompt ou le modèle, soit un énoncé text en langage courant que l'agent évalue sur le moment. Omettez-le, ou passez une liste vide, et la règle est inconditionnelle.
resolve_rule_ask	Enregistrer votre réponse à une proposition en attente — accepted est la seule chose qui rend une règle contraignante ; declined retire l'affirmation ; deflected signifie « pas maintenant ».

Avec le plugin, les règles arrivent sous forme d'un court avis, et read_rules va les chercher. Chaque prompt porte un court bloc qui indique combien de règles approuvées s'appliquent ou attendent encore la vérification de leurs conditions, les nomme et cite l'appel exact read_rules({ profile, ids, deliveryToken }) qui renvoie leur texte — voir comment une règle applicable parvient à votre assistant. Deux précisions sur cet appel :

• deliveryToken est recopié, jamais inventé. Neuronz.ai l'émet pour que les prompts suivants sachent quelles règles cette session a déjà lues. L'agent renvoie exactement la valeur donnée par l'avis ; quand l'avis n'en donne aucune, il l'omet.
• Sans deliveryToken, c'est une lecture ordinaire. Lire les règles pour en rédiger une, passer en revue celles qui s'appliquent ou vérifier une formulation, c'est le même appel sans deliveryToken ; il renvoie les règles sélectionnées et n'enregistre rien.

create_rule et propose_rule refusent d'écrire, avec une erreur CONFLICT_SUGGESTED, lorsqu'une règle approuvée dit déjà presque la même chose (la vérification des conflits de règles). L'erreur nomme la règle existante, indique le degré de similarité des deux (de 0 à 1) et suggère plutôt update_rule sur celle-ci. L'agent vous soumet la question au lieu de réessayer. Si vous confirmez que la nouvelle règle est bien distincte, il refait l'appel avec force: true et la règle est enregistrée. update_rule n'est jamais refusé de cette façon.

Voix

Votre façon d'écrire, à distinguer de ce que fait votre agent. La voix comporte trois éléments :

• Un atome de voix est une affirmation sur votre façon d'écrire (« fait des phrases courtes »).
• Un groupe d'atomes est un ensemble nommé d'atomes. Un groupe peut en inclure d'autres.
• Une condition de voix (les outils *_register) indique quand un groupe s'applique, à l'aide de six réglages : direction (qui écrit à qui), audience, acte (une réponse dans un chat, un message de commit…), langue, situation et modèle. Un réglage omis signifie n'importe lequel.

Les atomes et les groupes sont partagés entre tous vos profils et sont réutilisés, pas copiés : pour appliquer une voix ailleurs, ajoutez une condition de voix qui pointe vers le groupe que vous avez déjà, et réglez sa portée global / profiles pour choisir les profils qu'elle couvre. Voir voix.

Outil	Ce qu'il fait
add_atom_group · get_atom_group · list_atom_groups · update_atom_group · delete_atom_group	Gérer les ensembles nommés d'affirmations — la moitié réutilisable. parents est ce dont un groupe hérite, dans l'ordre ; exemplars sont des exemples de messages, mot pour mot. Les deux remplacent l'ensemble complet lors d'une mise à jour. Ce qu'un groupe applique, ce sont ses atomes : modifiez donc l'écriture avec add_voice_atom / update_voice_atom, jamais ici. Les groupes sont partagés par tous vos profils : list_atom_groups montre les conditions de voix qui appliquent chacun d'eux dans tous les profils, et une suppression est refusée tant qu'une condition pointe encore vers le groupe, que d'autres groupes l'incluent, ou qu'il contient des atomes présents dans aucun autre groupe.
add_register · get_register · list_registers · update_register · delete_register	Gérer les conditions de voix — les six réglages et l'unique group que chacune applique (group est obligatoire à la création). Lisez d'abord list_registers, pour qu'une nouvelle condition prolonge ce que vous avez au lieu de le dupliquer. Chaque réglage est facultatif et une condition n'en hérite jamais d'une autre : ne nommez donc que les réglages par lesquels vous voulez restreindre. Supprimer une condition cesse d'appliquer cette voix à cet endroit et conserve le groupe. Le réglage audience fait référence à un contact : passez un nom, un alias ou un id et le serveur le résout, en refusant une audience qui ne correspond à aucun contact (créez-le d'abord avec add_persona_subject, kind=group pour une catégorie comme « clients »).
portée de add_register · update_register	global: true applique la condition dans tous vos profils, y compris ceux créés plus tard. profiles: [...] en nomme certains ; si vous ne passez ni l'un ni l'autre à la création, elle reste dans le profil courant ; si vous ne passez ni l'un ni l'autre à la mise à jour, la portée reste inchangée. Vous ne pouvez pas passer les deux. Une condition qui nomme une audience précise doit rester exactement dans le profil depuis lequel vous écrivez, car cette personne est enregistrée dans ce profil.
add_voice_atom · update_voice_atom · delete_voice_atom	Enregistrer, réviser ou retirer une affirmation sur votre façon d'écrire, placée dans au moins un groupe via groups. Une correction de style va ici, pas dans un fait ni dans une règle. Une modification prend effet au message suivant.
bind_voice_atom · unbind_voice_atom	Ajouter un atome existant à un autre group, ou l'en retirer — refusé si l'atome ne se retrouverait dans aucun groupe. Prend effet au message suivant.
get_resolved_voice	Obtenir la voix pour une situation : chaque condition de voix remplie applique son groupe (avec les groupes qu'il inclut), et les atomes reviennent sans doublons, du plus spécifique au plus général. audience accepte la même référence à une personne ou à un groupe que les conditions. Avec le plugin, chaque prompt indique à l'agent quelle voix s'applique et combien d'atomes elle compte, et lui donne l'appel exact à faire avant sa première réponse écrite (model est obligatoire ; l'avis le renseigne, ou met unknown quand votre harnais d'agent (harness) ne communique pas le modèle). L'appel porte un deliveryToken tiré de l'avis, pour que Neuronz.ai enregistre ce que cette session a récupéré : l'avis suivant indique si l'agent détient déjà la voix à jour, si la voix a changé depuis, ou s'il ne l'a pas encore récupérée. Le résultat porte aussi une version. Le même avis liste, sans leurs atomes, les voix qui ne s'appliquent que dans une situation particulière (un incident, une passation) ; quand cette situation se présente, l'agent appelle cet outil en la précisant pour les obtenir.
get_voice_ask · resolve_voice_ask	Vous interroger sur un atome non confirmé uniquement là où il s'appliquerait vraiment, et enregistrer votre réponse — rebound le déplace vers les groups auxquels il appartient réellement au lieu de l'abandonner.

Connaissances

Voir documents de connaissances.

Outil	Ce qu'il fait
add_knowledge · get_knowledge · list_knowledge · update_knowledge · delete_knowledge	Gérer des documents de référence ; chacun est découpé en sections pour que le rappel retrouve la partie qui correspond. Ajouter un document avec la même source qu'un document existant du profil courant le remplace ; pour déplacer un document vers un autre profil, utilisez update_knowledge. L'agent transmet aussi les faits qu'il a tirés du document dans derivedFacts (content, kind et status facultatifs), et retransmet la liste complète chaque fois qu'il modifie le document, pour que les faits que le document ne justifie plus soient retirés. Un fait dont le texte correspond à un fait que le document possède déjà est conservé tel quel ; tous les autres sont enregistrés comme nouveaux faits, et la réponse liste pour chacun les faits existants quasi identiques (comme fact_add) pour que votre agent les règle avec fact_resolve — le lien vers le document suit le fait conservé.
get_knowledge_outline · get_knowledge_chunk · list_knowledge_tags	Parcourir les titres de sections d'un document sans charger son texte ; lire une section (neighbors=N renvoie aussi les N sections de part et d'autre) ; lister les étiquettes utilisées.

Sujets, historique et exécutions

Voir sujets et mode sujet. Un sujet est un travail en cours ou un problème récurrent ; le mode sujet désigne le sujet sur lequel une session travaille actuellement. Une exécution (une utilisation d'un skill ou d'une commande ressource) est enregistrée automatiquement à la fin de la session.

Outil	Ce qu'il fait
create_topic · get_topic · list_topics · update_topic · touch_topic · delete_topic	Regrouper les problèmes récurrents et les unités de travail ; touch_topic enregistre une nouvelle occurrence. Classer un enregistrement sous un sujet fait vieillir son résumé : ces écritures reviennent donc avec un bloc topicSummaries — rafraîchissez les résumés obsolètes avec update_topic(summary=…), ce qui remet le compteur à zéro.
enter_topic · exit_topic · current_topic	Entrer en mode sujet ou en sortir : enter_topic fait d'un sujet celui sur lequel cette session travaille, de sorte que ce que l'agent enregistre est classé dessous ; exit_topic le quitte et demande à l'agent de rafraîchir le résumé du sujet. current_topic indique le sujet sur lequel travaille une session dans ce dépôt, s'il y en a un.
add_topic_tags · remove_topic_tags	Étiqueter les sujets.
log_action · list_actions · update_action · delete_action	Enregistrer et relire le travail passé — ce qui a été fait et pourquoi.
add_event	Joindre une preuve brute (un extrait de log, le contenu d'une alerte) à une action enregistrée, et éventuellement à un sujet.
list_runs · get_run	Lire les exécutions enregistrées (list_runs filtre par assetId).

Skills et ressources

Distribuez des skills, des commandes et des sous-agents à chaque session. Voir skills et ressources.

Outil	Ce qu'il fait
list_assets · get_asset	Parcourir les ressources enregistrées.
add_asset · update_asset · delete_asset	Gérer une ressource (kind ∈ skill · command · agent).

Graphe

Des liens typés entre enregistrements. Voir le graphe de connaissances.

Outil	Ce qu'il fait
link · unlink	Créer ou supprimer un lien typé entre deux entrées.
expand	Parcourir le graphe à partir d'une entrée.

Profils

Voir profils.

Outil	Ce qu'il fait
list_profiles	Lister les profils et leurs routes de dossiers.
create_profile	Créer un nouveau profil vide, en y rattachant éventuellement un dossier. Utilisez-le pour donner son propre profil à un dossier situé dans la route récursive d'un autre profil. Il refuse un nom qui existe déjà et un dossier qui a déjà sa propre route.
set_dir_profile · unset_dir_profile	Rattacher un dossier à un profil.
switch_profile	Pour les chats sans le plugin (chats et tâches Cowork de l'application Claude, claude.ai) : faire passer ce chat sur un autre profil existant. Il n'enregistre rien sur le serveur et ne change pas votre profil de chat par défaut ; le chat transmet le nouveau profil à chaque appel suivant. Avec le plugin, utilisez plutôt /neuronzai:switch-profile.

Chats sans profil

Un chat ou une tâche Cowork dans l'application Claude, ou un chat sur claude.ai, n'accède à Neuronz.ai que par le connecteur MCP : il n'a donc pas de dossier de travail, et aucun profil ne se résout de lui-même. Dans un tel chat, le premier appel d'un outil lié à un profil renvoie une erreur d'outil au lieu de s'exécuter :

• Si vous avez défini un profil de chat par défaut (tableau de bord → Profiles, Set as default sur un profil), l'erreur le nomme et indique à l'agent de refaire l'appel avec profile="<ce profil>" et de continuer à le transmettre à chaque appel suivant du chat, y compris après la reprise du chat.
• Si vous n'avez pas de profil par défaut, l'erreur liste vos profils et indique à l'agent de vous demander lequel utiliser.

Le profil du chat vit alors dans la conversation elle-même. Reprendre le chat le conserve ; changer votre profil par défaut n'affecte que les nouveaux chats ; switch_profile le change pour le chat en cours.

Étiquettes, KV et recherche

Outil	Ce qu'il fait
create_tag · list_tags · update_tag · delete_tag	Gérer le registre des étiquettes.
kv_get · kv_set · kv_append · kv_delete · kv_list · kv_namespaces	Un stockage clé/valeur pour la tenue de comptes de l'agent lui-même (par exemple, les éléments qu'un job récurrent a déjà traités). Ne fait pas partie du rappel.
search	Recherche par mots-clés dans les sujets et les documents de connaissances. Servez-vous-en pour vérifier si un sujet existe déjà ; pour tout le reste, utilisez recall.

Astuce

recall est l'outil à essayer en premier — il couvre la mémoire, les actions et les connaissances en un seul résultat classé, si bien que vous avez rarement besoin de chercher un type d'enregistrement à la main.