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/mcpClaude 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
| Herramienta | Qué hace | |
|---|---|---|
list_sites | Todos los sitios, con el estado de publicación de su banner y un resumen de su último análisis. | Lectura |
get_scan_report | El ú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_cookies | Las 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_stats | Có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_log | Las elecciones de un sitio, de la más reciente a la más antigua, para el periodo que elijas. | Lectura |
find_consent | Todas las elecciones con un mismo ID de consentimiento, para responder a un visitante que pregunta qué aceptó. | Lectura |
start_scan | Inicia un nuevo análisis de un sitio. Un análisis por sitio cada diez minutos. | Escritura |
publish_site | Publica el borrador actual de un sitio. | Escritura |
gtm_check | Comprueba el consentimiento en el contenedor de Google Tag Manager del sitio y enumera lo que está mal. | Lectura |
gtm_prepare_fix | Pone la corrección en un nuevo espacio de trabajo de Tag Manager que puedes previsualizar. No se publica nada. | Escritura |
gtm_publish_fix | Publica 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.