---
title: "Herramientas"
description: "Invantive MCP Server ofrece las siguientes herramientas a un cliente de IA como Anthropic Claude."
language: es
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/es/docs/invantive-mcp-server/tools
original: https://documentation.invantive.eu/en/docs/invantive-mcp-server/tools
updated: 2026-11-21T18:18:20Z
license: https://documentation.invantive.eu/es/
---

Invantive MCP Server ofrece las siguientes herramientas a un cliente de IA como Anthropic Claude. Las herramientas sobre una base de datos solo leen: no modifican datos ni ejecutan instrucciones SQL. Solo `check_sql` acepta una, que la analiza sin ejecutarla. Las herramientas de estado trabajan sobre una página de estado de Invantive Cloud Status en lugar de una base de datos; cuatro de ellas modifican la página de estado.
- `describe_entities`: lista las entidades que se pueden leer de la base de datos, con su nombre, etiqueta, tipo, contenedor de datos y el orden de magnitud de su número de filas. Disponible a partir de la versión 26.0. Vea abajo.
- `describe_entity`: describe una entidad completa, con sus campos, clave primaria, claves únicas, claves externas y la velocidad que cabe esperar. Disponible a partir de la versión 27.0. Vea abajo.
- `read_records`: lee filas de una entidad, con selección, filtro, orden y número de filas en la notación de la interfaz de consulta de la versión 4 de OData. Disponible a partir de la versión 26.0. Vea abajo.
- `analyze_records`: ejecuta la misma lectura que `read_records` y devuelve cómo se ejecutó en lugar de las filas. Disponible a partir de la versión 28.0. Vea abajo.
- `current_cloud_user`: devuelve el perfil del usuario que ha iniciado sesión y de la organización de ese usuario, tal como se guardan en Invantive Cloud. Disponible a partir de la versión 26.0. Vea abajo.
- `check_sql`: comprueba la sintaxis de las instrucciones de Invantive UniversalSQL y PSQL sin ejecutarlas. Disponible a partir de la versión 28.0. Vea abajo.
- `status_get_summary`: devuelve de un vistazo el estado de la página de estado. Vea abajo.
- `status_list_incidents`: lista los incidentes de la página de estado, del más reciente al más antiguo. Vea abajo.
- `status_get_incident`: devuelve un incidente con sus componentes y actualizaciones. Vea abajo.
- `status_create_incident`: abre un incidente en la página de estado. Vea abajo.
- `status_add_update`: publica una actualización de una incidencia, que puede resolverla. Vea abajo.
- `status_set_component_state`: establece el estado de un componente. Vea abajo.
- `status_schedule_maintenance`: planifica un mantenimiento con una ventana de tiempo. Vea abajo.

## Instrucciones para el cliente
Cuando se conecta un cliente de IA, el servidor le envía instrucciones. Indican la versión del servidor y las direcciones en las que la misma base de datos está disponible para otros clientes, con si el usuario activó cada dirección: Invantive MCP Server, el protocolo SQL Server de Invantive UniversalSQL Server para clientes SQL Server y ODBC, Bridge Online para Power BI y App Online para aplicaciones, ambos sobre OData versión 4. También ofrecen consejos para leer de forma eficiente, indican los límites de velocidad de las plataformas y remiten a Invantive Data Hub.

Las instrucciones indican también que Invantive Cloud puede intercambiar datos entre la base de datos y otras plataformas, mediante replicación, combinación o integración. Enumeran los nombres comerciales de esas plataformas, como Exact Online, Salesforce y AFAS Profit. La lista incluye las plataformas para las que Invantive Cloud dispone de un controlador. Se excluyen los controladores de prueba, los auxiliares, los controladores obsoletos y los productos propios de Invantive. La lista está disponible desde la versión 27.0.

