Agentes de IA (MCP)¶
Tus agentes pueden consultar el corpus de tu organización a través del Model Context Protocol, el estándar abierto para conectar asistentes con contexto externo. Mismo corpus, mismas reglas y mismo consumo que tus personas.
Conectar¶
El endpoint es POST /mcp, autenticado con una clave de API.
claude mcp add --transport http renbase https://api.renbase.ai/mcp \
--header "Authorization: Bearer kb_live_..."
Cualquier cliente MCP funciona igual: apúntalo a la URL y pásale la cabecera. Usa una clave por agente para poder revocar una sin tocar las demás.
Herramientas¶
| Herramienta | Qué hace | Coste |
|---|---|---|
get_definition(name) |
Resuelve un término a su definición aprobada, exacto por nombre o alias | gratis |
list_entities(kind?) |
Lista las definiciones aprobadas de la organización | gratis |
search_context(query, kinds?, filters?) |
Busca en documentos y definiciones, con puntuaciones | 1 crédito |
expand_source(chunk_id) |
Despliega una cita en su pasaje completo, su sección padre y sus vecinos | gratis |
ask(question) |
Una respuesta completa con citas y abstención | 1 crédito |
get_definition¶
La herramienta que cambia el comportamiento de un agente. Es una consulta determinista, no una búsqueda por parecido: para «¿qué significa aquí ingresos?», el agente necesita la respuesta gobernada, no el párrafo más cercano. La respuesta trae el cuerpo, el código si lo hay, la versión, quién la aprobó y cuándo se verificó por última vez; y si dos definiciones aprobadas están en conflicto, devuelve las dos en lugar de elegir.
expand_source¶
Las respuestas y los resultados de búsqueda llegan compactos, y cada cita lleva su chunk_id. Cuando el agente necesita más que el extracto, expand_source devuelve el pasaje completo, la sección a la que pertenece y sus vecinos.
No cuesta nada, y ahí está la gracia: desplegar una fuente que ya has pagado no debería costar otro crédito, así que el camino barato es también el correcto. Los agentes que si no repetirían tres veces la misma pregunta para ver más contexto, simplemente lo despliegan.
Qué gana un agente con esto¶
Un agente conectado a Renbase deja de suponer sobre tu negocio. En concreto:
- Usa tu definición de una métrica, no un valor por defecto verosímil del sector.
- Aplica tus reglas condicionales: qué sistema guarda qué registros, y desde cuándo.
- Cita lo que ha usado, así que una persona puede revisar su trabajo.
- Escucha «esto está en conflicto» o «esto no se verifica desde marzo» en lugar de recibir una respuesta rotunda construida sobre nada.
Reglas y límites¶
Los agentes no son una vía privilegiada. La organización de la clave acota todo lo que pueden ver, se aplican los límites de ritmo por organización y las herramientas medidas consumen créditos del mismo saldo que el resto. Un agente no puede aprobar definiciones: aprobar es una acción humana, por diseño.
Todo lo disponible por MCP lo está también por REST —ver la referencia de la API— para integraciones que no hablan el protocolo.