Empezar gratisPanel
Documentación

MCP para asistentes de IA

El Model Context Protocol (MCP) permite que un asistente de IA trabaje con Cookiemark por ti. Pregunta con tus propias palabras qué sitios tienen problemas, qué ha cambiado desde el último análisis o cuántos visitantes han dicho que sí, y el asistente lo consulta. Está incluido con todos los sitios de pago.

Qué puedes preguntar

  • ¿Cuáles de mis sitios instalan cookies antes de que el visitante acepte, y qué debería corregir primero?
  • Analiza todos los sitios de clientes y dame un informe breve por cliente para nuestra reunión mensual.
  • ¿Han aparecido cookies nuevas en shop.example.com desde el último análisis? ¿Quién las instala?
  • ¿Cuántos visitantes aceptaron el banner en example.com el mes pasado, y desde qué países?
  • Un visitante me ha enviado el ID de consentimiento 1b4e28ba-2fa1-41d2-883f-0016d3cca427. ¿Qué aceptó y cuándo?
  • Compara las tasas de aceptación de todos mis sitios y dime qué banner funciona peor.
  • Revisa el contenedor de Tag Manager de example.com y corrige las etiquetas que se ejecutan antes del consentimiento.

El asistente lee tus sitios, tus análisis y tu registro de consentimientos con las herramientas de abajo. Solo puede iniciar un análisis o publicar un sitio cuando se lo pides, y los buenos clientes MCP te piden confirmación antes.

Conectar

Necesitas una clave. Un propietario o un administrador la crea en Ajustes, Claves de API. Empieza por cmk_; solo la mostramos una vez, así que cópiala enseguida. El servidor está en:

https://cookiemark.com/mcp

Claude Code

claude mcp add --transport http cookiemark https://cookiemark.com/mcp \
  --header "Authorization: Bearer cmk_..."

Cursor, Windsurf y otros clientes con archivo de configuración

{
  "mcpServers": {
    "cookiemark": {
      "url": "https://cookiemark.com/mcp",
      "headers": { "Authorization": "Bearer cmk_..." }
    }
  }
}

Claude Desktop

Añade Cookiemark a claude_desktop_config.json a través del pequeño puente mcp-remote, que necesita Node.js:

{
  "mcpServers": {
    "cookiemark": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cookiemark.com/mcp", "--header", "Authorization: Bearer cmk_..."]
    }
  }
}

Reinicia Claude Desktop y Cookiemark aparecerá entre sus herramientas.

Las herramientas

HerramientaQué hace
list_sitesTodos los sitios, con el estado de publicación de su banner y un resumen de su último análisis.Lectura
get_scan_reportEl último análisis de un sitio: los problemas y cómo resolverlos, las comprobaciones, todas las cookies y los ID de seguimiento encontrados.Lectura
find_new_cookiesLas cookies que encontró el último análisis y que todavía no están en la lista de cookies, con una categoría propuesta.Lectura
consent_statsCómo han respondido los visitantes en un número de días determinado: aceptado, rechazado, elección propia, la tasa de aceptación y los países principales.Lectura
get_consent_logLas elecciones de un sitio, de la más reciente a la más antigua, para el periodo que elijas.Lectura
find_consentTodas las elecciones con un mismo ID de consentimiento, para responder a un visitante que pregunta qué aceptó.Lectura
start_scanInicia un nuevo análisis de un sitio. Un análisis por sitio cada diez minutos.Escritura
publish_sitePublica el borrador actual de un sitio.Escritura
gtm_checkComprueba el consentimiento en el contenedor de Google Tag Manager del sitio y enumera lo que está mal.Lectura
gtm_prepare_fixPone la corrección en un nuevo espacio de trabajo de Tag Manager que puedes previsualizar. No se publica nada.Escritura
gtm_publish_fixPublica la corrección pendiente e inicia un análisis para comprobarla.Escritura

Todas las herramientas que trabajan con un sitio aceptan su dominio, como example.com, o el ID que devuelve list_sites.

Claves y seguridad

  • Una clave pertenece a una organización y solo ve sus sitios.
  • El asistente no puede cambiar los textos, el diseño ni la lista de cookies. Eso lo haces en el panel.
  • Una clave puede hacer 120 peticiones por minuto. Revócala en Ajustes, Claves de API, y el asistente pierde el acceso al instante.
  • Trata la clave como una contraseña: cualquiera que la tenga puede leer tu registro de consentimientos.

Para desarrolladores

El servidor habla MCP sobre Streamable HTTP sin sesiones: envía por POST un mensaje JSON-RPC o un lote a /mcp con la clave como token Bearer, y cada petición recibe una respuesta JSON. Admite las versiones de protocolo 2025-06-18, 2025-03-26 y 2024-11-05. Las herramientas de lectura llevan readOnlyHint; publish_site lleva destructiveHint.