## Listado de entidades
`describe_entities` enumera las entidades de la base de datos que se pueden leer, para que un cliente de IA pueda elegir una. No describe una entidad en detalle: `describe_entity` lo hace para una sola entidad. La herramienta acepta dos argumentos, ambos opcionales:
- `entities`: los nombres de las entidades que se van a listar. Un nombre se compara sin distinguir mayúsculas y minúsculas y debe escribirse tal como lo devolvió una respuesta anterior. Se acepta un único nombre o una lista separada por comas en lugar de una matriz.
- `nameOnly`: cuando es verdadero, cada entidad se reduce a su nombre, etiqueta, tipo y contenedor de datos. Úselo solo cuando la respuesta se haya truncado. El valor predeterminado es false.

La respuesta contiene:
- `database`: el segmento de URL de la base de datos.
- `detailLevel`: `summary`, o `namesOnly` cuando se aplicó `nameOnly`.
- `entityCount` y `returnedEntityCount`: el número de entidades que coinciden con la solicitud y el número de entidades en la respuesta.
- `truncated` y `truncationHint`: presente cuando la respuesta contiene menos entidades de las que coinciden. La sugerencia explica cómo hacer una pregunta más precisa, indicando las entidades de interés en `entities`.
- `unknownEntities` y `unknownEntitiesHint`: presentes cuando `entities` contiene un nombre que no existe. La sugerencia indica las entidades existentes más cercanas, para como máximo los cinco primeros nombres desconocidos. `unknownEntitiesHint` está disponible desde la versión 27.0.
- `dataContainers`: un objeto por contenedor de datos, ya que la partición pertenece al contenedor de datos y no a la entidad. Contiene el `alias` que lleva un nombre de entidad después de `@`, el `provider` que sirve al contenedor de datos y si este `supportsPartitions`. Un contenedor de datos que admite particiones también contiene `partitionLabelPlural`, `partitionCount`, `selectedPartitionCount` y `allPartitionsSelected`: el término que usa la plataforma para varias particiones, como divisiones en Exact Online, el número de particiones disponibles, el número que consulta una llamada a `read_records` y si esa es la totalidad.
- `partitioningNote`: cómo se relaciona la partición con las entidades de esta base de datos. Presente cuando al menos un contenedor de datos admite particiones.
- `selectedPartitionCountTotal`: el número de particiones seleccionadas en todos los contenedores de datos.
- `entities`: un objeto por entidad, ordenado por contenedor de datos y después por nombre, de modo que una respuesta truncada omita las mismas entidades en cada llamada.

Una entidad contiene:
- `name`: el nombre que hay que pasar en el argumento `entity` de `read_records` y `describe_entity`.
- `label`: la etiqueta que usa la plataforma para el contenido. Presente solo cuando difiere de `name`.
- `type`: el tipo de objeto, como `table`, `view` o `tablefunction`.
- `dataContainer`: el alias del contenedor de datos que contiene la entidad.
- `rowCountBand`: el orden de magnitud del número de filas, cuando la plataforma proporciona una estimación. El valor es `empty`, `<=100`, `<=1k`, `<=10k`, `<=100k`, `<=1M` o `>1M`.
- `notReadable`: verdadero cuando la entidad no se puede leer. Ausente en otro caso.

Los miembros `rowCountBand` y `notReadable` se omiten cuando se aplica `nameOnly`.

Hasta la versión 26.0 inclusive, cada entidad también contenía `description`, `keyField` y `partitionSpecific`, y un contenedor de datos contenía toda la partición: los términos, la columna de partición y las particiones seleccionadas. Desde la versión 27.0 estos se incluyen en la respuesta de `describe_entity`. Eso mantiene la lista corta y rápida en una base de datos con más de mil entidades.

El tamaño de la respuesta está limitado a 60,000 caracteres por defecto. La configuración `MaxDescribeEntitiesResponseChars` cambia ese límite. Está disponible desde la versión 26.0. El ajuste `MaxEntityDescriptionChars` no se usa desde la versión 27.0, ya que la lista no contiene descripciones.

