# Instrucciones para el agente: Agentic Inbox: aloja un correo con asistente en Cloudflare

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: avanzado
- Proyecto: https://github.com/cloudflare/agentic-inbox (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/agentic-inbox

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Comprueba en tu cuenta que dispones de dominio, Email Routing para recibir, Email Service para enviar y Workers AI. Para un despliegue compartido, prepara Cloudflare Access y decide quién puede acceder a todos los buzones. Usa el [README oficial](https://github.com/cloudflare/agentic-inbox#how-to-setup) para el botón y las tareas posteriores.

### Paso 1: despliega desde el README

Usa el botón oficial y configura DOMAINS con tu dominio. Después completa After deploying; el despliegue solo no deja el correo operativo.

### Paso 2: configura acceso y correo

En el Worker abre Settings → Domains & Routes y activa Cloudflare Access. Guarda `POLICY_AUD` y `TEAM_DOMAIN` del diálogo como secretos de ese Worker. En dominio → Email Routing crea una regla catch-all (para todas las direcciones) que entregue el correo a este Worker. Habilita Email Service y el enlace `send_email` del Worker según el README. Access es obligatorio fuera del desarrollo local, incluso si el buzón es personal.

### Paso 3: prueba un buzón

Crea una dirección y envía un mensaje de prueba. Revisa un borrador antes de confirmar el envío.

## Comprobación

Verifica recepción, búsqueda, borrador y envío confirmado. Comprueba con qué política compartida se autorizan los usuarios y los clientes MCP.

## Si algo falla

Si aparece Invalid or expired Access token, revisa POLICY_AUD y TEAM_DOMAIN con los valores actuales del panel. Si no llega correo, revisa Routing antes de depurar al modelo.
