Servidor MCP · para desarrolladores

El consentimiento de cookies, configurado por tu agente de IA.

Q: ¿Funciona en localhost?

Sí. Una clave publicable de TEST acepta `localhost: ` como origen permitido, así que el banner funciona en tu servidor de desarrollo antes de tener dominio. Nuestro rastreador en la nube solo llega a URLs públicas; para localhost, el agente puede importar las cookies que observe en un navegador.

Conecta el servidor MCP de Croombit a tu IDE o agente de código —Claude Code, Cursor, VS Code, JetBrains, Codex, Gemini CLI y más— y pide un banner de cookies en lenguaje natural. En unos cinco minutos funciona en tu localhost en TEST: sitio, categorías de cookies, banner, clave y la etiqueta script en tu layout. En unos diez, también el resto de tus consentimientos.

Conéctalo →Crear una cuenta gratis

Gratis en todos los planes OAuth 2.1, sin claves que pegar Datos alojados en la UE

Conéctalo en un paso

El servidor está en https://mcp.croombit.com/mcp (Streamable HTTP). La primera llamada abre tu navegador: inicias sesión, eliges la organización y marcas los permisos que concedes. No hay ninguna clave de API que copiar en un fichero de configuración.

IDEs y editores

CursorUn clic

Pulsa el botón o añádelo al fichero de abajo. Cursor te pide iniciar sesión la primera vez que usa el servidor.

Instalar en un clic →

~/.cursor/mcp.json

{
  "mcpServers": {
    "croombit": {
      "url": "https://mcp.croombit.com/mcp"
    }
  }
}

Documentación oficial ↗

VS CodeUn clic

Pulsa el botón o añádelo al fichero de abajo (modo agente de GitHub Copilot). VS Code abre el navegador para autorizar.

Instalar en un clic →

.vscode/mcp.json

{
  "servers": {
    "croombit": {
      "type": "http",
      "url": "https://mcp.croombit.com/mcp"
    }
  }
}

Documentación oficial ↗

Visual Studio

Visual Studio 17.14 o posterior. Añade el fichero de abajo y usa el CodeLens Authentication Required que aparece sobre el servidor para iniciar sesión.

%USERPROFILE%\.mcp.json

{
  "servers": {
    "croombit": {
      "url": "https://mcp.croombit.com/mcp"
    }
  }
}

Documentación oficial ↗

JetBrains · Junie

Añade el servidor a Junie (IntelliJ IDEA, WebStorm, PyCharm… o el CLI de Junie), abre /mcp, elige croombit y pulsa Authorize.

~/.junie/mcp/mcp.json

{
  "mcpServers": {
    "croombit": {
      "url": "https://mcp.croombit.com/mcp"
    }
  }
}

Documentación oficial ↗

Zed

Settings → AI → MCP Servers → Add Remote Server, o añade esto a settings.json. Sin cabeceras, Zed te pide iniciar sesión.

settings.json

"context_servers": {
  "croombit": {
    "url": "https://mcp.croombit.com/mcp"
  }
}

Documentación oficial ↗

Windsurf · Devin Desktop

Añádelo dentro de mcpServers (ojo: la clave es serverUrl). Inicia sesión con OAuth la primera vez que Cascade lo llama.

~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "croombit": {
      "serverUrl": "https://mcp.croombit.com/mcp"
    }
  }
}

Documentación oficial ↗

KiroUn clic

Pulsa el botón o añádelo al fichero de abajo. Kiro se registra solo y abre el navegador para autorizar.

Instalar en un clic →

~/.kiro/settings/mcp.json

{
  "mcpServers": {
    "croombit": {
      "url": "https://mcp.croombit.com/mcp"
    }
  }
}

Documentación oficial ↗

Cline

MCP Servers → Remote Servers, o añádelo al fichero de ajustes. Pon type a streamableHttp (sin él, Cline usa el transporte SSE antiguo) y pulsa Authenticate.

cline_mcp_settings.json

{
  "mcpServers": {
    "croombit": {
      "type": "streamableHttp",
      "url": "https://mcp.croombit.com/mcp"
    }
  }
}

Documentación oficial ↗

Roo Code

Roo Code se conecta a servidores remotos, pero su documentación aún no cubre el inicio de sesión con OAuth; usa el puente mcp-remote, que lo hace por él.

.roo/mcp.json

{
  "mcpServers": {
    "croombit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.croombit.com/mcp"
      ]
    }
  }
}

Documentación oficial ↗

Amazon Q Developer

En el panel de chat: icono de herramientas → + → transporte http → pega la URL. Amazon Q abre el navegador para autorizar.

https://mcp.croombit.com/mcp

Documentación oficial ↗

Warp

