Cómo construir un resumenador y planificador de reuniones con Claude Code y MCP

Introducción

La pérdida de notas y tareas después de reuniones es un problema recurrente en organizaciones de todos los tamaños. Aquí presentamos una solución práctica: un agente que procesa transcripciones, genera resúmenes con decisiones y acciones, crea eventos en calendario y envía recapitulaciones por correo. El sistema usa Claude Code como motor de IA y MCP (Model Context Protocol) como adaptador universal para integrarse con servicios externos como Google Calendar y Gmail, almacenando resultados en SQLite.

Además de explicar la arquitectura y los componentes, incluimos los pasos para poner en marcha el flujo de trabajo en su entorno. Este enfoque es útil para equipos en Latinoamérica que buscan automatizar seguimientos, mejorar la trazabilidad de decisiones y reducir trabajo manual después de reuniones.

¿Qué es el Model Context Protocol (MCP)?

MCP es un esquema estándar que permite a modelos como Claude interactuar con sistemas externos mediante una interfaz basada en herramientas y esquemas JSON. Funciona como un contrato: el modelo descubre herramientas disponibles, valida la entrada contra un schema y solicita la ejecución de la acción. El servidor MCP se encarga de hablar con la API real del servicio (por ejemplo, Google Calendar).

Beneficios clave:

• Abstracción: cambiar de proveedor (por ejemplo, Gmail a Outlook) solo requiere un servidor MCP distinto, no reescribir la lógica del agente.
• Validación: los esquemas aseguran que las llamadas lleguen con formato correcto, evitando entradas malformadas.
• Observabilidad: las respuestas estructuradas permiten auditar y reenviar errores con facilidad.

Conceptos esenciales en la práctica:

• tools/list: descubre qué herramientas están disponibles en tiempo de ejecución.
• tools/call: invoca una herramienta con entrada JSON estructurada.
• inputSchema: valida entradas antes de ejecutar llamadas externas.
• tool_result / isError: devuelve resultados estructurados y señales de falla.

Arquitectura del agente

El agente sigue una canalización de etapas aisladas que pueden fallar, reintentarse o ser omitidas —un diseño pensado para entornos de producción:

1. Ingesta (Loader): lee transcripciones (.txt, .vtt, .json) y normaliza a texto plano.
2. Análisis (Claude): con prompts, extrae resumen, decisiones, items de acción, responsables y plazos.
3. Validación (Schema Validator): confirma que la salida cumpla el esquema JSON esperado.
4. Persistencia (SQLite): almacena resúmenes, decisiones y tareas para auditoría y búsquedas posteriores.
5. Despacho (MCP Tool Wrapper): crea eventos en calendario y envía correos vía MCP.
6. Confirmación (Auditor): verifica que las llamadas externas tuvieron éxito y encola reintentos si fue necesario.

Este flujo permite supervisión por etapa y facilita la integración en pipelines existentes.

Antes de empezar: requisitos

• Acceso a Claude Code (CLI) y credenciales válidas.
• Proyecto de Google Cloud con OAuth para Google Workspace si usará Calendar/Gmail.
• Node.js y npm para instalar utilidades locales.
• Un entorno donde pueda ejecutar procesos que conecten con los servidores MCP.

Paso 1 — Instalar Claude Code

Instale la herramienta de línea de comandos de Claude Code que servirá como shell del agente:

npm install -g @anthropic-ai/claude-code

Verifique la instalación con:

claude —version

Luego inicie una sesión interactiva:

claude

En esa shell usted podrá enviar instrucciones en lenguaje natural que Claude transformará en acciones y llamadas MCP.

Paso 2 — Estructura del proyecto y memoria persistente

Cree una carpeta dedicada al agente y subcarpetas para transcripciones y salidas:

mkdir meeting-agent && cd meeting-agent mkdir -p transcripts summaries .claude/commands

Claude Code usa un archivo CLAUDE.md en la raíz del proyecto como memoria e instrucciones permanentes. En esa nota escriba las reglas de extracción, supuestos y nombres de servidores MCP. Un ejemplo de contenido a proporcionar al modelo podría ser:

• El agente leerá archivos .txt/.vtt de /transcripts.
• Extraerá acciones con responsable y plazo; si no hay plazo explícito, asumir 3 días hábiles.
• Los responsables deben coincidir con nombres mencionados en la transcripción.
• Guardará resúmenes en /summaries y registrará todo en SQLite.
• Los servidores MCP se llaman ‘gcal’ y ‘gmail’.

Solicite al modelo que genere ese archivo desde la shell de Claude para asegurarse de tener la memoria del proyecto configurada.

Paso 3 — Registrar servidores MCP con la CLI de Claude Code

Claude Code dispone de un comando integrado mcp para vincular servidores. Para cada servicio externo ejecute un comando de registro. En el caso de Google Workspace (Calendar + Gmail) necesitará crear credenciales OAuth en Google Cloud y luego agregar el servidor:

claude mcp add —transport stdio google-workspace — npx -y google-workspace-mcp —client-id SU_CLIENT_ID —client-secret SU_CLIENT_SECRET

Valide la registración con:

claude mcp list

Verá algo como “google-workspace stdio npx -y google-workspace-mcp” si todo quedó registrado.

Nota: el mismo patrón aplica si decide cambiar a otro proveedor: solo reemplace el servidor MCP correspondiente.

Paso 4 — Comando para procesar reuniones

Implemente un comando (por ejemplo un slash-command) que el agente reconozca como gatillo para procesar una transcripción. El flujo típico es:

1. El loader detecta un archivo en /transcripts con metadatos (fecha, asistentes).
2. Claude analiza y genera JSON con campos: summary, decisions, action_items (owner, deadline, description).
3. El validador confirma esquema y escribe en SQLite.
4. El wrapper MCP crea eventos en Google Calendar para cada acción con fecha límite y envía un correo de recap.

En la práctica, desde la shell de Claude basta con una instrucción en lenguaje natural como: “Procesa transcripts/reunion-2026-03-01.vtt y genera resumen, tareas y eventos”. Gracias al MCP registrado, Claude resolverá las llamadas externas automáticamente.

Paso 5 — Poniendo en marcha y recomendaciones operativas

Ejecute el agente desde la terminal y vaya probando archivos de ejemplo. Monitoree la base SQLite para asegurar consistencia. Para entornos corporativos en Latinoamérica considere:

• Políticas de privacidad y residencia de datos: revise cómo y dónde se almacenan las transcripciones y la base SQLite.
• Control de accesos: limite quién puede invocar el agente y quién recibe los correos automáticos.
• Ajuste de idioma y nombres: entrene prompts para reconocer variantes de nombres y expresiones comunes en la región.

Conclusión

Combinar Claude Code con MCP permite construir un resumenador y planificador de reuniones robusto y modular. La separación entre la lógica del agente y los adaptadores MCP facilita el mantenimiento y la migración entre proveedores. Para equipos en Latinoamérica, este tipo de automatización reduce la fricción post-reunión y mejora la trazabilidad de decisiones y tareas.

Puntos finales:

• MCP actúa como puente estandarizado entre Claude y servicios externos.
• La canalización por etapas aporta resiliencia y capacidad de auditoría.
• Conectar Google Calendar y Gmail requiere configuración OAuth y registro del servidor MCP una sola vez.

Si desea, puedo ayudar a adaptar los prompts para su idioma, o a diseñar el esquema JSON de salida que mejor encaje con sus flujos internos.