Funcionalidad · Plataforma
API REST y servidor MCP para integrar tus sistemas
El Gateway es el punto de entrada para que sistemas externos operen con GDI sin acceder directamente al backend. Cualquier municipio puede conectar su sistema de trámites, tableros de control, scripts de automatización o agentes de inteligencia artificial a través de esta interfaz.
El Gateway expone dos interfaces sobre la misma lógica interna: una REST API para sistemas y scripts, y un servidor MCP para agentes de IA. Ambas comparten la misma capa de operaciones, así que hacen exactamente lo mismo, con distinta forma de autenticarse y de entrar y salir de datos.
- Una sola lógica detrás de dos interfaces: REST para sistemas, MCP para agentes de IA.
- Más de 80 endpoints REST y 42 tools MCP documentados.
- Compatible con Claude, ChatGPT y Gemini vía OAuth 2.0.
- Los mismos permisos de la web se aplican en la API.
- Open source y estándar: integrás sin quedar atado a un proveedor.
Qué podés hacer
Dos interfaces, una sola lógica
REST API y servidor MCP corren sobre la misma capa de tools. Una búsqueda por MCP ejecuta el mismo código que su equivalente REST; solo cambia la autenticación y el formato.
REST API para sistemas
Más de 80 endpoints organizados por dominio (expedientes, documentos, catálogos, notas, memos, legajos, búsqueda semántica). Autenticación por API Key + User ID en headers.
MCP Server para agentes de IA
42 tools de lectura y escritura, compatibles con Claude, ChatGPT y Gemini. El agente se conecta, se autentica con la cuenta del usuario y opera con sus mismos permisos.
Autenticación estándar
REST usa API Key + X-User-ID por headers. MCP usa OAuth 2.0 con JWT (Auth0) y descubrimiento automático de endpoints (RFC 9728 y 8414), sin configuración manual.
Permisos heredados de la web
La API respeta los mismos permisos que la interfaz: cada usuario solo ve los expedientes y documentos a los que tiene acceso según su sector y su rol.
Sin lock-in
GDI es open source y la integración es estándar. Conectás tu sistema de trámites, tableros o bots sin quedar atado a un proveedor.
Cómo funciona
- 1
Obtené las credenciales
El administrador de tu municipio genera una API Key (formato sk-gdi-xxx) y un User ID desde el BackOffice, y te los entrega para la integración.
- 2
Hacé la consulta
Enviás el request a los endpoints /api/v1/* con los headers X-API-Key y X-User-ID. Para agentes de IA, el flujo OAuth del MCP se resuelve solo.
- 3
Recibí los datos
El Gateway valida las credenciales, identifica al usuario y devuelve un JSON con solo los expedientes y documentos accesibles para ese usuario.
REST API: más de 80 endpoints por dominio
La REST API está pensada para scripts, bots, sistemas de trámites y aplicaciones externas donde no hace falta un agente de IA. Se autentica con dos headers obligatorios: X-API-Key y X-User-ID. Si falta cualquiera de los dos, el Gateway responde 401.
Los endpoints se organizan por dominio funcional y devuelven JSON con paginación estándar. La misma key puede tener varios usuarios asociados, para que un sistema externo opere en nombre de distintos funcionarios según el contexto.
- Expedientes: buscar, detalle, historial con resumen IA, crear, transferir, asignar, responsables.
- Documentos: buscar, contenido, importar PDF, crear, firmar, rechazar, vincular a expediente.
- Sistema y catálogos: tipos y estados de documento, sectores, plantillas, usuarios.
- Notas, memos, legajos (RLM) y búsqueda semántica sobre documentos.
MCP Server: GDI para agentes de IA
El MCP Server implementa el Model Context Protocol, el estándar que usan los agentes de IA para conectarse a herramientas. Expone 42 tools de lectura y escritura y es compatible con Claude, ChatGPT y Gemini.
La autenticación es OAuth 2.0 vía Auth0 y es automática para los clientes compatibles: el usuario solo inicia sesión con su cuenta de GDI cuando el navegador se lo pide. A partir de ahí, el agente opera con los mismos permisos que ese usuario tendría en la web. Si el usuario pertenece a varias organizaciones, un tool le permite elegir con cuál trabajar.
- 42 tools de lectura y escritura sobre expedientes, documentos, notas, memos y legajos.
- Compatible con Claude, ChatGPT y Gemini.
- OAuth 2.0 automático: el usuario inicia sesión y el agente hereda sus permisos.
Integración sin lock-in
GDI es open source y el Gateway usa protocolos estándar (HTTP/REST y MCP), así que la integración no ata al municipio a un proveedor. El sistema de trámites que ya usa el municipio, un tablero de control o un bot pueden conectarse sin rehacer nada.
Y como toda la API opera con los permisos del usuario, la seguridad de la interfaz web se traslada tal cual a las integraciones: nadie ve por API lo que no vería en pantalla.
Preguntas frecuentes
¿Cómo obtengo las credenciales?
El administrador de tu municipio genera una API Key y un User ID desde el BackOffice y te los entrega para la integración. La API Key se muestra una sola vez.
¿Qué diferencia hay entre la REST API y el MCP?
La REST API es para scripts, bots y sistemas de trámites (API Key + User ID). El MCP es para agentes de IA que operan en nombre de un usuario vía OAuth 2.0. Comparten la misma lógica interna.
¿La API puede ver todo?
No. Cada llamada opera con los permisos del usuario asociado: solo accede a los expedientes y documentos que ese usuario ve en la interfaz web.
¿Qué clientes de IA son compatibles con el MCP?
Claude, ChatGPT y Gemini. El flujo OAuth es automático: el usuario inicia sesión con su cuenta de GDI y el agente hereda sus permisos.
¿Puedo escribir datos o solo leer?
Ambos. La API permite crear y firmar documentos, mover expedientes, gestionar responsables y más, siempre dentro de los permisos del usuario.
¿Querés el panorama completo?
Mirá cómo esta funcionalidad se integra en la gestión municipal de punta a punta.
Leer másFuncionalidades relacionadas
Velo funcionando hoy mismo
La demo online está abierta — entrás con tu Gmail. Y si preferís, en 30 minutos te hacemos una demo personalizada con los trámites de tu municipio como ejemplo.