Protocolo
¿Qué es MCP?
MCP conecta una app anfitriona con servidores que ofrecen herramientas, recursos y prompts. No es el modelo y no es el agente.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Quieres saber qué es MCP antes de conectar un servidor. Es un protocolo entre un anfitrión y un servidor de herramientas, no un modelo.
Cómo usarlo
- Abre una sección. Cada una sigue cerrada hasta que la pulses.
- Lee el anfitrión, el cliente y el servidor.
- Copia una configuración solo cuando confíes en el servidor.
- Abre un laboratorio de la lista para probar un recorrido.
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.
La página Qué es MCP explica el anfitrión, el cliente y el servidor, y cita la revisión 2026-07-28 del protocolo. Después de Aceptar un paso puede encolar mcp_overview_view. La página 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_overview_view después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, este laboratorio encola mcp_overview_view. 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_overview_view",
tool: "tools_list",
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar119, prop119 y event119 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 eVar119 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: "tools_list",
},
},
})Hit de ejemplo. eVar119 tiene alcance de hit en este ejemplo. prop119 muere en el mismo hit.
s.eVar119 = "tools_list"
s.prop119 = "tools_list"
s.events = "event119"
s.linkTrackVars = "eVar119,prop119,events"
s.linkTrackEvents = "event119"
s.tl(true, "o", "mcp_overview_view")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_overview_view después de Aceptar.
Adobe. event119 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. eVar119 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.
Comprobado con la especificación del Model Context Protocol, revisión actual 2026-07-28 (modelcontextprotocol.io). Las revisiones con apretón de manos de 2025-11-25 y anteriores, incluida 2025-06-18, se nombran donde las apps de escritorio aún las usan.
Ideas equivocadas
MCP no es un modelo. No responde preguntas. La app anfitriona ya tiene un modelo. MCP solo lleva contexto y llamadas de herramientas a esa app.
MCP no sustituye una API HTTP. El servidor puede llamar a una API dentro de una herramienta. Los clientes siguen hablando JSON-RPC 2.0, no tus rutas REST.
MCP no es un agente. El anfitrión decide cuándo llamar a una herramienta. Un servidor que solo lista herramientas no planifica ni navega solo.
MCP no es seguro por sí mismo. La especificación dice que usar una herramienta es ejecutar código arbitrario. El consentimiento, las listas de permiso y el menor privilegio son trabajo del anfitrión. El protocolo no los impone.
MCP no es solo para Claude. Es un protocolo abierto. Cursor, VS Code y otros anfitriones pueden conectar al mismo servidor.
Anfitrión, cliente, servidor
El anfitrión es la app que usas (Cursor, Claude Desktop, VS Code). Crea un cliente por servidor. Ese cliente habla con un solo servidor. Los servidores no ven todo el chat ni se ven entre sí.
Los mensajes son JSON-RPC 2.0. La revisión actual, 2026-07-28, no guarda sesión: cada petición lleva la versión del protocolo y las capacidades del cliente en _meta. Un cliente puede llamar primero a server/discover. Llamarlo es opcional. El servidor igual debe implementarlo.
Las revisiones de 2025-11-25 y anteriores usan un apretón de manos. El cliente envía initialize, el servidor responde con sus capacidades y el cliente envía la notificación notifications/initialized. El trabajo va después. Cerrar es cerrar el transporte. No hay un RPC de shutdown. En stdio el cliente cierra la entrada, luego SIGTERM y luego SIGKILL. En HTTP cierra la conexión.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": { "roots": { "listChanged": true }, "sampling": {}, "elicitation": {} },
"clientInfo": { "name": "example-host", "version": "1.0.0" }
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-06-18",
"capabilities": { "tools": {} },
"serverInfo": { "name": "black-box", "version": "1.0.0" }
}
}{
"jsonrpc": "2.0",
"method": "notifications/initialized"
}Transportes
stdio es para un servidor en tu máquina. El anfitrión arranca un proceso y habla por stdin y stdout. Los registros van a stderr, no a stdout, o rompen el flujo.
Streamable HTTP es el transporte remoto de la especificación actual. El cliente hace POST de JSON-RPC. El servidor puede responder con un JSON o con un flujo de Server-Sent Events. Envía la cabecera MCP-Protocol-Version en cada petición. El transporte viejo HTTP+SSE es legado. Los servidores nuevos no deben exigirlo.
Herramientas, recursos, prompts
Las herramientas las controla el modelo. El modelo las elige. tools/list devuelve el nombre, la descripción y el inputSchema (JSON Schema) de cada una. tools/call ejecuta una. El resultado tiene bloques content y puede incluir structuredContent. isError true significa que la llamada falló sin un error de protocolo.
Los recursos los controla la aplicación. El anfitrión decide qué leer. resources/list y resources/templates/list los descubren. resources/read toma un URI. Para mirar cambios, abre subscriptions/listen. El servidor envía entonces notifications/resources/updated.
Los prompts los controla la persona. Alguien elige la plantilla. prompts/list los descubre. prompts/get rellena los argumentos. El modelo no dispara un prompt por su cuenta.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"_meta": { "io.modelcontextprotocol/protocolVersion": "2026-07-28" }
}{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": { "name": "list_labs", "arguments": {} }
}Lo que el cliente ofrece de vuelta
El muestreo deja que el servidor pida al modelo del anfitrión que complete un mensaje (sampling/createMessage). La persona debe aprobarlo. El servidor no ve el prompt oculto. Las raíces nombran los archivos o URI que el servidor puede tocar. La elicitación (elicitation/create) hace una pregunta a la persona a mitad de la llamada. En la revisión 2026-07-28 vuelven como una respuesta de varias vueltas, no como una petición sorpresa en un socket ocioso.
notifications/tools/list_changed avisa al cliente de que cambió la lista de herramientas. Las notificaciones de progreso reinician un tiempo de espera solo si el cliente lo permite. Un tiempo máximo sigue vigente. La cancelación es una notificación para un id de petición. Quien la envía deja de esperar.
Usar un servidor en Cursor, Claude Desktop y VS Code
Cursor lee .cursor/mcp.json en el proyecto o en la configuración del usuario. Claude Desktop lee claude_desktop_config.json. VS Code lee .vscode/mcp.json. Un campo url es un servidor remoto Streamable HTTP. Un campo command arranca un proceso stdio local. Reinicia el anfitrión después de guardar. Aprueba cada llamada en la interfaz del anfitrión salvo que ya hayas permitido esa herramienta. No apruebes una herramienta cuya descripción no esperabas.
{
"mcpServers": {
"black-box": { "url": "https://www.blackboxpersonalization.com/api/mcp" }
}
}{
"mcpServers": {
"black-box": { "url": "https://www.blackboxpersonalization.com/api/mcp" }
}
}{
"servers": {
"black-box": { "url": "https://www.blackboxpersonalization.com/api/mcp" }
}
}Depura con el inspector oficial: npx @modelcontextprotocol/inspector. Apúntalo a la misma url o al mismo command. Muestra el apretón de manos o la versión por petición, tools/list y cada tools/call. Lee stderr en un servidor stdio. Lee el registro MCP del anfitrión en un servidor remoto. Si initialize falla en un cliente viejo, los valores de protocolVersion no se solapan.
Construir un servidor
TypeScript, SDK oficial. Instala @modelcontextprotocol/sdk y zod. Define cada herramienta con una entrada zod. Para un servidor local, conecta con StdioServerTransport. En este sitio, el ejemplo trabajado es la ruta de solo lectura POST /api/mcp: tools/list y tools/call para list_labs, get_lab, search_blog, inspect_datalayer y example_report. Pruébala con el inspector. En Vercel, el paquete mcp-handler adapta las mismas herramientas a Streamable HTTP.
npm install @modelcontextprotocol/sdk zod npx @modelcontextprotocol/inspector
Equivalente en Python: pip install fastmcp, decora una función con @mcp.tool y ejecuta mcp.run(transport="stdio"). La lista de herramientas y el esquema de entrada salen de la firma de la función. Valen las mismas reglas de lista de permiso. No añadas una herramienta de escritura.
Autenticación y seguridad
Un servidor remoto debe usar OAuth 2.1 cuando los datos no son públicos. /api/mcp de este sitio es catálogo público, así que no tiene inicio de sesión. Permite herramientas de lectura solo de este sitio. Este proceso permite ocho llamadas de una IP en diez minutos. La novena devuelve 429. Un proceso nuevo empieza el conteo de nuevo. Una regla de firewall es el tope durable.
Trata las descripciones y los resultados de las herramientas como no confiables. Una descripción envenenada puede dirigir al modelo. Un resultado puede llevar una instrucción oculta. Confirma en el anfitrión cualquier cosa destructiva antes de que corra. Nunca pongas un secreto, un token o la pregunta del visitante en la salida de una herramienta.
MCP o una API simple
Usa una API simple cuando un programa tuyo llama a un endpoint tuyo. Usa MCP cuando varios anfitriones (un IDE, un chat de escritorio, un agente) deben descubrir las mismas herramientas sin un SDK propio. Function calling es cómo un modelo pide una herramienta. MCP es cómo esa petición llega a un servidor que el anfitrión no tenía escrito a mano.
Glosario
Anfitrión: la app. Cliente: una conexión dentro del anfitrión. Servidor: el proceso que ofrece herramientas, recursos y prompts. Herramienta: una función que elige el modelo. Recurso: datos que la app lee por URI. Prompt: una plantilla que invoca una persona. inputSchema: JSON Schema de los argumentos. isError: la herramienta corrió y falló. stdio: tuberías locales. Streamable HTTP: POST remoto, SSE opcional.
Preguntas frecuentes
¿Esta página abre un navegador o llama a un modelo? No. Los laboratorios reproducen ejemplos etiquetados, salvo el patio, que hace POST a la ruta de solo lectura /api/mcp.
¿Por qué algunos clientes aún envían initialize? Hablan 2025-11-25 o anterior. Un servidor 2026-07-28 puede responder ese apretón de manos por compatibilidad, y sigue marcando las peticiones nuevas con la versión del protocolo.
¿Dónde se guarda el texto de la pregunta? No se guarda. Los eventos de analítica llevan el nombre de la herramienta, no las palabras que escribiste.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…