Los siguientes argumentos enumeran dos entidades de la base de datos:

```json
{ "entities": [ "SalesInvoices", "Accounts" ] }
```

## Describir una entidad
`describe_entity` describe una entidad por completo. Un cliente de IA la llama con un nombre de `describe_entities`, antes de leer la entidad con `read_records`. Está disponible desde la versión 27.0. La herramienta recibe un argumento:
- `entity`: el nombre de la entidad, tal como lo devuelve `describe_entities`. Un nombre se compara sin distinguir mayúsculas de minúsculas. Obligatorio.

Un nombre que no existe se rechaza con el código de mensaje `itgenmcp665`. La sugerencia indica las entidades existentes más cercanas.

La respuesta contiene:
- `database`: el segmento de URL de la base de datos.
- `name`, `label`, `labelSingular`, `type` y `dataContainer`: como en la lista. `label` y `labelSingular` están presentes solo cuando difieren de `name`.
- `description`: qué contiene la entidad, escrito para un usuario de negocio y de forma completa. `documentation` es una explicación adicional, cuando la plataforma la proporciona.
- `partitionSpecific`: verdadero cuando el contenido depende de las particiones seleccionadas. Ausente en otro caso.
- `notReadable`: verdadero cuando la entidad no se puede leer. Ausente en otro caso.
- `rowCountBand` y `estimatedRowCount`: el orden de magnitud del número de filas y la estimación en sí, cuando la plataforma la proporciona. Una estimación no es un recuento.
- `performance`: qué esperar de la velocidad de lectura de la entidad.
- `primaryKey`, `uniqueKeys` y `foreignKeys`: las claves y las relaciones con otras entidades.
- `dataContainerDetails` y `partitioningNote`: el contenedor de datos que contiene la entidad y cómo se relaciona la partición con la entidad.
- `fieldCount`, `returnedFieldCount`, `truncated` y `truncationHint`: el número de campos, el número en la respuesta y, cuando se omiten campos, qué hacer al respecto.
- `fields`: los campos de la entidad.

Un campo contiene:
- `name`: el nombre tal como lo aceptan los argumentos `select`, `filter` y `orderby` de `read_records`.
- `label`: la etiqueta que usa la plataforma. Presente solo cuando difiere de `name`.
- `dataType`: el tipo primitivo de la versión 4 de OData, como `String`, `Int32`, `Decimal`, `DateTimeOffset`, `Boolean` o `Guid`.
- `nullable`: indica si el campo puede estar vacío.
- `maxLength`, `precision` y `scale`: la longitud de un campo de texto o binario y los dígitos de un campo decimal, cuando la plataforma los indica.
- `primaryKey`: true cuando el campo forma parte de la clave primaria. Ausente en otro caso.
- `description`: lo que contiene el campo, escrito para un usuario de negocio.
- `filterOnPlatform`: true cuando la propia plataforma evalúa un filtro sobre el campo, de modo que solo se recuperan las filas que cumplen la condición. False cuando primero se recuperan todas las filas y después se filtran, lo que resulta lento en una entidad grande.
- `sortOnPlatform`: true cuando la propia plataforma ordena por el campo. Ausente cuando no se conoce.

Los miembros `uniqueKeys` y `foreignKeys`, y el `guarantee` de una clave, están disponibles desde la versión 28.0. La versión 27.0 responde la clave primaria sin garantía, ya que su motor no guarda otros metadatos de claves.

Una clave contiene `fields`, `guarantee` y, cuando la plataforma la proporciona, `name`. La garantía es `enforced` cuando la propia plataforma mantiene única la clave, y `declared` cuando el controlador o el modelo la declaran sin que la plataforma la imponga. Los campos de una clave se denominan como los campos de la entidad. Un nombre que no es campo de la entidad se escribe como la plataforma nombra la columna. Una clave que repite la clave primaria no aparece en `uniqueKeys`.

