CCAR-P · Integración
MCP, API/CLI o agente a agente, elegir el mecanismo de conexión
Una empresa quiere que su sistema de tickets se use desde Claude Code, desde Claude Desktop y desde dos agentes propios hechos con el Agent SDK. Uno de los agentes ya tiene definiciones de herramientas escritas a mano que llaman a la API, y el otro equipo estaba por copiarlas. La autenticación de la API cambió dos veces este año, y cada cambio rompió la integración durante días. El problema no es de código: es de mecanismo.
Tres mecanismos, tres preguntas
La elección sale de dos preguntas: ¿cuántos clientes distintos necesitan esta integración? y ¿del otro lado hay una operación o alguien que decide?
| Si el escenario dice… | Conviene |
|---|---|
| Varios clientes (Claude Code, Desktop, agentes propios) necesitan las mismas operaciones | Un servidor MCP (MCP server) |
| Un proceso fijo, con mapeo de campos definido, que no necesita criterio | Una llamada directa a la API o CLI, sin modelo |
| La otra parte es un agente autónomo con sus propias reglas y hay que negociar en varias rondas | Comunicación agente a agente (agent-to-agent) |
MCP: construir una vez, conectar muchos
El Model Context Protocol (Model Context Protocol, MCP) es un estándar abierto para exponer herramientas, recursos y prompts a cualquier aplicación que lo hable. Un servidor se construye una vez y lo usan todos los clientes compatibles: el cambio de autenticación se toca en un solo lugar, y las definiciones de herramientas dejan de estar copiadas en cada agente.
El transporte (transport) depende de dónde corre:
- stdio: el servidor corre como proceso local de la aplicación. Sirve para herramientas en la máquina de cada persona.
- HTTP: servidor remoto, compartido por muchos clientes. Acá entra la autorización con OAuth que viste en la lección 1 (audiencia del token, nada de reenviarlo).
MCP no es gratis: es un servidor más que operar, versionar y asegurar. Si una sola aplicación llama a una API con dos operaciones y nadie más la va a usar, definir las herramientas directamente en esa aplicación también es válido.
API o CLI directa: cuando no hace falta un modelo
Una exportación nocturna de un archivo de estados con un mapeo fijo de campos es un proceso determinista (deterministic process). Pasarlo por un agente como una herramienta que “llama todas las noches” suma costo, latencia y variabilidad sin ningún beneficio. Un script programado que llama a la API REST lo resuelve mejor.
La misma lógica vale para el desarrollo: una CLI puede ser la forma más simple de darle una capacidad a Claude Code en un entorno puntual, pero no es una interfaz común para Desktop y para varios agentes, y reparte credenciales en cada máquina.
Agente a agente: cuando del otro lado alguien decide
Si un proveedor de logística tiene su propio agente que asigna turnos de entrega según capacidad, horas de choferes y compromisos con otros clientes, con reglas que no va a compartir, no podés “reconstruir sus reglas” como herramientas. La decisión es suya. Lo que corresponde es que tu agente negocie con el suyo, en varias rondas de propuesta y contrapropuesta.
Darle a tu agente acceso de lectura a la base de datos del otro tampoco sirve: no da las reglas internas y comparte credenciales entre empresas, que es justo lo que seguridad quiere evitar.
Las trampas típicas
- Copiar las mismas definiciones de herramientas en cada cliente.
- Un agente “dueño” de un sistema para operaciones simples como buscar y comentar.
- Pasar un proceso determinista por un modelo “para tener todo en el agente”.
- Reconstruir como herramientas propias las reglas privadas de otra organización.
- Compartir accesos a bases de datos entre empresas para evitar una integración.
- Cambiar a stdio “para que el token no viaje” cuando los clientes son remotos.
En el examen
Contá los consumidores y mirá quién decide. Si varios clientes necesitan las mismas operaciones, la respuesta es un servidor MCP. Si el escenario describe un mapeo fijo o una tarea programada, buscá la opción sin modelo: un script contra la API. Si la otra parte “tiene su propio criterio”, “no comparte sus reglas” o hay que “negociar”, es agente a agente. En las preguntas de dos respuestas suelen combinarse dos de estos casos.
Pregunta rápida
Una pregunta del simulacro sobre este dominio. Cuenta para tu progreso.
A bank's compliance assistant answers employee questions from about 4,000 internal policies. Policies are revised often, and each revision is added to the index as a new document, while earlier versions are kept because auditors sometimes need to see what applied on a past date.
Employees report that the assistant regularly cites rules that were replaced months ago. Retrieval logs show chunks from superseded and current versions scoring almost the same, since revisions usually change only a few sentences. The team's proposals are telling the model to prefer the newest document and rebuilding the whole index every weekend.
Which indexing change best solves the problem while keeping the audit need?