MCP tools del agente

El agente expone estas tools a Claude Desktop via MCP. Claude decide cuál usar según tu pregunta — vos no las invocás directamente. Todas son SELECT-only y respetan la policy de tu organización (allowlist, rate limits, max rows).

`list_tables`

Lista las tablas que el agente puede ver — filtrado por el allowlist de la policy. Claude la usa al principio de una conversación nueva para entender qué hay disponible.

Ejemplo: "¿Qué tablas de SAP están disponibles?"

`describe_table`

Devuelve columnas, tipos y relaciones de una tabla. Claude la usa para entender la estructura antes de armar una query.

Ejemplo: "¿Qué campos tiene la tabla OINV?"

`query`

Ejecuta un SELECT contra una tabla del allowlist. Tiene rate limit (queries/min) y max-rows configurables por la policy. Si el SELECT excede el límite, devuelve sample + un mensaje.

Ejemplo: "Top 5 facturas de venta de este mes"

`sample_data`

Devuelve las primeras N filas de una tabla. Útil para que Claude entienda el formato real de los datos antes de pedir más.

Ejemplo: "Mostrame ejemplos de OITM"

`count_rows`

Cuenta filas con un WHERE opcional. Más eficiente que query cuando solo querés un número.

Ejemplo: "¿Cuántos clientes activos hay?"

`search_columns`

Busca columnas por nombre o tipo en todas las tablas allowlisteadas. Útil cuando no sabés en qué tabla vive un dato.

Ejemplo: "¿Dónde guarda SAP el CUIT del cliente?"

`get_table_relationships`

Devuelve foreign keys entre tablas. Claude la usa para encadenar JOINs implícitos.

Ejemplo: "¿Cómo se relacionan OINV y OCRD?"

Cómo el agente respeta tu policy

Antes de ejecutar cualquier tool, el agente lee la policy de tu organización del cache local (refrescado a cada heartbeat). Si una tabla no está en el allowlist, list_tables y describe_table la excluyen y query la rechaza.