Agentes de IA y MCP

Tu agente de programación o asistente de IA puede trabajar tu bandeja de entrada de Campbooks igual que tú — triando correos, revisando documentos, confirmando recordatorios, redactando respuestas para tu aprobación, y más. Lo hace a través de MCP (Model Context Protocol), expuesto en /api/mcp en cualquier instancia de Campbooks.

Qué permite

Conecta un agente compatible con MCP — Claude Code, Cursor, Windsurf, OpenAI Codex CLI u otro cliente — y ganará acceso a tu bandeja de entrada en lenguaje natural:

• Triage y skim — lee el mazo de skim, aplica decisiones de archivar/conservar clúster a clúster, y localiza hilos donde falta una respuesta tuya.
• Documentos — revisa facturas y recibos pendientes, apruébalos o recházalos, actualiza campos extraídos y archiva documentos en carpetas.
• Tareas y recordatorios — confirma o descarta tareas y recordatorios extraídos por IA; crea tareas a partir de correos.
• Eventos de calendario — lista eventos próximos, crea eventos a partir del contexto de correos, responde invitaciones (RSVP).
• Contactos — busca contactos, marca como favoritos los que importan, bloquea remitentes no deseados.
• Redactar con confirmación — borra una respuesta o un correo nuevo, te lo muestra primero y solo lo envía tras un "sí" explícito tuyo.

Dos cosas mantienen esto seguro: los scopes de la clave MCP limitan lo que el agente puede hacer (concede emails:send solo si quieres que redacte correo), y las skills que distribuimos instruyen al agente a mostrarte cada borrador y a nombrar a cada remitente antes de enviar, borrar o bloquear. Si conectas otro agente, dale la misma regla.

Cómo está construido

El servidor MCP en POST /api/mcp es una capa de protocolo fina sobre la misma REST API pública que impulsa el CLI e integraciones de terceros. Eso significa:

• Mismos controles de permisos — la clave MCP lleva los mismos OAuth scopes que cualquier cliente de API. Un agente con emails:read puede leer correo; no puede enviar a menos que también le concedas emails:send. Los permisos de buzón del usuario siguen aplicando: una cuenta desde la que no puedes enviar en la aplicación, el agente tampoco puede.
• Misma regla 404-no-403 — los recursos que pertenecen a otro espacio de trabajo devuelven 404, no 403, para que el agente nunca sepa si algo existe fuera de tus datos.
• Diseño de contexto mínimo — el servidor expone dos tools que cada cliente autenticado obtiene gratis, independientemente del scope: get_overview (un snapshot rápido de lo que necesita atención: correos no leídos, documentos pendientes, recordatorios vencidos, eventos de hoy) y guide (guías narrativas para flujos de trabajo habituales). Un agente debería llamar a get_overview primero y leer una guía antes de continuar, manteniendo bajo el uso de tokens.

Los tools aparecen en tools/list solo para los scopes que tiene una clave. Una clave de solo triage ve unos 15 tools; una clave completa ve los 72.

Qué necesitas

• Una cuenta de Campbooks — Campbooks Cloud o una instancia autoalojada.
• Una clave MCP creada en Ajustes → Acceso a la API. A diferencia de los tokens OAuth de corta duración (caducan en 2 horas), una clave MCP no caduca — está pensada para configuraciones estáticas de agentes.

Eso es todo. No se necesita registro adicional ni servicios extra en marcha.

Próximos pasos

• Plugin para Claude Code — instalación desde el marketplace, las dos skills (/campbooks:setup, /campbooks:triage) y un recorrido por una sesión típica.
• Otros agentes — configuraciones de copiar y pegar para Cursor, Windsurf, OpenAI Codex CLI y Gemini CLI.
• Referencia MCP — catálogo completo de tools, formas de autorización, scopes, límites de velocidad y garantías de seguridad.