Référence des outils MCP

Les 34 outils, regroupés par finalité. Appelez tools/list sur le point de terminaison MCP pour obtenir les schémas JSON complets — c’est le contrat de référence, à partir duquel vous devez construire vos définitions d’outils.

Deux règles qui font gagner du temps. Les identifiants ne sont jamais devinables — obtenez les identifiants de types de neurones via aiqbee_get_neuron_types avant d’écrire. Et chaque outil renvoie ses erreurs sous forme de JSON structuré avec un texte exploitable ; transmettez-le au modèle plutôt que de le réduire à « l’appel a échoué ».

Recherche et lecture

Les outils que votre agent appellera le plus. `aiqbee_search` est sémantique — transmettez une question en langage naturel, pas des mots-clés.

Outil	Ce que cela fait
`aiqbee_search`	Recherche sémantique parmi les neurones du Brain.
`aiqbee_fetch`	Récupérer un neurone complet par son identifiant.
`aiqbee_list_neurons`	Parcourez les neurones page par page, éventuellement filtrés par type.
`aiqbee_get_neuron_count`	Compte les neurones — un moyen peu coûteux d’estimer la taille d’un brain.
`aiqbee_get_brain_info`	Nom, description et paramètres du brain.
`aiqbee_get_relationships`	Synapses (liens) d'un neurone donné.
`aiqbee_get_neuron_types`	Types disponibles dans ce Brain, avec leurs identifiants.
`aiqbee_list_neuron_types`	Même ensemble, sous forme de liste.
`aiqbee_list_metadata_fields`	Champs de métadonnées que ce Brain déclare — les clés utilisables dans `metadata_filter` pour la recherche et les listes.
`aiqbee_edit_is_allowed`	Vérifiez la possibilité d’écriture avant de proposer une modification.

Écriture

Toutes les écritures respectent l’indicateur allow_mcp_editing du brain et le niveau d’accès de l’appelant. Par défaut, la création d’un neurone dont le titre et le contenu correspondent exactement à un neurone existant est rejetée, et le neurone existant est renvoyé afin que l’agent puisse le mettre à jour ou le lier au lieu de fragmenter le brain ; ne passez allow_duplicate=true que si une seconde copie est réellement voulue.

Outil	Ce que cela fait
`aiqbee_create_neuron` écritures	Crée un neurone.
`aiqbee_update_neuron` écritures	Mettre à jour le titre, le contenu ou la date d'un neurone.
`aiqbee_delete_neuron` écritures	Supprime un neurone.
`aiqbee_create_relationship` écritures	Relie deux neurones par une synapse.
`aiqbee_update_relationship` écritures	Modifie la description d’une synapse.
`aiqbee_delete_relationship` écritures	Supprimer une synapse.
`aiqbee_update_brain` écritures	Modifier les paramètres du brain.
`aiqbee_add_neuron_type` écritures	Ajouter un type de neurone.
`aiqbee_edit_neuron_type` écritures	Renommer ou redécrire un type.
`aiqbee_delete_neuron_type` écritures	Supprime un type en réaffectant ses neurones.

Contrôle d’accès

Gestion de l’annuaire et des autorisations. Les outils d’autorisation par type nécessitent la sécurité avancée, qui est une fonctionnalité payante — voir Licences & offres.

Outil	Ce que cela fait
`aiqbee_list_users`	Utilisateurs ayant accès à ce Brain.
`aiqbee_list_all_groups`	Tous les groupes d’utilisateurs de ce Hive.
`aiqbee_list_brain_groups`	Groupes ayant accès à ce brain.
`aiqbee_list_all_service_accounts`	Comptes de service de ce Hive.
`aiqbee_list_type_access`	Autorisations par type pour un type de neurone.
`aiqbee_grant_access` écritures	Accorde à un utilisateur l’accès au brain.
`aiqbee_revoke_access` écritures	Révoquer l'accès d'un utilisateur à un Brain.
`aiqbee_grant_brain_group_access` écritures	Accorde à un groupe l’accès à un brain.
`aiqbee_revoke_brain_group_access` écritures	Révoquer l'accès d'un groupe à un Brain.
`aiqbee_grant_type_access` écritures	Accorde l’accès à un type de neurone.
`aiqbee_revoke_type_access` écritures	Révoquer l'accès à un type de neurone.
`aiqbee_set_neuron_type_security` écritures	Inclure un neurone dans la sécurité au niveau du type.

Historique d’audit

La journalisation d’audit est une fonctionnalité payante et doit être activée brain par brain. Ces outils refusent d’agir lorsqu’elle est désactivée.

Outil	Ce que cela fait
`aiqbee_get_audit_history`	Historique des modifications d’un neurone.
`aiqbee_get_brain_audit_history`	Historique des modifications de l’ensemble du brain.

Choisir ce qu’il faut exposer

Vous n'avez pas à confier les 34 outils à votre modèle. Un jeu d'outils plus grand rend le choix plus difficile : commencez donc restreint et élargissez lorsqu'un besoin réel apparaît :

Profil d’agent	Jeu d'outils raisonnable
Répond aux questions à partir des connaissances de l’équipe	`aiqbee_search`, `aiqbee_fetch`
Consigne aussi ce qui est décidé	ce qui précède plus `aiqbee_get_neuron_types`, `aiqbee_create_neuron`, `aiqbee_update_neuron`
Organise et relie les connaissances	ce qui précède plus `aiqbee_create_relationship`, `aiqbee_get_relationships`
Administre le Hive	le groupe de contrôle d'accès — généralement mieux géré par un humain dans l'interface

Exclure totalement les outils de suppression est un choix par défaut raisonnable. La suppression est rarement ce qu’un agent conversationnel devrait faire de sa propre initiative, et une suppression accidentelle est coûteuse à repérer.