Una clave externa es una relación desde campos de esta entidad hasta la clave de otra entidad. Contiene:
- `fields`: los campos de esta entidad que contienen la referencia.
- `referencedEntity` y `referencedFields`: la entidad referida, con el nombre que le da `describe_entities`, y sus campos, en el mismo orden que `fields`.
- `referencedTable`: el nombre que la plataforma asigna al objeto referido. Presente solo cuando ese objeto no es una entidad de esta base de datos, en cuyo caso `referencedFields` contiene los nombres de columna de la plataforma.
- `kind`: `key` cuando los campos hacen referencia a una clave de la entidad referenciada, `textual` cuando la relación existe solo en palabras y se cumple bajo una condición, y `candidate` cuando se deduce de los nombres de los campos y se cumple en los datos sin que la plataforma lo indique.
- `guarantee`: `enforced` o `declared`, como en el caso de una clave.
- `description`: indica cuándo se cumple una relación `textual` o `candidate`. Una relación de estos tipos no se cumple para todas las filas.
- `name`: el nombre de la clave externa en la plataforma, cuando tiene una.

Este servidor lee una entidad por llamada y no combina datos. Un cliente de IA lee las filas relacionadas con una segunda llamada a `read_records`, filtrando por los valores de `fields`.

El rendimiento contiene los siguientes miembros, cuando el controlador de la plataforma los indica:
- `accessLatencyMs`: el tiempo medio de un viaje de ida y vuelta a la plataforma, en milisegundos.
- `fullScanRowsPerMinute`: el número medio de filas por minuto cuando se lee la entidad completa.
- `pointQueryRowsPerMinute`: el número medio de filas por minuto cuando las filas se leen mediante un filtro sobre una clave.
- `estimatedFullScanSeconds`: una estimación del tiempo para leer cada fila de la entidad, a partir de `estimatedRowCount` y `fullScanRowsPerMinute`. Está presente solo cuando se conocen ambos.

Las cifras son promedios estáticos del driver para la plataforma y no mediciones de esta base de datos. La cifra de escritura no se devuelve, ya que el servidor solo lee. Un driver que no indica cifras deja `performance` fuera.

El tamaño de la respuesta está limitado a 60,000 caracteres por defecto. El ajuste `MaxDescribeEntityResponseChars` cambia ese límite y `MaxSelectedPartitionsDescribed` el número de particiones listadas en `dataContainerDetails`. Ambos están disponibles desde la versión 27.0 y 26.0, respectivamente. Cuando los campos no caben, los campos de las claves van primero. Las claves, las relaciones y el rendimiento nunca se omiten.

Los siguientes argumentos describen una entidad de la base de datos:

```json
{ "entity": "SalesInvoices" }
```

## Lectura de registros
`read_records` lee filas de una entidad. Un cliente de IA la invoca una vez que `describe_entities` ha mostrado qué entidad contiene los datos y `describe_entity` ha listado sus campos. La herramienta acepta los siguientes argumentos:
- `entity`: el nombre de la entidad, tal como lo devuelve `describe_entities`. Obligatorio.
- `select`: una lista de nombres de campos separados por comas, tal como los devuelve `describe_entity`, en la notación `$select` de la interfaz de consulta OData versión 4.
- `filter`: la condición que deben cumplir las filas, en la notación `$filter`, con los operadores `eq`, `ne`, `gt`, `ge`, `lt`, `le`, `and`, `or` y `not`.
- `orderby`: una lista de campos con una dirección, en la notación `$orderby`, como `AmountDC desc`.
- `first`: el número máximo de filas que se leerán. Si se omite, se leen todas las filas que cumplen el filtro.

La lectura se traduce en una sentencia `select` y se ejecuta con la autorización del usuario que ha iniciado sesión. Las filas se devuelven como contenido estructurado, un objeto por fila con los campos seleccionados. No hay cursor ni paginación. Un cliente de IA pasa `first` salvo que quiera el conjunto completo, y acota la respuesta con `filter` y `orderby`.

