Un servidor MCP de solo lectura
Este sitio expone list_labs, get_lab, search_blog, inspect_datalayer y example_report en POST /api/mcp. inspect_datalayer lee la sesión de este navegador cuando el patio de juegos envía el id de sesión. La pregunta no se registra.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Quieres que este sitio responda tools/list desde un anfitrión que ya usas. La ruta es pública, de solo lectura y con límite.
Cómo usarlo
- Pulsa Siguiente para ver tools/list y una llamada.
- Copia la configuración en Cursor o Claude Desktop.
- Reinicia el anfitrión y aprueba la herramienta.
- Abre Qué es MCP para los pasos de construcción.
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de sitio listo para MCP muestra la ruta de solo lectura POST /api/mcp y la configuración del cliente. Después de Aceptar encola mcp_server_called solo con el nombre de la herramienta. La pregunta no se registra. El laboratorio no llama a Adobe.
Mostrar el ejemplo
La vista MCP compartida pinta la petición, la respuesta, la línea de tiempo y la respuesta del agente. El recorrido está etiquetado como ejemplo.
Quedarse en solo lectura
La navegación y las herramientas se quedan en este origen. No hay envío de formulario ni herramienta de escritura.
Encolar solo el nombre
Después de Aceptar, demonstrateEvent envía el evento del laboratorio. Cuando corrió una herramienta, el único parámetro es tool. El texto de la pregunta no es un parámetro.
Saltar el evento antes de Aceptar
El botón Siguiente igual mueve el ejemplo cuando el consentimiento está apagado. demonstrateEvent vuelve sin hacer push.
Del código
Después de Aceptar, el paso encola su evento. El nombre de la herramienta es el único campo extra.
function go(next: number) {
const target = steps[next]
if (!target) return
setIndex(next)
const eventName = target.event
if (granted && eventName) {
const tool = target.tool
demonstrateEvent(eventName, tool ? { tool } : {})Con el consentimiento apagado el ejemplo igual avanza. El evento se salta.
{granted ? null : (
<p className="mt-3 rounded-lg border px-3 py-2 text-sm">{tr(locale, "Accept measurement to record the step. The example still moves. Nothing is pushed before Accept.", "Acepta la medición para registrar el paso. El ejemplo igual avanza. No se envía nada antes de Aceptar.")}</p>Google y Adobe
Google encola mcp_server_called después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, este laboratorio encola mcp_server_called. Cuando corrió una herramienta, el parámetro es tool y nada más. El texto de la pregunta y de la respuesta no son parámetros. Este sitio no llama a gtag('set') ni a Adobe.
Forma simplificada del objeto encolado después de Aceptar. Registra cualquier parámetro nuevo como dimensión personalizada con alcance de evento. Este sitio no llama a gtag('set').
dataLayer.push({
event: "mcp_server_called",
tool: "list_labs",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar122, prop122 y event122 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar122 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
mcpTool: "list_labs",
},
},
})Hit de ejemplo. eVar122 tiene alcance de hit en este ejemplo. prop122 muere en el mismo hit.
s.eVar122 = "list_labs"
s.prop122 = "list_labs"
s.events = "event122"
s.linkTrackVars = "eVar122,prop122,events"
s.linkTrackEvents = "event122"
s.tl(true, "o", "mcp_server_called")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Paso
GA4. Evento mcp_server_called después de Aceptar.
Adobe. event122 de ejemplo. Este sitio no llama a Adobe.
Alcance. Evento. Registra que el paso se mostró.
Nombre de herramienta
GA4. Parámetro tool. Los argumentos no se envían.
Adobe. eVar122 de ejemplo, expira en el hit. Este sitio no llama a Adobe.
Alcance. Evento. Una propiedad de usuario conservaría la última herramienta.
Texto de la pregunta
GA4. No se envía.
Adobe. No pongas la pregunta en una prop. No se envía.
Alcance. Se queda en la página.
Consentimiento
GA4. No es un parámetro. El push se salta hasta Aceptar.
Adobe. Ejemplo: sáltate el hit mientras el consentimiento está apagado.
Alcance. Una compuerta del hit.
Sesión de ejemplo
Acepta la medición para registrar el paso. El ejemplo igual avanza. No se envía nada antes de Aceptar.
Conectar
Un anfitrión abre un cliente hacia POST /api/mcp. La ruta es de solo lectura y tiene límite.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Respuesta
{ "result": { "tools": ["list_labs", "get_lab", "search_blog", "inspect_datalayer", "example_report"] } }Configuración del cliente
Pega esto en .cursor/mcp.json o en claude_desktop_config.json. VS Code usa .vscode/mcp.json con un objeto servers y la misma url. Luego reinicia el anfitrión y aprueba la herramienta.
{
"mcpServers": {
"black-box": { "url": "https://www.blackboxpersonalization.com/api/mcp" }
}
}Configuración completa y pasos para construir
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…