Settings → Agents → MCP servers → Add → Streamable HTTP or SSE Server (URL), o pega esto. Warp abre el navegador para iniciar sesión.

{
  "croombit": {
    "url": "https://mcp.croombit.com/mcp"
  }
}

Documentación oficial ↗

Agentes de código y CLIs

Claude Code

Ejecútalo en tu proyecto. La primera llamada abre el navegador para autorizar.

Terminal

claude mcp add --transport http Croombit https://mcp.croombit.com/mcp

Documentación oficial ↗

OpenAI Codex CLI

Añade el servidor e inicia sesión con codex mcp login. O añádelo a config.toml: OAuth es el modo por defecto.

Terminal

codex mcp add croombit --url https://mcp.croombit.com/mcp
codex mcp login croombit

~/.codex/config.toml

[mcp_servers.croombit]
url = "https://mcp.croombit.com/mcp"

Documentación oficial ↗

Gemini CLI

Añade el servidor y ejecuta /mcp auth croombit dentro de Gemini CLI para iniciar sesión. En settings.json la clave es httpUrl.

Terminal

gemini mcp add --transport http croombit https://mcp.croombit.com/mcp
# then, inside Gemini CLI:
/mcp auth croombit

Documentación oficial ↗

GitHub Copilot CLI

Lo añade a ~/.copilot/mcp-config.json. Copilot CLI abre el navegador para iniciar sesión.

Terminal

copilot mcp add --transport http croombit https://mcp.croombit.com/mcp

Documentación oficial ↗

opencode

Añádelo como servidor remote e inicia sesión con opencode mcp auth croombit.

opencode.json

{
  "mcp": {
    "croombit": {
      "type": "remote",
      "url": "https://mcp.croombit.com/mcp"
    }
  }
}

Terminal

opencode mcp auth croombit

Documentación oficial ↗

GooseUn clic

Pulsa el botón, o ejecuta goose configure → Add Extension → Streamable HTTP. Goose abre el navegador para iniciar sesión.

Instalar en un clic →

~/.config/goose/config.yaml

extensions:
  croombit:
    name: Croombit
    type: streamable_http
    uri: https://mcp.croombit.com/mcp
    enabled: true
    timeout: 300

Documentación oficial ↗

Apps de chat

Claude.ai · Claude Desktop

Ajustes → Conectores → Añadir conector personalizado, y pega la URL. Claude te guía en el inicio de sesión.

https://mcp.croombit.com/mcp

Documentación oficial ↗

ChatGPT

En ChatGPT, añade un servidor MCP personalizado con esta URL y elige OAuth como método de autenticación.

https://mcp.croombit.com/mcp

Documentación oficial ↗

Cualquier otro cliente

A un cliente que admita servidores remotos con OAuth le basta con la URL de arriba. Uno que solo ejecute servidores locales (stdio) puede usar el puente de código abierto mcp-remote: corre en tu máquina, hace el inicio de sesión en el navegador y reenvía las llamadas.

{
  "mcpServers": {
    "croombit": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.croombit.com/mcp"
      ]
    }
  }
}

¿Aún no tienes cuenta? Créala gratis y conecta después: el plan Hobby incluye 1.000 eventos de consentimiento al mes y el servidor MCP.

5 minutos: un banner de cookies funcionando en tu localhost

Abre tu proyecto en el agente y pega un único prompt. Menciona Croombit en él, para que el agente use el conector correcto.

Con Croombit: crea un sitio llamado "Acme" en español e inglés y añade el dominio acme.com. Añade dos categorías de cookies, Analítica (categoría ANALYTICS) y Publicidad (categoría MARKETING), ambas desactivadas por defecto, con los textos del banner en español e inglés, y publícalas. Publica el banner de cookies. Crea una clave publicable de TEST para localhost:3000, añade la etiqueta script de Croombit al layout raíz de este proyecto y asegúrate de que nuestros scripts de analítica y de anuncios solo se ejecuten tras el consentimiento.

Lo que hace el agente

create_site y add_domain: el sitio con sus idiomas, y acme.com. Se puede usar en TEST al momento; la respuesta ya incluye el registro DNS que publicarás para pasar a LIVE.
create_cookie_category ×2, set_purpose_texts, publish_purpose: los dos interruptores que ve el visitante, con el texto exacto que se citará en cada registro de consentimiento.
publish_banner: fija la versión del banner a la que apuntará cada decisión.
create_api_key: una clave pk_ de TEST cuya lista de orígenes permitidos es localhost:3000. La clave se muestra una sola vez; el agente la escribe directamente en tu código.
Edita tu layout: un <script src="https://croombit.com/cmp.js" data-tc-api-key="pk_test_…">, y marca las etiquetas existentes con type="text/plain" data-tc-consent="…" para que esperen a la elección del visitante. Las etiquetas de Google reciben además los valores por defecto de Consent Mode v2.