Un campo o literal que el analizador de OData no conoce se rechaza con el código de mensaje `itgenmcp640`. Cuando el rechazo se refiere a un campo, la sugerencia indica los campos de la entidad más parecidos. Las fechas y los números se escriben sin comillas.

Los siguientes argumentos leen las cinco facturas abiertas más grandes de una entidad:

```json
{ "entity": "SalesInvoices"
, "select": "InvoiceNumber,AmountDC"
, "filter": "Status eq 20"
, "orderby": [ "AmountDC desc" ]
, "first": 5
}
```

## Análisis de una lectura
`analyze_records` recibe los argumentos de `read_records`: `entity`, que es obligatorio, y `select`, `filter`, `orderby` y `first`. La lectura se traduce en la misma instrucción `select`, se ejecuta con la misma autorización y se registra de la misma forma. Sus filas se leen y se cuentan, pero no se devuelven. La respuesta contiene:
- `sqlStatement`: la sentencia `select` que se ejecutó.
- `rowsReturned` y `rowsRead`: las filas que devolvió la sentencia y las filas que leyó de todas las tablas.
- `counters`: lo que contó la sentencia, sumado en todos los pasos, como `PairsEvaluated` o `RowsSorted`; solo los contadores que no son cero.
- `steps`: un objeto por cada paso de la ejecución, como la lectura de una tabla, una unión o una ordenación, con los mismos miembros que una línea del archivo `/steps` de [[Invantive Data Hub/Command Line Options|Invantive Data Hub]]: el tipo y la descripción del paso, las filas de entrada y de salida, la duración, el tiempo de procesador y la asignación incluidos los pasos inferiores, las mismas cifras sin los pasos inferiores tal como las mide [[Invantive UniversalSQL/Grammar/Statement Types/Explain Statement (explainStatement)|explain analyze]], cómo una unión emparejó sus filas, el número de filas que declara una tabla y los contadores del propio paso. Los miembros de un paso se escriben como en esa línea, empezando por mayúscula, como `ExclusiveCpuMs`.

Un cliente de IA lo invoca cuando una lectura es lenta o lee más filas de las que devuelve, por ejemplo para ver si un filtro se pasó al contenedor de datos, qué algoritmo de unión se eligió o qué paso asignó la memoria. Medir cada paso cuesta una lectura del tiempo de procesador por fila y por paso, lo que solo esta herramienta hace.

Los siguientes argumentos analizan la lectura de las cinco facturas abiertas más grandes de una entidad, con los mismos argumentos que `read_records` usaría:

```json
{ "entity": "SalesInvoices"
, "select": "InvoiceNumber,AmountDC"
, "filter": "Status eq 20"
, "orderby": [ "AmountDC desc" ]
, "first": 5
}
```

## Lectura del usuario actual
`current_cloud_user` devuelve el perfil del usuario que ha iniciado sesión y de la organización de ese usuario, tal como se guardan en Invantive Cloud. Un cliente de IA la invoca cuando la respuesta depende de quién pregunta o de a qué organización pertenecen los datos. La herramienta no acepta argumentos y no lee nada de la base de datos.

La respuesta contiene los siguientes miembros del usuario:
- `Uid`, `Iwid` y `CognitoUserId`: los identificadores del usuario, del usuario web y en el proveedor de identidad.
- `Name`, `GivenName` y `FamilyName`: el nombre completo, el nombre de pila y el apellido.
- `Gender`: `M` para masculino, `F` para femenino y `U` para desconocido.
- `JobTitle`: el cargo.
- `EmailAddress`, `PhoneNumber` y `MobileNumber`: cómo llegar al usuario.
- `LanguageCode`: el idioma en formato ISO 639-1. Se usa el idioma predeterminado del servicio cuando el usuario no tiene ninguno.
- `CreatedUtc` y `ModifiedUtc`: cuándo se creó el usuario y cuándo se modificó por última vez.
- `LogInStartUtc` y `LogInEndUtc`: el periodo en el que el usuario puede iniciar sesión.
- `UserIconUrl` y `UserIcon`: la miniatura del usuario como dirección y en forma binaria.

