En la plataforma de agentes con la que trabajo, los agentes no tocan directamente los sistemas del cliente: lo hacen a través de herramientas expuestas con MCP (Model Context Protocol). Cuando el caso de uso es muy específico de un cliente, esas herramientas las escribo yo. Esta nota explica por qué.
Qué es un MCP server aquí
Un MCP server es un servicio que expone operaciones como herramientas que un agente puede descubrir y llamar. En la plataforma, cada MCP server es un componente más: vive en su propio pod de Kubernetes, escala por su cuenta y deja trazas con OpenTelemetry como el resto.
Superficie mínima
Un servidor genérico suele exponer todo lo que el sistema de debajo sabe hacer. Para un agente corporativo eso es demasiado: cuantas más herramientas ve, más fácil es que elija mal o que haga algo que nadie le pidió.
Cuando lo escribo yo, expongo solo las operaciones que el caso de uso necesita, con los parámetros justos. Si el agente solo tiene que consultar un dato, no ve la operación que lo modifica.
Permisos acotados
La herramienta es el punto donde se decide qué puede hacer el agente sobre un sistema real. Escribirla permite fijar ahí los límites:
- Credenciales propias del servicio, con los permisos mínimos sobre el sistema del cliente.
- Validación de los parámetros antes de llamar al sistema, no después.
- Cada llamada queda trazada: qué agente la pidió, con qué datos y qué devolvió.
Descripciones pensadas para el modelo
El agente decide qué herramienta usar leyendo su nombre, su descripción y su esquema de parámetros. Esa descripción es, en la práctica, parte del prompt. Por eso la escribo pensando en el modelo: qué hace la herramienta, cuándo usarla, cuándo no y qué devuelve, con el vocabulario del negocio del cliente.
Sin depender de integraciones cerradas
Tener el código propio significa poder adaptar la herramienta cuando cambia el caso de uso, probarla con tests como cualquier otro servicio y desplegarla con el mismo pipeline CI/CD que el resto de la plataforma.
En resumen
Escribir el MCP server es más trabajo al principio, pero el agente ve menos, puede hacer menos y entiende mejor lo que tiene a mano. En un entorno corporativo, ese es el equilibrio que busco.