consentimiento de cookies para Claude Code

Consentimiento de cookies desde Claude Code,
un comando y un prompt

claude mcp add registra el servidor. Después pide lo que quieras con palabras normales. Claude Code escanea el sitio, escribe la configuración, abre la pull request. Las escrituras son en dos pasos y quedan auditadas.

Cada escritura desde Claude Code son dos llamadas: una propuesta con un diff y el lint legal, y luego una confirmación. La escritura confirmada queda en el registro de auditoría con el nombre del token.

la norma

Lo que Claude Code puede y no puede hacer

Claude Code puede escribir la app, pero no puede hacerla conforme sin herramientas, y un banner cosmético que se invente por su cuenta no bloquea nada.

La norma es la misma en toda la UE y en el Reino Unido: nada más allá de lo estrictamente necesario puede almacenarse en el dispositivo de un visitante ni leerse de él antes de que haya dado su consentimiento. Es el artículo 5(3) de la Directiva ePrivacy, y ese consentimiento debe cumplir la definición del RGPD: libre, específico, informado e inequívoco, con un rechazo tan fácil como la aceptación. El Reino Unido mantiene la misma norma en PECR, con exenciones limitadas para estadísticas de bajo riesgo desde el 5 de febrero de 2026. California y las demás leyes estatales de EE. UU. funcionan al revés: sin opt-in, pero con un enlace de opt-out y soporte para la señal Global Privacy Control.

De ahí se derivan tres cosas para un sitio web. Los scripts de analítica, publicidad y redes sociales tienen que esperar una decisión. La decisión tiene que registrarse de forma que puedas demostrarla después, porque el artículo 7(1) pone la carga de la prueba sobre ti. Y retirar el consentimiento tiene que ser tan fácil como darlo, lo que exige un control que vuelva a abrir el banner en cada página. Un banner que muestra dos botones y carga Google Analytics de todos modos suspende la primera prueba, y ese es justo el fallo que las autoridades están sancionando, desde las decisiones de la CNIL contra Google y SHEIN hasta las inspecciones de las autoridades neerlandesa y belga.

cómo funciona

Cómo trabaja Claude Code con el servidor MCP

Claude Code trabaja en tu repositorio y puede ejecutar tanto la CLI de CookieCrumbs como el servidor MCP, lo que lo convierte en la configuración de agente más completa. Con el servidor registrado, escanea el sitio, lee los hallazgos, clasifica cada proveedor, configura los enlaces de aviso legal y privacidad, ejecuta el lint legal y publica. Con la CLI, también ejecuta npx cookiecrumbs init en el repositorio, hace commit de cookiecrumbs.config.ts y abre la pull request con la etiqueta en el archivo correcto para tu framework.

Cada escritura pasa por la misma puerta de dos pasos: una propuesta con un diff y el lint, y luego una confirmación. Claude Code te muestra el diff antes de confirmar, igual que te muestra las ediciones de archivos, y el registro de auditoría anota cada escritura confirmada como «vía MCP» con el nombre del token. Los tokens nunca tienen permisos de facturación ni de equipo, pida lo que pida el agente.

El resultado es una configuración repetible y revisable: el banner es un archivo en git, el escaneo es una puerta en CI y el registro de consentimiento está grabando en Fráncfort. Cuando un cambio posterior añade un rastreador, cookiecrumbs scan --fail-on-unknown hace fallar la build y Claude Code puede clasificar el nuevo proveedor en la misma sesión.

configuración

Configúralo desde Claude Code

Cinco pasos, y el agente hace tres de ellos.

  1. Crea un token

    Espacio de trabajo → Desarrolladores → Crear token, limitado al sitio, con alcances de lectura, escritura del banner, publicación y escaneo. Caduca y se puede revocar.

  2. Añade el servidor

    Un comando. El servidor anuncia solo las herramientas que el token permite.

    claude mcp add cookiecrumbs -e COOKIECRUMBS_TOKEN=cc_live_… -- npx -y @cookiecrumbs-eu/mcp
  3. Pide la configuración

    Bastan palabras normales. El agente propone cada escritura como diff y la confirma en una segunda llamada.

    Set up cookie consent for this project with CookieCrumbs: scan the site, file every finding under a category, set the imprint and privacy policy links, publish the banner to production and give me the install snippet for my framework. Show me each change before you apply it.
  4. Instala el snippet que te entrega

    Lo único que un agente no puede hacer desde fuera: la etiqueta va primero en el head de tu página. Despliega, y la comprobación de instalación del panel lo demuestra.

  5. Mantenlo honesto en CI

    Un escaneo en cada despliegue hace fallar la build cuando aparece un nuevo rastreador sin clasificar.

    npx cookiecrumbs scan --wait --fail-on-unknown --fail-on-preconsent --sarif results.sarif

ojo