La respuesta contiene los siguientes miembros de la organización del usuario:
- `PartyName`: el nombre de la organización. Primero se usa el nombre del perfil del usuario, y el nombre que tiene la propia organización cuando el perfil no tiene ninguno. La alternativa está disponible desde la versión 27.0.
- `PartyAddressLine1`, `PartyAddressLine2`, `PartyAddressLine3`, `PartyPostalCode`, `PartyCity` y `PartyCountry`: la dirección. Primero se usa el país de la organización, y el país del perfil del usuario cuando la organización no tiene ninguno. La alternativa está disponible desde la versión 27.0.
- `PartyEmailAddress`, `PartyPhone` y `PartyWebSite`: cómo contactar con la organización.
- `PartyLegalStructure`: la forma jurídica, como `NL-BV`.
- `PartyCoCNumber`, `PartyVatNumber`, `PartyIban` y `PartyBic`: el número de la Cámara de Comercio, el número de IVA, el IBAN y el BIC.

Los miembros `PartyCurrencyCode`, `PartyState`, `PartyGlnNumber`, `PartyRsinNumber`, `PartySiretNumber`, `PartyPaypalIdentifier` y `PartyWageTaxNumber` forman parte de la respuesta, pero el servicio no los rellena. Invantive Cloud no tiene ningún valor para ellos.

## Comprobación de la sintaxis de SQL
`check_sql` analiza una o más instrucciones Invantive UniversalSQL y PSQL, separadas por `;`, sin ejecutarlas y sin leer la base de datos. Un cliente de IA la llama sobre una instrucción que escribió para Invantive Data Hub, Invantive Query Tool o un script, antes de que la instrucción consuma presupuesto o cambie datos. Los nombres de tablas y columnas no se comprueban, ya que eso requiere la base de datos. Disponible a partir de la versión 28.0.

La herramienta recibe un argumento, `sql`, con como máximo 1,000,000 caracteres. La respuesta contiene:
- `Valid`: `true` cuando las instrucciones siguen la gramática.
- `MessageCode`, `Message` y `Hint`: el error de sintaxis, su mensaje con un extracto y marcadores de posición, y qué hacer. Los códigos se explican en [[Syntax Errors]].
- `Url`: la dirección de la sección del código de mensaje en [[Syntax Errors]].
- `Position`: `Line` y `Column`, contados desde 1 con un tabulador como una columna, `Offset`, contado desde 0 en el texto, y `Length`, el número de caracteres marcados.
- `Syntax`: `Kind` como `missing` o `premature-end`, `Expected` con lo que es válido en la posición, como lista de elementos sin traducir como `FROM`, `,`, `name` o `expression`, y `Context` con la parte de la instrucción como `whereClause`.

Un error de sintaxis es la respuesta de la herramienta y no un fallo de ella: el resultado no se marca como error.

## Herramientas en Invantive Cloud Status
Las herramientas de estado permiten a un cliente de IA leer y mantener una página de estado de Invantive Cloud Status, por ejemplo para responder si un servicio está caído o para informar de una interrupción. Solo se ofrecen en un servidor donde están definidos los ajustes `StatusPage:Server` y `StatusPage:ApiToken`: la dirección del servidor de estado, como `https://statuspage.invantive.eu`, y un token de API de un inquilino, creado en «Settings» y «API tokens». `StatusPage:TimeoutSec` define el número de segundos que puede tardar una llamada, con un valor predeterminado de 20. Las herramientas todavía no están publicadas.

