Integración de Model Context Protocol (MCP)

El Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic que permite a modelos de lenguaje (LLMs), IDEs de IA (como Cursor, Windsurf) y agentes de codificación autónomos comunicarse de forma segura con herramientas externas, bases de datos y APIs operativas.

HashEntry proporciona servidores oficiales Streamable-HTTP MCP que permiten a desarrolladores y responsables de privacidad automatizar auditorías de cookies, configurar banners de consentimiento, redactar políticas de privacidad y consultar estadísticas de cumplimiento del RGPD directamente en lenguaje natural dentro de sus flujos de trabajo de IA.

---

Arquitectura y Niveles de Acceso

HashEntry expone tres puntos finales (endpoints) dedicados según el nivel de permisos y seguridad requerido:

Endpoint	Nivel de Acceso	Autenticación	Capacidades
https://system.hashentry.com/mcp/public	Público	Ninguna (Anónimo)	Escanear sitios web, consultar diccionario de cookies, ver planes y base de conocimientos.
https://system.hashentry.com/mcp/tenant	Cliente (Tenant)	Bearer Token (he_mcp_...)	Administrar sitios, iniciar análisis de cookies, actualizar diseño del banner, editar y publicar políticas legales, consultar estadísticas de consentimiento.
https://system.hashentry.com/mcp/reseller	Distribuidor (Reseller)	Bearer Token (he_mcp_...)	Gestionar cartera de clientes, comisiones, saldo y tickets de soporte para distribuidores.

---

Autenticación y Generación de Tokens MCP

Para los servidores de Tenant y Reseller, las solicitudes deben incluir un Token de Acceso Personal (he_mcp_...).

Generación de Tokens desde el Panel de HashEntry

1. Inicie sesión en su Panel de Control de HashEntry.
2. Vaya a Configuración → Tokens de IA y MCP.
3. Haga clic en Crear Nuevo Token MCP, asigne un nombre identificable y período de validez.
4. Copie la clave he_mcp_... generada y guárdela de forma segura.

---

Configuración de Clientes de IA

1. Configuración en Cursor IDE

Cree o edite el archivo .cursor/mcp.json en la raíz de su proyecto:

{
  "mcpServers": {
    "hashentry-public": {
      "url": "https://system.hashentry.com/mcp/public"
    },
    "hashentry-tenant": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_SU_TOKEN_AQUI"
      }
    }
  }
}

2. Configuración en Claude Desktop

Abra su archivo claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añada la configuración:

{
  "mcpServers": {
    "hashentry": {
      "url": "https://system.hashentry.com/mcp/tenant",
      "headers": {
        "Authorization": "Bearer he_mcp_SU_TOKEN_AQUI"
      }
    }
  }
}

---

Referencia de Herramientas MCP Disponibles

1. Herramientas Públicas (/mcp/public)

Disponibles sin inicio de sesión:

• start_cmp_scan: Inicia un escaneo exhaustivo de cookies y cumplimiento legal en cualquier URL web.
• get_cmp_scan_status: Comprueba el estado en segundo plano de un escaneo en curso.
• get_cmp_scan_report: Obtiene el informe final de cookies detectadas, scripts y puntuación de cumplimiento.
• search_cookie_definitions: Busca en la base de datos global de HashEntry clasificaciones, proveedores y duraciones de cookies.
• get_pricing_plans: Consulta los planes de suscripción y límites de cuota vigentes.
• search_knowledge_base: Busca guías técnicas y respuestas legales en la documentación oficial.

2. Herramientas de Cliente (/mcp/tenant)

Requiere token de cliente:

• list_sites: Enumera todos los sitios web registrados en su cuenta.
• get_site: Obtiene la configuración, credenciales y estado de un sitio concreto.
• create_site: Da de alta un nuevo sitio web en la plataforma.
• trigger_site_cookie_scan: Lanza una auditoría periódica de cookies en un sitio registrado.
• list_site_cookies: Muestra las cookies detectadas y sus categorías asignadas.
• get_banner_config: Recupera el diseño, paleta de colores, posición y normativas del banner.
• update_banner_config: Actualiza el diseño y comportamiento del banner de consentimiento.
• list_documents: Enumera las políticas legales (Política de Cookies, Aviso de Privacidad).
• get_document: Obtiene el contenido completo de una política legal.
• save_document_draft: Guarda borradores o revisiones legales redactadas por la IA.
• publish_document: Publica y genera una versión oficial de un documento aprobado.
• get_consent_stats: Proporciona métricas agregadas de aceptación y rechazo de cookies.
• list_tickets y create_ticket: Gestiona consultas y tickets de soporte técnico.
• get_quota_usage: Muestra el consumo actual de cuotas (escaneos, sitios, llamadas API).

3. Herramientas de Distribuidor (/mcp/reseller)

Requiere autorización de distribuidor:

• get_reseller_dashboard: Consulta métricas comerciales, comisiones acumuladas y estado de liquidaciones.
• list_reseller_tenants: Lista las organizaciones cliente asociadas a su agencia.
• create_reseller_tenant: Crea una nueva organización de cliente final.
• list_commissions: Detalla el historial de comisiones devengadas.
• list_reseller_tickets y create_reseller_ticket: Canal de soporte prioritario para distribuidores.