[Beta]{class="badge informative"}
Trabajo con clientes de MCP (Beta) rtcdp-mcp
Puede utilizar la integración de MCP de Adobe Real-Time CDP para consultar audiencias, destinos y estado de activación mediante mensajes en lenguaje sencillo, sin escribir llamadas de API ni navegar por las pantallas de productos. Esta integración sirve tanto a los clientes de Adobe Real-Time CDP como a los de Adobe Real-Time CDP B2B edition, y ofrece una forma conversacional de inspeccionar los datos y flujos de trabajo de Real-Time CDP admitidos de clientes compatibles con MCP. Lea esta guía para conocer cómo funciona la integración, qué puede hacer con ella y cómo empezar.
Beta, seguridad y avisos legales mcp-notices
Aviso sobre la documentación de Beta: Esta documentación cubre una función de Beta y no constituye documentación final. El contenido que se describe aquí está relacionado con una versión de Beta y está sujeto a cambios antes de su publicación general. Adobe no realiza ninguna declaración sobre la integridad o precisión de esta documentación.
Al usar Adobe Real-Time CDP MCP Server (Beta) (“Beta”), Usted reconoce por la presente que Beta se proporciona “tal cual” sin garantía de ningún tipo. Adobe no tiene obligación de mantener, corregir, actualizar, cambiar, modificar o apoyar de otro modo Beta. Se recomienda tener precaución y no confiar en modo alguno en el correcto funcionamiento o rendimiento de dichos Beta y/o materiales de acompañamiento. Beta se considera información confidencial de Adobe. Cualquier “comentario” (información sobre Beta, incluidos, entre otros, problemas o defectos que encuentre al utilizar Beta, sugerencias, mejoras y recomendaciones) proporcionado por usted a Adobe se asigna a Adobe, incluidos todos los derechos, el título y el interés en y para dichos comentarios.
¿Qué es el protocolo de contexto del modelo? mcp-overview
Los equipos de marketing, datos y experiencia del cliente dependen cada vez más de las aplicaciones basadas en chat y las herramientas para desarrolladores, como Anthropic Claude, OpenAI ChatGPT, Cursor y Microsoft Copilot Studio, para optimizar su trabajo diario. Estas aplicaciones admiten el Protocolo de contexto de modelo (MCP), un estándar abierto que permite a las aplicaciones exponer las herramientas back-end a modelos de lenguaje de gran tamaño (LLM) de manera uniforme.
Real-Time CDP ahora proporciona un servidor MCP que muestra las operaciones de audiencia, destino y activación directamente dentro de cualquier aplicación compatible con MCP. Con la integración de Real-Time CDP MCP, diferentes personas pueden colaborar en torno a los mismos datos de segmentación y activación, sin necesidad de escribir consultas contra las API de REST de Adobe Experience Platform ni navegar por varias pantallas de interfaz de usuario. Los clientes pueden describir su intención de manera conversacional y dejar que el LLM invoque las herramientas de MCP apropiadas.
Funcionalidades clave mcp-capabilities
El servidor MCP de Real-Time CDP es una superficie de supervisión y evaluación de solo lectura. Expone las API de recuperación en audiencias, destinos, fuentes, identidad y resolución de perfiles como respuestas en lenguaje sencillo dentro del asistente de IA, sin necesidad de escribir consultas ni navegar por las pantallas de producto. No se pueden crear, modificar ni eliminar datos a través del servidor MCP.
La versión de Beta incluye las 18 herramientas siguientes:
search_audiencespreview_audience_membershipinspect_audience_evaluation_jobsinspect_audience_export_jobssearch_destination_connectorssearch_destination_accountssearch_destination_input_connectionssearch_destination_output_connectionssearch_destination_flowsinspect_flow_runssearch_source_connectorssearch_source_accountssearch_source_input_connectionssearch_source_output_connectionssearch_source_flowssearch_identity_namespacessearch_merge_policiessearch_organizationsCasos de uso mcp-use-cases
El servidor MCP de Real-Time CDP está diseñado para supervisión y evaluación. Dado que el servidor funciona con identificadores en lugar de con nombres, un flujo de trabajo típico comienza con una lista: pídale a Claude que le muestre lo que está disponible, elija el elemento que desee y, a continuación, haga preguntas de seguimiento utilizando el identificador que devuelve.
prod”.abc123”.homeAddress.country = 'US'.”xyz789”.xyz789 y resumir los errores.”src456: ¿qué está ingiriendo y dónde aterriza?”src456 y los errores de indicador”.Acceso y activación mcp-access
Para solicitar acceso:
- Póngase en contacto con su representante de cuentas de Adobe (Customer Success Manager, Technical Account Manager o Account Executive) y exprese su interés en el programa Beta de MCP de Real-Time CDP.
- El representante de Adobe se coordinará con el equipo del producto para evaluar la idoneidad y habilitar el ID de la organización.
- Una vez activado, su representante de Adobe confirmará el acceso y proporcionará cualquier material de incorporación adicional.
Requisitos previos mcp-prerequisites
Antes de conectar el servidor MCP de Real-Time CDP a su cliente MCP, asegúrese de lo siguiente:
- Tiene una licencia de Real-Time CDP activa.
- Su representante de Adobe ha habilitado a su organización de Adobe para el programa Beta (consulte Acceso y habilitación).
- Tiene acceso a un cliente MCP admitido como Claude, ChatGPT, Claude Code, Codex, Cursor o VS Code.
- Tiene el ID de organización y el nombre de la zona protegida que desea consultar.
- Tiene los permisos necesarios en Adobe Experience Platform para ver audiencias, destinos y entidades de servicios de flujo.
Conexión del servidor MCP de Real-Time CDP mcp-connect
El punto final del servidor MCP de Real-Time CDP es:
https://rtcdp-mcp.adobe.io/mcp
El servidor usa un transporte HTTP remoto (HTTP transmisible) con un flujo de inicio de sesión de Adobe basado en explorador. En cada cliente, el patrón de configuración es el mismo:
- Agregar la dirección URL del servidor:
https://rtcdp-mcp.adobe.io/mcp - Guarde o habilite la conexión.
- Complete el inicio de sesión en Adobe basado en explorador la primera vez que el cliente invoque una herramienta.
- Proporcione
imsOrgIdysandboxNameal principio de cada sesión.
Configuración general de JSON mcp-connect-json
Para los clientes que aceptan una configuración de servidor MCP basada en JSON, como Claude Desktop (claude_desktop_config.json), VS Code o cualquier cliente que lea un archivo mcp.json, utilice uno de los siguientes formatos en función de si el cliente admite HTTP remoto nativo o requiere un puente local:
A través del puente mcp-remote (Claude Desktop y otros clientes que necesitan un puente local)
{
"mcpServers": {
"rtcdp": {
"command": "npx",
"args": [
"mcp-remote",
"https://rtcdp-mcp.adobe.io/mcp"
]
}
}
}
HTTP remoto nativo (clientes que lo admiten directamente)
{
"mcpServers": {
"rtcdp": {
"url": "https://rtcdp-mcp.adobe.io/mcp",
"transport": "http"
}
}
}
Instalar en clientes basados en IU mcp-connect-ui
Claude
Para claude.ai y Claude Desktop, agregue el servidor MCP de Real-Time CDP como conector personalizado mediante la dirección URL del servidor https://rtcdp-mcp.adobe.io/mcp.
- Planes individuales: en Claude, vaya a Personalizar → Connectors, seleccione Agregar conector e introduzca la dirección URL del servidor.
- Planes de equipo y empresa — Un propietario o propietario principal del área de trabajo agrega el conector en Configuración de la organización → Conectores. Una vez agregado, cada usuario lo habilita en su propia configuración de Claude.
Una vez agregado el conector, habilítelo en una conversación y complete el inicio de sesión del explorador Adobe la primera vez que lo use. Claude detecta automáticamente el servidor de autorización de Adobe; no se requiere ID de cliente ni secreto de cliente.
ChatGPT
En ChatGPT, agregue el servidor MCP de Real-Time CDP como conector personalizado:
- Vaya a Configuración → Conectores (o Configuración → Aplicaciones y Conectores, según su plan).
- Seleccione Agregar conector e introduzca
https://rtcdp-mcp.adobe.io/mcpcomo dirección URL del servidor. - Guarde el conector. Según el plan de ChatGPT, este paso puede requerir modo de desarrollador o la aprobación del administrador del área de trabajo.
- Una vez habilitado el conector, realice la autenticación mediante el inicio de sesión en el explorador Adobe cuando se le solicite la primera vez que utilice.
Cursor
En Cursor, agregue el servidor MCP de Real-Time CDP como servidor MCP remoto:
- Abra Configuración → MCP.
- Seleccione Agregar nuevo servidor e introduzca
https://rtcdp-mcp.adobe.io/mcpcomo dirección URL del servidor. - Seleccione connect para almacenar en déclencheur el inicio de sesión de Adobe basado en explorador y autenticarse.
Una vez conectadas, las herramientas de Real-Time CDP están disponibles en los modos Compositor del cursor y Agente.
Otros clientes basados en IU
Para clientes como código VS u otras aplicaciones de escritorio y web con compatibilidad con MCP remoto, agregue el servidor MCP de Real-Time CDP como un servidor HTTP remoto usando https://rtcdp-mcp.adobe.io/mcp. Si el cliente admite encabezados opcionales o tokens de portador, déjelos vacíos: la autenticación se administra mediante el flujo de inicio de sesión de Adobe basado en el explorador la primera vez que se utiliza.
Instalar en clientes técnicos mcp-connect-technical
Código Claude
Añada el servidor desde el terminal:
claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp
A continuación, inicie Claude Code y ejecute:
/mcp
Seleccione el servidor rtcdp y complete el flujo de inicio de sesión de Adobe en su explorador. Si ya agregó el servidor en claude.ai, puede aparecer automáticamente en el código de la cláusula cuando ambos hayan iniciado sesión en la misma cuenta.
Códice
Añada el servidor desde el terminal:
codex mcp add rtcdp --url https://rtcdp-mcp.adobe.io/mcp
Autentique el servidor:
codex mcp login rtcdp
Compruebe la configuración:
codex mcp list
También puede agregar el servidor directamente a ~/.codex/config.toml:
[mcp_servers.rtcdp]
url = "https://rtcdp-mcp.adobe.io/mcp"
Parámetros de solicitud requeridos mcp-connect-params
Cada llamada a la herramienta requiere dos parámetros que amplían el ámbito de la solicitud a su inquilino de Adobe Experience Platform:
imsOrgId: su ID de organización, asignado al encabezadox-gw-ims-org-iden las llamadas a la API de Experience Platform descendentes.sandboxName: el nombre de la zona protegida de Experience Platform, asignado al encabezadox-sandbox-name.
Proporciónelos al principio de cada sesión. Por ejemplo:
“Use la organización
1234ABCD@AdobeOrgy la zona protegidaprodpara esta sesión”.
Si no conoce su identificador de organización, pídale al asistente de IA que llame a search_organizations, ya que devolverá todas las organizaciones a las que puedan acceder sus credenciales de Adobe.
Limitaciones conocidas (Beta) mcp-limitations
Las siguientes limitaciones se aplican a la versión actual de Beta del servidor MCP Adobe Real-Time CDP:
Preview Audience Membership requiere una expresión PQL o SDD válida como entrada; el servidor MCP no crea la consulta automáticamente.continuationToken llamadas.Inspect Activation Runs admite el filtrado por estado y marca de tiempo de finalización (epoch ms UTC), pero no por tipo de error o plataforma de destino directamente.flowId (obtenido de List Configured Destinations) para que el ámbito se ejecute en un destino específico.search_organizations) requiere imsOrgId y sandboxName como parámetros explícitos. Si no se proporcionan, las llamadas a la herramienta fallarán.<YOUR_ORG_ID> y la zona protegida <SANDBOX_NAME> para esta sesión”. Si no conoce su identificador de organización, llame primero a search_organizations y se devolverán las organizaciones a las que sus credenciales pueden acceder.