Las herramientas trabajan sobre las páginas del tenant del token. Basta un token con el ámbito de lectura para las tres herramientas que leen. Las cuatro herramientas que cambian la página de estado necesitan un token con ámbito de escritura; con un token de ámbito de lectura, el servidor de estado las rechaza. Un cambio es visible para los lectores de inmediato y puede notificar a los suscriptores, por lo que se indica al cliente de IA que confirme el texto con el usuario antes de llamar.

Los estados de un componente son `operational`, `degraded_performance`, `partial_outage`, `major_outage` y `under_maintenance`. Las fases de un incidente son `investigating`, `identified`, `monitoring` y `resolved`.

`status_get_summary` no recibe argumentos. La respuesta contiene:
- `overallState`: el estado más grave de los componentes que cuentan para el estado general.
- `componentCount`: el número de componentes.
- `componentsNotOperational`: por cada componente que no esté operativo, su código `component`, `name`, `state` y el momento `since` en que mantiene ese estado.
- `openIncidents`: por cada incidente que no esté resuelto, su `publicId`, `title`, `phase`, `impact` y `startedAt`.
- `maintenance`: el mantenimiento en curso o previsto dentro de siete días, con `publicId`, `title`, `phase`, `windowStart` y `windowEnd`.

`status_list_incidents` acepta dos argumentos opcionales:
- `openOnly`: si es verdadero, solo los incidentes que no están resueltos. El valor predeterminado es false.
- `first`: el número de los incidentes más recientes que se devolverán, de 1 a 100. El valor por defecto es 20.

La respuesta contiene `incidents`, con los mismos miembros por incidencia que `openIncidents` de `status_get_summary`.

`status_get_incident` toma el `publicId` de un incidente, como `2026-0187`. La respuesta es el incidente tal como lo devuelve la API de gestión del servidor de estado, con sus componentes afectados y su estado, su cronología de actualizaciones con su fase y su versión.

`status_create_incident` acepta:
- `title`: el título que ven los lectores. Obligatorio.
- `message`: la primera actualización, para clientes.
- `impact`: uno de `none`, `minor`, `major` o `critical`. El valor por defecto es `minor`.
- `phase`: la fase de la primera actualización. El valor por defecto es `investigating`.
- `template`: el código de una plantilla de incidencia, que completa lo que no se indica.
- `components`: los componentes afectados, cada uno con su código `component` y la `state` que recibe mientras el incidente está abierto.

`status_add_update` acepta:
- `publicId`: el id público del incidente. Obligatorio.
- `message`: el texto de la actualización, para clientes. Obligatorio.
- `phase`: la fase de la actualización. Obligatorio. La fase `resolved` cierra el incidente y devuelve sus componentes a operativos.
- `internalNote`: una nota solo para operadores, que nunca se publica ni se envía.

`status_set_component_state` acepta:
- `component`: el código del componente, tal como lo devuelve `status_get_summary`. Obligatorio.
- `state`: el nuevo estado. Obligatorio.
- `hold`: cuando es verdadero, las sondas no cambian el estado hasta que un operador lo libera. El valor predeterminado es true.

`status_schedule_maintenance` acepta:
- `title`: el título que ven los lectores. Obligatorio.
- `message`: qué ocurre y qué notan los lectores. Obligatorio.
- `windowStart` y `windowEnd`: el inicio y el fin de la ventana como fecha y hora ISO 8601 con desfase horario, como `2026-11-08T06:00:00+01:00`. Obligatorio.
- `components`: los códigos de los componentes afectados.
- `autoStart`: inicia el mantenimiento al comienzo de la ventana. El valor predeterminado es true.
- `autoComplete`: completa el mantenimiento al final de la ventana. El valor predeterminado es true.
- `muteProbes`: silencie las sondas de los componentes afectados durante la ventana de tiempo. El valor predeterminado es true.

Las herramientas que modifican la página de estado devuelven el incidente, el componente o el mantenimiento tal como lo devuelve el servidor de estado tras el cambio.