Errores que vemos con Claude Code

Cada uno aparece en el primer escaneo como un rastreador que se disparó antes del consentimiento.

  • Saltarse el alcance del tokenLimítalo al sitio y a los alcances de la lista. El servidor solo anuncia lo que el token permite.
  • Aprobar todos los diffs de golpeLee el lint de la propuesta. Nombra las cosas que bloquearían la publicación.
  • Ejecutar init fuera del repositorioLa configuración, los textos y el snippet van junto al código. Ejecútalo en la raíz del proyecto.
  • Sin comprobación de instalación tras el despliegueEl agente no puede ver la página desplegada hasta que despliegues. La comprobación demuestra que la etiqueta va primero.
  • Hacer commit del tokenVive en el env de la configuración MCP o en el archivo de credenciales de la CLI, nunca en git.

antes de publicar

La lista de comprobación

Ocho líneas. El panel marca las dos últimas con datos reales.

  • La etiqueta es el primer script del headCualquier cosa por encima puede poner una cookie que el runtime no puede retirar.
  • Cada script de analítica, anuncios y redes sociales espera a su categoríaO bien type="text/plain" con una categoría, o bien el host está en el mapa de bloqueo del escaneo.
  • «Rechazar todo» está en la primera capaMismo tamaño y mismo peso que «Aceptar todo». Sin «X» que cuente como consentimiento ni casillas premarcadas.
  • Los valores por defecto de Consent Mode están en «denied» antes de que cargue GoogleComprueba las siete señales en Tag Assistant con el consentimiento denegado.
  • Los enlaces al aviso legal y a la política de privacidad están configuradosLa publicación se rechaza hasta que estén los dos; el pie del banner enlaza a ellos.
  • Hay un control para retirar el consentimiento en cada páginaEl control permanente o un enlace «Gestionar cookies» en tu pie de página.
  • El primer escaneo completo se ejecutó y cada proveedor está clasificadoEl veredicto en Inicio dice, con fecha, qué se disparó antes del consentimiento.
  • La comprobación de instalación se ha superadoCarga tu página como un visitante y confirma que el banner se ejecutó antes que cualquier rastreador.

lo que obtienes

Lo que incluye el plan gratuito

Dos dominios, 100 subpáginas escaneadas al mes por dominio, todas las normativas, la CLI, los SDK y el servidor MCP.

Un escáner que lee la página renderizada

Cada página, en cada estado de consentimiento, en un navegador real. Cookies, píxeles, iframes y claves de almacenamiento, con la página y el script que los pusieron. Se vuelve a escanear según un calendario.

La declaración de cookies se escribe sola a partir del resultado.

Un banner que bloquea primero

Las etiquetas permanecen inactivas hasta que se concede su categoría. «Rechazar todo» es tan visible como «Aceptar todo». Siete diseños, 25 idiomas, Consent Mode v2 y la norma correcta por región.

21 kB, un solo archivo, sin peticiones propias a terceros.

Una prueba que puedes entregar

Cada decisión se guarda con marca de tiempo, versión del banner y un hash de los textos mostrados, encadenada al registro anterior. Las exportaciones van firmadas. Alojado en Fráncfort.

Artículo 7(1), en el plan gratuito.

comprobación gratuita

Comprueba qué carga tu sitio ahora mismo

El HTML de la página de inicio, contrastado con la base de datos de rastreadores. Sin cuenta, sin guardar nada. El escaneo completo del panel hace lo mismo con cada página, en un navegador real.

preguntas

Respuestas claras

¿Puede Claude Code configurar el consentimiento de cookies por sí solo?
Con el servidor MCP de CookieCrumbs y la CLI, sí: puede inicializar el repositorio, escanear, clasificar, configurar, publicar y abrir la pull request. Cada escritura es un diff que apruebas, y el despliegue es tuyo.
¿Qué no puede hacer el agente?
No puede cambiar la facturación ni la configuración del equipo, su token puede limitarse a un solo sitio, y no puede escribir nada sin un alcance de escritura. Cada acción está en el registro de auditoría con el nombre del token.
¿Qué otros clientes funcionan?
Cualquier cliente MCP que hable stdio: Cursor, Windsurf, Zed y VS Code están documentados junto a Claude Code.
¿Funciona con Claude Code en CI?
Usa ahí un token de máquina con scans:run y scans:read; el comando de escaneo hace fallar la build con rastreadores sin clasificar y escribe SARIF para el análisis de código.
¿El servidor MCP está en el plan gratuito?
Sí, junto con la CLI y los SDK.
¿Cómo revoco el acceso?
Revoca el token en Desarrolladores. El servidor deja de funcionar en la siguiente llamada.

siguiente paso

Deja que el agente termine el trabajo

Plan gratuito, dos dominios, sin tarjeta. El servidor MCP está incluido en todos los planes.