01 La pregunta clave: quién habla con quién
| API | MCP | A2A | |
|---|---|---|---|
| Quién habla | Tu aplicación con un modelo o servicio | Un modelo o agente con tus herramientas y datos | Un agente con otro agente |
| Ejemplo | Tu web envía una pregunta a Claude y muestra la respuesta | Claude Code consulta tu base de datos o tu Notion | Un agente de compras pide presupuesto a un agente de un proveedor |
| Origen | Concepto general del software | Protocolo abierto creado por Anthropic | Protocolo abierto aportado por Google, hoy en la Linux Foundation |
| Formato | Depende del servicio (normalmente HTTP y JSON) | JSON-RPC 2.0 sobre stdio o HTTP | JSON-RPC 2.0 sobre HTTP(S), con streaming opcional |
| Complejidad para empezar | Baja | Baja si usas servidores ya hechos | Alta: tiene sentido entre sistemas de distintas empresas |
No compiten entre sí: se apilan. Un agente usa una API para pensar (el modelo), MCP para tocar herramientas y, si necesita a otro agente que no controla, A2A para delegarle trabajo.
02 API: tu aplicación hablando con el modelo
Una API es un contrato: envías una petición con un formato concreto a una dirección y recibes una respuesta con otro formato concreto. Con la API de Claude, la petición lleva el modelo, los mensajes y tu clave; la respuesta trae el texto generado. Todo producto que «lleva IA dentro» funciona así por debajo, y tú decides qué haces con la respuesta: mostrarla, guardarla o pasarla a otro proceso.
# pip install anthropic
# export ANTHROPIC_API_KEY=...
from anthropic import Anthropic
client = Anthropic()
respuesta = client.messages.create(
model="claude-opus-5-5",
max_tokens=500,
messages=[{"role": "user", "content": "Clasifica este correo como urgente, normal o spam: ..."}],
)
print(respuesta.content)03 MCP: el modelo usando tus herramientas
El Model Context Protocol estandariza cómo un modelo descubre y usa herramientas externas. Un servidor MCP expone capacidades (leer archivos, consultar una base de datos, crear una tarea) con una descripción de qué parámetros acepta cada una. El cliente (Claude Code, la app de Claude, tu agente) las lista y decide cuándo llamarlas. Así no tienes que copiar datos al chat: Claude va a buscarlos.
Hay dos formas de transporte: stdio, cuando el servidor es un proceso que corre en tu ordenador, y HTTP, cuando es un servicio remoto con su propia autenticación.
# Servidor local: acceso a una carpeta concreta (servidor de referencia oficial)
claude mcp add --transport stdio archivos -- npx -y @modelcontextprotocol/server-filesystem ~/Documentos/proyecto
# Servidor remoto por HTTP
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Ver los que tienes configurados
claude mcp listDentro de una sesión, /mcp muestra el estado de cada servidor y permite autenticar los remotos. Con --scope project el servidor queda en un .mcp.json que compartes con tu equipo; con --scope user, disponible en todos tus proyectos.
04 A2A: agentes que se delegan trabajo
El protocolo Agent2Agent resuelve otro problema: que dos agentes construidos por empresas distintas, con frameworks distintos y en servidores distintos, colaboren sin exponer sus herramientas ni su memoria interna. Cada agente es una caja negra que se anuncia y acepta tareas.
Agent Card
Un JSON que el agente publica, normalmente en /.well-known/agent-card.json, con su nombre, lo que sabe hacer, cómo conectarse y qué autenticación exige.
Task
La unidad de trabajo. Pasa por estados como enviada, en curso, necesita información, completada, fallida o cancelada.
Mensajes y artefactos
Los agentes intercambian texto, archivos o datos estructurados, y el resultado final se entrega como artefactos.
Modos de respuesta
Petición y respuesta, streaming para ver el progreso o notificaciones push para tareas largas.
pip install a2a-sdk # Python
npm install @a2a-js/sdk # JavaScript
dotnet add package A2A # .NET05 Qué necesita tu proyecto
-
1
Quieres IA dentro de tu web o tu app
Empieza por la API. Es lo más simple y suficiente para chatbots, clasificadores o generadores de texto.
-
2
Quieres que Claude trabaje con tus herramientas
Añade servidores MCP o conectores: CRM, base de datos, gestor de tareas, documentos. Es lo que más productividad da en el día a día.
-
3
Quieres un agente que haga tareas completas
Combina API y MCP con un bucle de agente, por ejemplo con el Agent SDK.
-
4
Tu agente debe colaborar con agentes de terceros
Ahí entra A2A: publicas una Agent Card y aceptas tareas de otros sistemas con autenticación.
Quiero automatizar este proceso de mi empresa: [describe el proceso, las herramientas que usamos y quién interviene].
Explícame, sin jerga:
1. Qué partes resolvería con una llamada a la API, cuáles con servidores MCP y si alguna justificaría A2A.
2. Qué servidores MCP existentes podría usar y qué permisos mínimos necesitan.
3. Los riesgos de seguridad principales y cómo limitarlos.
4. El primer paso más pequeño que puedo probar esta semana.Preguntas frecuentes
No. Muchos servidores MCP llaman por dentro a la API de un servicio. MCP añade una capa estándar para que el modelo descubra y use esas capacidades sin que tengas que programar una integración distinta para cada cliente.
No. Es un protocolo abierto y lo soportan otros asistentes, editores y frameworks de agentes. Un mismo servidor MCP sirve para varios clientes.
Son complementarios. MCP conecta un agente con herramientas y datos; A2A conecta agentes entre sí. Un agente puede usar MCP internamente y exponerse a otros mediante A2A.
Para usar servidores existentes, no: en la app de Claude se añaden como conectores con unos clics, y en Claude Code con un comando. Programar solo hace falta si quieres crear tu propio servidor.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.