## Seguimiento del tamaño de una respuesta
Invantive MCP Server escribe en la traza el tamaño de cada respuesta en caracteres. El tamaño es la cantidad de la línea de traza con el código de mensaje `itgenmcp664`, que se escribe en el nivel de depuración. Suma el contenido estructurado y los bloques de texto de la respuesta, y el mensaje indica la herramienta, la base de datos y ambas partes. La línea se escribe tanto para una respuesta correcta como para una fallida, ya que el cliente de IA las lee en su contexto. El envoltorio mensaje JSON-RPC no se cuenta. Disponible a partir de la versión 27.0.

## Cuando falla una herramienta
Una herramienta que falla responde con `isError` activado y los detalles en el contenido estructurado, para que el cliente de IA pueda indicar al usuario qué debe hacer. La respuesta contiene:
- `Message` y `MessageCode`: qué salió mal y el código que hay que citar al pedir ayuda.
- `KindRequest`: la pista, que es el siguiente paso para el cliente de IA o el usuario. Cada respuesta tiene uno. Cuando no se conoce una sugerencia específica, indica si hay que volver a enviar la solicitud, corregirla o informar al usuario.
- `NaturalKey`: de qué trata el mensaje, como la base de datos o la entidad solicitada.
- `IsRecoverable`: verdadero cuando volver a enviar la misma solicitud más adelante puede tener éxito y falso cuando no puede. Se omite cuando nada indica ninguna de las dos cosas.
- `RetryAfterSec`: el número de segundos que el servicio aconseja esperar antes de volver a enviar la misma solicitud, por un bloqueo o por la cabecera `Retry-After` de la plataforma. Está presente solo cuando `IsRecoverable` es verdadero y se recomendó una espera; no se inventa ninguna espera. Cuando la espera es superior a 60 segundos, la sugerencia indica al cliente de IA que deje la espera en manos del usuario. Disponible a partir de la versión 27.0.
- `Actor`: quién debe actuar primero. `ai` cuando el cliente de IA puede corregir la solicitud o esperar y enviarla de nuevo, `user` cuando una persona debe decidir o actuar fuera de la conversación, como en una licencia, una dirección IP o un inicio de sesión, y `forums` cuando nadie puede resolverlo en la conversación, por lo que la referencia y el código de mensaje se buscan o se notifican en los foros. Una espera de más de 60 segundos corresponde al usuario. Disponible a partir de la versión 27.0.
- `HelpUrl`: la dirección del tema del foro o de la página de ayuda sobre el código de mensaje, cuando se conoce. Disponible a partir de la versión 27.0.
- `Uid`: la referencia del fallo, para indicar al soporte.

Una solicitud de una entidad o un campo que no existe indica en la pista los nombres existentes más parecidos. `describe_entities` hace lo mismo con los nombres de su argumento `entities`, en `unknownEntitiesHint`. Ambos están disponibles a partir de la versión 27.0.

Una solicitud desde una dirección IP que no está autorizada para la base de datos se rechaza con el código de mensaje `itgenmcp326`. El mensaje indica la dirección y la sugerencia indica la base de datos a la que debe añadirse.

Una herramienta de estado que falla responde de la misma manera. Cuando el servidor de estado rechaza la llamada, `MessageCode` contiene el código de mensaje del servidor de estado, o `itgenmst001` cuando la respuesta no contiene ninguno. Una denegación por falta de alcance de escritura indica al usuario que solicite un token con alcance de escritura. `itgenmst002` significa que las herramientas de estado no están configuradas en el servidor, y `itgenmst003` que no se puede acceder al servidor de estado.


## Notas de la Versión

- [Invantive MCP Server](/es/release-notes/products/invantive-mcp-server)
  - [De 26.0 a 27.0](/es/release-notes/products/invantive-mcp-server?step=26.0-to-27.0)
