Claude te preguntará qué quieres hacer con tu newsletter, te llevará a la pantalla que toque (el conector en claude.ai o el portal de desarrolladores de Constant Contact) y, cuando estés conectado, te enseñará algo pequeño y de solo lectura para comprobar que funciona. Solo tienes que seguirle.
Quiero conectar mi cuenta de Constant Contact (mi herramienta de email marketing y newsletters) a Claude Code para preparar campañas y consultar mis contactos y los resultados de mis envíos. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir.
CONTEXTO PARA TI
- Hay tres vías y sirven para cosas distintas:
A) El conector oficial de Constant Contact para Claude (lo hace Constant Contact y está verificado por Anthropic): https://claude.com/marketplace/connectors/constant-contact . Servidor https://mcp.apps.constantcontact.com/public_api/mcp, con inicio de sesión en Constant Contact (OAuth), así que ninguna clave pasa por el chat. Nota de Constant Contact: https://community.constantcontact.com/release-notes/post/public-mcp-claude-2K5mIZTYAdAVdTw (pide una cuenta de Claude Individual, Developer, Team o Enterprise). Sirve para CREAR: borradores de campañas de email y de posts para redes, editarlos, ver la vista previa en HTML, comprobar si un email está listo para programarse (devuelve el enlace para programarlo en Constant Contact), puntuar asuntos, subir imágenes a la biblioteca, crear y editar listas, importar contactos y gestionar la dirección física y los remitentes de la cuenta. NO sirve para LEER contactos, listas, campañas pasadas ni informes, y no tiene ninguna herramienta que envíe un email. Sus herramientas pueden cambiar: mira las que tengas.
B) La API V3 de Constant Contact, para LEER: contactos, listas, campañas y sus informes (envíos, aperturas, clics, rebotes, bajas). Doc: https://developer.constantcontact.com/api_guide/getting_started.html . Base https://api.cc.email/v3: GET /contact_lists, GET /contacts, GET /emails y GET /reports/summary_reports/email_campaign_summaries (resumen de hasta las últimas 500 campañas); el detalle de aperturas, clics, rebotes y bajas de cada envío está en /reports/email_reports/{campaign_activity_id}/tracking/... (https://developer.constantcontact.com/api_guide/email_reporting_overview.html). Ojo: los permisos contact_data y campaign_data son de lectura Y escritura (no existe uno solo de lectura para contactos ni campañas), así que el «solo lectura» lo pones tú con las reglas de abajo.
Para usarla hace falta crear una aplicación propia en el portal de desarrolladores: https://app.constantcontact.com/pages/dma/portal/ . Ese portal manda al inicio de sesión normal de Constant Contact: tengo que entrar con MI usuario de siempre. Si me ofrece «Sign up», NO: eso crea una cuenta de prueba aparte y la aplicación no podría leer mi cuenta real, porque una aplicación nueva es privada y solo la puede autorizar el usuario que la creó. Pasos: My Applications → New Application → un nombre (por ejemplo «Claude») → Device Authorization Flow (no necesita client secret ni URL de redirección) → Rotating Refresh → Create; luego «edit» en la aplicación y en Details está la API Key (el client_id).
El flujo de dispositivo (https://developer.constantcontact.com/api_guide/device_flow.html): POST a https://authz.constantcontact.com/oauth2/default/v1/device/authorize con client_id y scope «contact_data campaign_data offline_access»; me enseñas el enlace de verificación con el código, yo inicio sesión y autorizo; tú consultas https://authz.constantcontact.com/oauth2/default/v1/token cada «interval» segundos hasta tener el token. El token de acceso dura 24 horas; el de refresco caduca si pasan 180 días sin usarlo y cada refresco devuelve uno nuevo que hay que guardar en lugar del anterior (https://developer.constantcontact.com/api_guide/auth_overview.html). El endpoint de tokens tiene su propio límite: refresca solo cuando el token haya caducado o esté a punto.
Límites: 10.000 peticiones al día y 4 por segundo; si me paso, responde 429 (https://developer.constantcontact.com/api_guide/rate_limits.html).
C) Sin conectar nada: exportar los contactos a CSV desde la web de Constant Contact (Contactos → seleccionar → Actions → Export selection → elegir campos → Export → descargar el CSV desde la actividad de exportación; https://knowledgebase.constantcontact.com/articles/KnowledgeBase/5295-exporting-a-contact-list-from-constant-contact) y dejar el fichero en esta carpeta para que lo leas. Si mi cuenta tiene un botón de exportar en la sección de informes, también vale para los resultados de las campañas: compruébalo en la ayuda oficial antes de mandarme a buscarlo.
- En Claude Code, los conectores de claude.ai salen solos en /mcp solo si Claude Code tiene la sesión iniciada con mi suscripción de claude.ai (no con una API key); /status enseña con qué he iniciado sesión. El conector se activa en https://claude.ai/customize/connectors (Personalizar → Conectores → «+» → Explorar conectores → Constant Contact → Conectar). Doc: https://code.claude.com/docs/en/mcp.md , «Use MCP servers from claude.ai».
- No uses servidores MCP de la comunidad ni plataformas de terceros para Constant Contact.
QUÉ QUIERO QUE HAGAS
1. ENTENDER: pregúntame, de una en una y con opciones para elegir: qué quiero (preparar newsletters y campañas, consultar mis resultados y contactos, o las dos cosas); si es algo puntual o recurrente; y si mi usuario de Constant Contact es el dueño o administrador de la cuenta.
2. REVISAR: comprueba tú mismo qué hay ya: si Claude Code ve las herramientas del conector de Constant Contact (/mcp o sus herramientas), con qué he iniciado sesión (/status) y si ya hay algo montado para la API en mi usuario. Si lo que necesito ya está y responde, salta al paso 5.
3. RECOMENDAR: dime en dos frases qué vía encaja. Para preparar campañas, el conector (A). Para leer resultados o contactos, la API (B), o el CSV (C) si es algo puntual o si prefiero no crear una aplicación en el portal. Si quiero las dos cosas, conector más API. Nunca un servidor de la comunidad.
4. CONECTAR:
- Conector: si Claude Code no tiene la sesión iniciada con mi suscripción de claude.ai, dímelo primero y explícame cómo cambiarlo. Llévame a https://claude.ai/customize/connectors (ábrelo tú si tienes navegador). Yo busco Constant Contact, pulso Conectar e inicio sesión con mi usuario; antes de aprobar, dime en una frase qué estoy dando y que puedo rechazarlo. Cuando te diga «OK», comprueba que ves sus herramientas; si no, dime cómo reiniciar Claude Code.
- API: llévame al portal (https://app.constantcontact.com/pages/dma/portal/) y guíame para crear la aplicación con los pasos de arriba, recordándome que entre con mi usuario de siempre y no con «Sign up». Cuando haya copiado la API Key y te diga «OK», léela tú del portapapeles (pbpaste en Mac; Get-Clipboard de PowerShell en Windows), sin repetirla en el chat, y vacía el portapapeles. Monta un script pequeño (en Python, en un entorno aislado dentro de una carpeta privada de mi usuario) que haga el flujo de dispositivo, guarde los tokens en un fichero privado de mi usuario sin mostrarlos nunca, refresque el token cuando caduque guardando siempre el nuevo, y tenga órdenes simples de solo lectura: listas, contactos de una lista, campañas recientes y el resumen de resultados. Enséñame el enlace y el código para autorizar; cuando te diga «OK», comprueba que funciona.
- CSV: dime en tres pasos cortos cómo exportar lo que necesito y dónde dejar el fichero; cuando te diga «OK», léelo.
5. PROBAR (solo lectura): con el conector, enséñame los remitentes de mi cuenta y la dirección física que sale al pie de los emails. Con la API, enséñame en tablas cortas mis listas (nombre y número de contactos) y mis últimas 5 campañas con envíos, aperturas, clics y bajas. Con el CSV, cuántos contactos hay y qué columnas trae. No crees nada en esta prueba.
6. RECORDAR: crea una skill personal con cómo te conectas (conector, API o CSV), lo que suelo pedirte, los límites de la API y las reglas de abajo. Así la próxima vez me basta con preguntarte.
Reglas: trabaja en solo lectura salvo que yo pida otra cosa, aunque el permiso que te di permita escribir. Nunca envíes ni programes un email ni publiques un post: prepara el borrador, enséñamelo completo (asunto, remitente, lista de destino y cómo se ve) y el envío o la programación los hago yo en Constant Contact, porque un correo enviado no se puede recuperar. Pídeme permiso, uno a uno y enseñándome antes lo que vas a hacer, para cualquier cambio: crear o editar una campaña o un post (programar un post en redes lo publica), importar o cambiar contactos, crear o cambiar listas, añadir un remitente (Constant Contact le manda un correo de verificación) o cambiar la dirección física. No borres nada. Antes de cambiar cualquier dato, guarda el original en un fichero de esta carpeta para poder volver atrás. Mis contactos son datos personales de terceros: no los copies fuera de mi ordenador ni a ningún otro servicio sin preguntarme. Respeta los límites de la API: nada de recorrer la cuenta entera; pide solo lo que haga falta. Nunca me pidas una clave o una contraseña en el chat. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo.
CÓMO TRABAJAR CONMIGO
- Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano.
- Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción.
- Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo.
- Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado.
- Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones.
- Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill.
- La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill.
- Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle):
hooks:
Stop:
- hooks:
- type: command
once: true
command: |
grep -q '"stop_hook_active":true' && exit 0
echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'