Después, comprueba qué se guarda de verdad. En una URL pública de staging, pide un escaneo (request_cookie_scan: nuestro rastreador acepta el banner y registra cada cookie). En localhost, un agente que pueda manejar un navegador abre la página, acepta el banner y envía lo que ve con import_cookies. Las dos vías llegan al inventario ya clasificadas.

10 minutos: el resto de consentimientos

Las cookies son solo un tipo de consentimiento. La misma conversación configura los que registra tu propio producto, con prueba.

Con Croombit: añade declaraciones de consentimiento para nuestra newsletter (opt-in de email marketing) y para la aceptación de los términos del servicio, y publícalas. Crea una clave secreta de TEST, guárdala en .env como CROOMBIT_SECRET_KEY y registra las elecciones de cada usuario desde nuestro handler de registro con @croombit/sdk. Después crea un webhook a https://staging.acme.com/webhooks/croombit para consent.withdrawn y escribe el receptor verificando la firma.

Declaraciones de consentimiento con texto versionado: el registro guarda la versión exacta que vio cada persona.
Registro en servidor con una clave sk_test_: cada decisión va a la bóveda de solo-anexado y vuelve con un recibo firmado con Ed25519.
Webhooks con verificación de firma, para que tu proveedor de email deje de escribir a alguien en cuanto retira su consentimiento.
Si quieres, un centro de preferencias (canales y temas) y políticas de caducidad, de la misma forma y en la misma conversación.

Pasar a LIVE: dos pasos en la consola

El agente trabaja en TEST. Llevar a los visitantes reales queda en manos de una persona, a propósito:

Verifica tu dominio: publica el registro DNS TXT (o el fichero /.well-known) que ya te dio el agente y pulsa Verificar. Las claves LIVE solo aceptan dominios verificados.
Crea la clave `pk_` LIVE y cámbiala por la de TEST. Las claves LIVE solo se crean en la consola, nunca a través del servidor MCP.

Qué puede tocar el agente y qué no

Cada conexión queda ligada a una organización y a los permisos que marques en la pantalla de autorización. Todo lo demás devuelve 403 en el servidor, no solo en la interfaz.
Publicar el banner necesita su propio permiso (banner:publish): si no lo marcas, el agente solo puede preparar borradores.
Claves de API: solo TEST. Ni claves LIVE, ni secretos existentes, ni secretos de identidad.
La bóveda es de solo lectura, y ningún permiso exporta todos los datos de una persona ni toca miembros del equipo, facturación o SSO.
Cada cambio que hace queda en el registro de auditoría encadenado por hash de la organización, como el de cualquier compañero.

Todos los permisos, y lo que alcanza cada uno, están en la documentación del MCP.

Preguntas

¿El servidor MCP es gratis?

Sí. Está incluido en todos los planes, también en el plan gratuito Hobby (1.000 eventos de consentimiento al mes). El tráfico de TEST nunca cuenta para la cuota.

¿Con qué clientes de IA funciona?

Con cualquier cliente MCP que admita servidores remotos (Streamable HTTP) con OAuth. En esta página está la configuración paso a paso para Cursor, VS Code, Visual Studio, JetBrains (Junie), Zed, Windsurf, Kiro, Cline, Roo Code, Amazon Q, Warp, Claude Code, Codex CLI, Gemini CLI, Copilot CLI, opencode, Goose, Claude.ai y ChatGPT; un cliente que solo ejecute servidores locales puede usar el puente mcp-remote.

¿Tengo que pegar una clave de API en el agente?

No. La conexión usa OAuth 2.1 con PKCE: la apruebas una vez en el navegador, para una organización y los permisos que elijas, y puedes revocarla cuando quieras.

¿Funciona en localhost?

Sí. Una clave publicable de TEST acepta localhost:<puerto> como origen permitido, así que el banner funciona en tu servidor de desarrollo antes de tener dominio. Nuestro rastreador en la nube solo llega a URLs públicas; para localhost, el agente puede importar las cookies que observe en un navegador.

¿Puede el agente publicar algo en LIVE por error?

No puede crear claves LIVE ni verificar dominios por ti, así que los visitantes reales solo ven Croombit cuando das los dos pasos en la consola. Publicar una versión del banner requiere el permiso aparte banner:publish.

Uso WordPress o Shopify, ¿esto es para mí?

Puedes usar igualmente el agente para configurar categorías, banner y textos. Para la etiqueta, los plugins de WordPress y Shopify lo hacen sin código.

Pídele a tu agente un banner de cookies.

Conecta el servidor, pega el prompt y revisa el resultado en TEST antes de que llegue a ningún visitante real.

Conéctalo →Crear una cuenta gratis