Si eres programador y llevas tiempo viendo cómo la IA puede ejecutar código directamente, pero no sabes cómo aprovechar Claude Code, los agentes y los MCP juntos, este tutorial es para ti. No es magia: es arquitectura.
Claude Code te deja escribir y ejecutar Python o JavaScript en tiempo real. Los agentes son bucles que Claude repite hasta resolver una tarea. Los MCP (Model Context Protocol) conectan Claude con herramientas externas como bases de datos, APIs o sistemas de archivos. Combinados, forman un sistema que ejecuta tareas del mundo real sin intervención manual.
Por qué programadores deberían usar esto ahora
Hoy escribimos prompts y esperamos respuestas. Mañana diremos tareas y veremos cómo se resuelven solas.
Esta diferencia no es semántica. Un agente IA:
- Ejecuta código y ve errores en tiempo real.
- Corre en bucles hasta alcanzar el objetivo.
- Se conecta a herramientas reales mediante MCP.
- Corrige su propio trabajo sin pedirte confirmación.
Por ejemplo: en lugar de escribir un script para limpiar datos, describir el problema a Claude Code y que genere, ejecute y refine el código iterativamente.
Arquitectura básica: entender las piezas
Claude Code: ejecución inmediata
Cuando usas Claude Code, es como tener un terminal colaborativo. Tú hablas, Claude escribe Python o JavaScript y lo ejecuta al instante. Los errores aparecen en pantalla, y Claude los ve y los corrige.
Ejemplo típico:
- Subes un CSV con datos desordenados.
- Le dices a Claude: “Limpia esto, quita duplicados y agrupa por región”.
- Claude Code genera un script, lo corre, te muestra resultados y gráficos.
Agentes: bucles de decisión
Un agente es Claude en modo automático. Define una tarea, una lista de herramientas disponibles, y Claude decide qué herramienta usar, la ejecuta, ve el resultado y repite hasta terminar.
Estructura mínima:
- Definir objetivo.
- Listar herramientas disponibles.
- Claude elige una herramienta.
- Se ejecuta.
- Claude analiza resultado y decide si continúa o termina.
MCP: conectar el mundo real
MCP es un protocolo que conecta Claude con sistemas externos. Imagina que quieres que un agente busque datos en tu base de datos PostgreSQL, genere un reporte en Python y lo guarde en Google Drive. MCP hace que eso sea posible sin escribir API calls manual.
Hay MCPs oficiales y comunitarios para bases de datos, sistemas de archivos, APIs populares y más.
Ejemplo práctico: agente que analiza logs y genera alertas
Scenario: tienes archivos de log en tu servidor, necesitas que alguien identifique errores críticos, genere un resumen y envíe un email automático.
Paso 1: Define el agente
Tarea: Analizar logs del servidor desde la carpeta /var/log/, identificar errores críticos, contar ocurrencias por tipo, generar un informe markdown y guardar en /reports/log_analysis.md.
Herramientas disponibles:
- file_system: leer y escribir archivos.
- python_executor: ejecutar scripts de análisis.
- email_sender: enviar emails (MCP).
Criterio de éxito: informe generado con al menos 3 secciones (resumen, errores por tipo, recomendaciones).Paso 2: Prompt para arrancar el agente
Eres un agente de análisis de logs. Tu objetivo es:
1. Leer todos los archivos .log en /var/log/ del servidor.
2. Identificar líneas que contengan ERROR o CRITICAL.
3. Contar ocurrencias por tipo de error.
4. Generar un informe markdown con estructura:
- Resumen ejecutivo
- Top 5 errores más frecuentes
- Recomendaciones por error
5. Guardar el informe en /reports/log_analysis.md.
6. Si encuentras más de 100 errores críticos, enviar email a ops@empresa.com.
Empieza ejecutando el código necesario. Si hay errores, corrígelos y continúa. Repite hasta completar todo.Paso 3: Claude ejecuta el ciclo
Claude Code lee los logs, genera Python para parsearlos, ejecuta, ve el resultado, genera el markdown, lo guarda, cuenta críticos, y si pasa el umbral, llama al MCP de email.
Una tarea bien definida para un agente es específica en objetivo pero flexible en método. Di QUÉ quieres lograr y QUÉ herramientas tiene disponibles. Claude decide CÓMO.
Cómo empezar: setup mínimo
1. Usa Claude Code en interfaz web
Abrir Claude.ai, activar Code Execution, pega tu prompt. No necesitas configuración.
2. Para agentes más sofisticados: Claude API + librerías
Si quieres un agente que corra de forma autónoma:
import anthropic
client = anthropic.Anthropic(api_key="tu-api-key")
def agent_loop(objetivo, herramientas):
mensajes = [{"role": "user", "content": objetivo}]
while True:
respuesta = client.messages.create(
model="claude-3-5-sonnet-20241022",
max_tokens=4096,
tools=herramientas,
messages=mensajes
)
if respuesta.stop_reason == "end_turn":
break
# Procesar tool_use aquí
mensajes.append({"role": "assistant", "content": respuesta.content})
agent_loop("Tu objetivo aquí", [lista_de_herramientas])3. Integrar MCPs
Hay lista oficial en el repositorio comunitario. Para usar uno:
- Instalarlo via npm o similar.
- Configurar en cliente de Claude.
- Referenciar en definición de herramientas del agente.
Errores comunes que evitar
- Tareas vagas: “Arregla esto” no funciona. Sé específico.
- Sin límites de iteración: un agente sin criterio de parada puede correr para siempre. Define condiciones claras de fin.
- Olvidar manejo de errores: si una herramienta falla, el agente debe saber qué hacer. Explicita esto en el prompt.
- MCPs no configurados: verifica que la herramienta externa esté accesible antes de lanzar el agente.
Qué viene después
Una vez dominas esta tríada, puedes:
- Encadenar múltiples agentes (un agente dispara otro).
- Usar memoria persistente para que el agente aprenda de ejecuciones anteriores.
- Conectar a webhooks para que sistemas externos creen tareas automáticamente.
El punto: Claude Code, agentes y MCPs son piezas de un rompecabezas. Juntas, construyen máquinas que resuelven problemas sin código manual repetitivo.