MCP-Tool-Referenz · Aiqbee Hive

Alle 34 Tools, nach Zweck gruppiert. Rufen Sie tools/list am MCP-Endpunkt auf, um die vollständigen JSON-Schemas zu erhalten – das ist der maßgebliche Vertrag, auf dessen Grundlage Sie Tool-Definitionen erstellen sollten.

Zwei Regeln, die Zeit sparen. IDs sind nie erratbar – rufen Sie vor dem Schreiben die Neuronentyp-IDs mit aiqbee_get_neuron_types ab. Und jedes Tool gibt Fehler als strukturiertes JSON mit umsetzbarem Text zurück; reichen Sie dies an das Modell weiter, statt es auf „Aufruf fehlgeschlagen“ zu verkürzen.

Suchen & lesen

Die Tools, die Ihr Agent am häufigsten aufruft. `aiqbee_search` ist semantisch – übergeben Sie eine Frage in natürlicher Sprache, keine Stichwörter.

Tool	Was es tut
`aiqbee_search`	Semantische Suche über Neuronen im Brain.
`aiqbee_fetch`	Ein Neuron anhand seiner ID vollständig abrufen.
`aiqbee_list_neurons`	Neuronen seitenweise durchblättern, optional nach Typ gefiltert.
`aiqbee_get_neuron_count`	Neuronen zählen – eine günstige Möglichkeit, die Größe eines Brains abzuschätzen.
`aiqbee_get_brain_info`	Brain-Name, Beschreibung und Einstellungen.
`aiqbee_get_relationships`	Synapsen (Verknüpfungen) für ein bestimmtes Neuron.
`aiqbee_get_neuron_types`	In diesem Brain verfügbare Typen, mit IDs.
`aiqbee_list_neuron_types`	Dieselbe Menge, Listenform.
`aiqbee_list_metadata_fields`	Metadatenfelder, die dieses Brain deklariert – die Schlüssel, die in `metadata_filter` bei Suche und Auflistung verwendet werden können.
`aiqbee_edit_is_allowed`	Prüfen Sie die Schreibbarkeit, bevor Sie eine Bearbeitung anbieten.

Schreiben

Alle Schreibvorgänge beachten das Flag allow_mcp_editing des Brains und die Zugriffsebene des Aufrufers. Standardmäßig wird das Erstellen eines Neurons, dessen Titel und Inhalt exakt mit einem vorhandenen übereinstimmen, abgelehnt, und das vorhandene Neuron wird zurückgegeben, damit der Agent aktualisieren oder verknüpfen kann, statt das Brain zu fragmentieren; übergeben Sie allow_duplicate=true nur, wenn eine zweite Kopie tatsächlich beabsichtigt ist.

Tool	Was es tut
`aiqbee_create_neuron` Schreibvorgänge	Ein Neuron erstellen.
`aiqbee_update_neuron` Schreibvorgänge	Titel, Inhalt oder Datum eines Neurons aktualisieren.
`aiqbee_delete_neuron` Schreibvorgänge	Ein Neuron löschen.
`aiqbee_create_relationship` Schreibvorgänge	Zwei Neuronen mit einer Synapse verknüpfen.
`aiqbee_update_relationship` Schreibvorgänge	Die Beschreibung einer Synapse bearbeiten.
`aiqbee_delete_relationship` Schreibvorgänge	Eine Synapse entfernen.
`aiqbee_update_brain` Schreibvorgänge	Brain-Einstellungen ändern.
`aiqbee_add_neuron_type` Schreibvorgänge	Einen Neuronentyp hinzufügen.
`aiqbee_edit_neuron_type` Schreibvorgänge	Einen Typ umbenennen oder neu beschreiben.
`aiqbee_delete_neuron_type` Schreibvorgänge	Einen Typ löschen und seine Neuronen neu zuordnen.

Zugriffskontrolle

Verzeichnis- und Berechtigungsverwaltung. Die Tools für Berechtigungen pro Typ erfordern erweiterte Sicherheit, eine kostenpflichtige Funktion – siehe Lizenzierung & Tarife.

Tool	Was es tut
`aiqbee_list_users`	Benutzer mit Zugriff auf dieses Brain.
`aiqbee_list_all_groups`	Alle Benutzergruppen auf diesem Hive.
`aiqbee_list_brain_groups`	Gruppen mit Zugriff auf dieses Brain.
`aiqbee_list_all_service_accounts`	Dienstkonten dieser Hive.
`aiqbee_list_type_access`	Berechtigungen pro Typ für einen Neuronentyp.
`aiqbee_grant_access` Schreibvorgänge	Einem Benutzer Zugriff auf das Brain erteilen.
`aiqbee_revoke_access` Schreibvorgänge	Den Brain-Zugriff eines Benutzers widerrufen.
`aiqbee_grant_brain_group_access` Schreibvorgänge	Einer Gruppe Brain-Zugriff erteilen.
`aiqbee_revoke_brain_group_access` Schreibvorgänge	Den Brain-Zugriff einer Gruppe widerrufen.
`aiqbee_grant_type_access` Schreibvorgänge	Zugriff auf einen Neuronentyp erteilen.
`aiqbee_revoke_type_access` Schreibvorgänge	Den Zugriff auf einen Neuronentyp widerrufen.
`aiqbee_set_neuron_type_security` Schreibvorgänge	Ein Neuron für die Sicherheit auf Typebene aktivieren.

Prüfverlauf

Die Prüfprotokollierung ist eine kostenpflichtige Funktion und muss pro Brain eingeschaltet werden. Diese Tools verweigern, wenn sie aus ist.

Tool	Was es tut
`aiqbee_get_audit_history`	Änderungsverlauf eines einzelnen Neurons.
`aiqbee_get_brain_audit_history`	Änderungsverlauf des gesamten Brains.

Auswählen, was bereitgestellt wird

Sie müssen Ihrem Modell nicht alle 34 übergeben. Ein größerer Toolumfang erschwert die Auswahl, beginnen Sie also schmal und erweitern Sie bei echtem Bedarf:

Agentenform	Überschaubarer Toolumfang
Beantwortet Fragen aus dem Teamwissen	`aiqbee_search`, `aiqbee_fetch`
Hält auch fest, was entschieden wird	das Obige plus `aiqbee_get_neuron_types`, `aiqbee_create_neuron`, `aiqbee_update_neuron`
Kuratiert und vernetzt Wissen	das Obige plus `aiqbee_create_relationship`, `aiqbee_get_relationships`
Verwaltet den Hive	die Zugriffskontrollgruppe – besser von einem Menschen in der Oberfläche vorgenommen

Die Löschen-Tools ganz wegzulassen ist ein vernünftiger Standard. Löschen ist selten etwas, was ein Konversationsagent unaufgefordert tun sollte, und ein versehentliches fällt erst spät auf.