Referencia de herramientas MCP

Las 34 herramientas, agrupadas por finalidad. Llame a tools/list en el endpoint MCP para obtener los esquemas JSON completos: es el contrato autorizado y la base a partir de la cual debe crear sus definiciones de herramientas.

Dos reglas que ahorran tiempo. Los identificadores nunca son adivinables: obtenga los identificadores de tipo de neurona con aiqbee_get_neuron_types antes de escribir. Y toda herramienta devuelve los errores como JSON estructurado con texto accionable; devuélvaselo al modelo en lugar de reducirlo a "la llamada falló".

Búsqueda y lectura

Las herramientas que su agente llamará con más frecuencia. `aiqbee_search` es semántica: pase una pregunta en lenguaje natural, no palabras clave.

Herramienta	Qué hace
`aiqbee_search`	Búsqueda semántica en las neuronas del Brain.
`aiqbee_fetch`	Recuperar una neurona completa por su id.
`aiqbee_list_neurons`	Recorra las neuronas página por página, con filtro opcional por tipo.
`aiqbee_get_neuron_count`	Contar neuronas: una forma económica de dimensionar un Brain.
`aiqbee_get_brain_info`	Nombre, descripción y ajustes del Brain.
`aiqbee_get_relationships`	Sinapsis (enlaces) de una neurona dada.
`aiqbee_get_neuron_types`	Tipos disponibles en este Brain, con sus ids.
`aiqbee_list_neuron_types`	El mismo conjunto, en forma de listado.
`aiqbee_list_metadata_fields`	Campos de metadatos que declara este Brain: las claves utilizables en `metadata_filter` en la búsqueda y el listado.
`aiqbee_edit_is_allowed`	Compruebe si se puede escribir antes de ofrecer una edición.

Escritura

Todas las escrituras respetan el indicador allow_mcp_editing del Brain y el nivel de acceso de quien llama. De forma predeterminada, se rechaza crear una neurona cuyo título y contenido coincidan exactamente con los de una existente, y se devuelve la neurona existente para que el agente pueda actualizarla o vincularla en lugar de fragmentar el Brain; pase allow_duplicate=true solo cuando realmente se desee una segunda copia.

Herramienta	Qué hace
`aiqbee_create_neuron` escrituras	Crear una neurona.
`aiqbee_update_neuron` escrituras	Actualizar el título, el contenido o la fecha de una neurona.
`aiqbee_delete_neuron` escrituras	Eliminar una neurona.
`aiqbee_create_relationship` escrituras	Enlazar dos neuronas con una sinapsis.
`aiqbee_update_relationship` escrituras	Editar la descripción de una sinapsis.
`aiqbee_delete_relationship` escrituras	Eliminar una sinapsis.
`aiqbee_update_brain` escrituras	Cambiar los ajustes del Brain.
`aiqbee_add_neuron_type` escrituras	Añada un tipo de neurona.
`aiqbee_edit_neuron_type` escrituras	Cambiar el nombre o la descripción de un tipo.
`aiqbee_delete_neuron_type` escrituras	Eliminar un tipo, reasignando sus neuronas.

Control de acceso

Gestión de directorio y permisos. Las herramientas de permisos por tipo requieren Seguridad avanzada, que es una función de pago; consulte Licencias & planes.

Herramienta	Qué hace
`aiqbee_list_users`	Usuarios con acceso a este Brain.
`aiqbee_list_all_groups`	Todos los grupos de usuarios de este Hive.
`aiqbee_list_brain_groups`	Grupos con acceso a este Brain.
`aiqbee_list_all_service_accounts`	Cuentas de servicio de este Hive.
`aiqbee_list_type_access`	Concesiones por tipo para un tipo de neurona.
`aiqbee_grant_access` escrituras	Conceder a un usuario acceso al Brain.
`aiqbee_revoke_access` escrituras	Revocar el acceso de un usuario a un Brain.
`aiqbee_grant_brain_group_access` escrituras	Conceder a un grupo acceso al Brain.
`aiqbee_revoke_brain_group_access` escrituras	Revocar el acceso de un grupo a un Brain.
`aiqbee_grant_type_access` escrituras	Conceder acceso a un tipo de neurona.
`aiqbee_revoke_type_access` escrituras	Revocar el acceso a un tipo de neurona.
`aiqbee_set_neuron_type_security` escrituras	Incluir una neurona en la seguridad a nivel de tipo.

Historial de auditoría

El registro de auditoría es una función de pago y debe activarse por Brain. Estas herramientas se rechazan cuando está desactivado.

Herramienta	Qué hace
`aiqbee_get_audit_history`	Historial de cambios de una neurona.
`aiqbee_get_brain_audit_history`	Historial de cambios de todo el Brain.

Elegir cuáles exponer

No es necesario entregar a su modelo las 34 herramientas. Un conjunto más grande dificulta la selección, así que empiece con pocas y amplíe cuando vea una necesidad real:

Forma del agente	Conjunto de herramientas razonable
Responde preguntas a partir del conocimiento del equipo	`aiqbee_search`, `aiqbee_fetch`
También registra lo que se decide	lo anterior más `aiqbee_get_neuron_types`, `aiqbee_create_neuron`, `aiqbee_update_neuron`
Cura y conecta el conocimiento	lo anterior más `aiqbee_create_relationship`, `aiqbee_get_relationships`
Administra el Hive	el grupo de control de acceso; normalmente es mejor que lo haga una persona en la interfaz

Dejar fuera por completo las herramientas de eliminación es un valor predeterminado razonable. Eliminar rara vez es algo que un agente conversacional deba hacer sin que se le pida, y una eliminación accidental es costosa de detectar.