[Beta]{class="badge informative"}
Arbeiten mit MCP-Clients (Beta) rtcdp-mcp
Sie können die Adobe Real-Time CDP-MCP-Integration verwenden, um Zielgruppen, Ziele und den Aktivierungsstatus mit einfachen Eingabeaufforderungen abzufragen - ohne API-Aufrufe zu schreiben oder durch Produktbildschirme zu navigieren. Diese Integration dient sowohl Kunden von Adobe Real-Time CDP als auch von Adobe Real-Time CDP B2B edition und bietet eine Möglichkeit, unterstützte Real-Time CDP-Daten und -Workflows von MCP-kompatiblen Clients aus zu untersuchen. Lesen Sie dieses Handbuch, um zu erfahren, wie die Integration funktioniert, was Sie damit tun können und wie Sie beginnen.
Beta, Sicherheit und rechtliche Hinweise mcp-notices
Hinweis zur Beta-Dokumentation: Diese Dokumentation behandelt eine Beta-Funktion und stellt keine endgültige Dokumentation dar. Der hier beschriebene Inhalt bezieht sich auf eine Beta-Version und kann sich vor der allgemeinen Verfügbarkeit ändern. Adobe übernimmt keine Gewähr für die Vollständigkeit oder Richtigkeit dieser Dokumentation.
Durch die Verwendung des Adobe Real-Time CDP MCP Servers (Beta) (“Beta„) erkennen Sie hiermit an, dass der Beta „wie besehen“ und ohne Gewährleistung jeglicher Art bereitgestellt wird. Adobe ist nicht verpflichtet, die Beta-Version zu pflegen, zu korrigieren, zu aktualisieren, zu ändern oder anderweitig zu unterstützen. Wir empfehlen Ihnen, Vorsicht walten zu lassen und sich nicht auf die ordnungsgemäße Funktionsweise oder Leistung solcher Beta-Versionen und/oder Begleitmaterialien zu verlassen. Die Beta-Version wird als vertrauliche Information von Adobe betrachtet. Jedes „Feedback“ (Informationen zur Beta-Version, einschließlich, aber nicht beschränkt auf Probleme oder Mängel, auf die Sie bei der Verwendung der Beta-Version stoßen, Vorschläge, Verbesserungen und Empfehlungen), das Sie Adobe übermitteln, wird hiermit an Adobe übertragen, einschließlich aller Rechte, Titel und Interessen an diesem Feedback.
Was ist das Model Context Protocol? mcp-overview
Marketing-, Daten- und Kundenerlebnis-Teams verlassen sich zunehmend auf Chat-basierte Anwendungen und Entwickler-Tools - wie Anthropic Claude, OpenAI ChatGPT, Cursor und Microsoft Copilot Studio -, um ihre tägliche Arbeit zu optimieren. Diese Anwendungen unterstützen das Model Context Protocol (MCP), einen offenen Standard, der es Anwendungen ermöglicht, Backend-Tools auf einheitliche Weise für Large Language Models (LLMs) verfügbar zu machen.
Real-Time CDP bietet jetzt einen MCP-Server, der Zielgruppen-, Ziel- und Aktivierungsvorgänge direkt in jeder MCP-kompatiblen Anwendung aufzeigt. Mit der Real-Time CDP MCP-Integration können verschiedene Benutzertypen um dieselben Segmentierungs- und Aktivierungsdaten zusammenarbeiten, ohne Abfragen an den Adobe Experience Platform REST-APIs zu schreiben oder durch mehrere Bildschirme der Benutzeroberfläche zu navigieren. Kundinnen und Kunden können ihre Absichten in Dialogform beschreiben und das LLM die entsprechenden MCP-Tools aufrufen lassen.
Wichtigste Funktionen mcp-capabilities
Der Real-Time CDP MCP-Server ist schreibgeschützte Überwachungs und Triage-Oberfläche. Es stellt APIs für das Abrufen von Zielgruppen, Zielen, Quellen, Identität und Profilauflösung als Klarsprachenantworten innerhalb Ihres KI-Assistenten bereit - ohne Abfragen zu schreiben oder durch Produktbildschirme zu navigieren. Es können keine Daten über den MCP-Server erstellt, geändert oder gelöscht werden.
Die Beta-Version umfasst die folgenden 18 Tools:
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_organizationsAnwendungsszenarien mcp-use-cases
Der Real-Time CDP MCP-Server wurde für Überwachung und Triage entwickelt. Da der Server mit IDs statt mit Namen arbeitet, beginnt ein typischer Workflow mit einer Liste - Bitten Sie Claude, Ihnen zu zeigen, was verfügbar ist, wählen Sie das gewünschte Element aus und stellen Sie dann anhand der zurückgegebenen ID Folgefragen.
prod Sandbox auf.“abc123.“homeAddress.country = 'US'.“xyz789.“xyz789 und Zusammenfassung etwaiger Fehler“src456 - was wird aufgenommen und wo wird es landen?“src456 und Markierungsfehler anzeigen“Zugriff und Aktivierung mcp-access
So fordern Sie Zugriff an:
- Wenden Sie sich an Ihren Adobe-Kundenbetreuer (Customer Success Manager, Technical Account Manager oder Account Executive) und bekunden Sie Ihr Interesse am Real-Time CDP MCP Beta-Programm.
- Der Adobe-Support koordiniert sich mit dem Produkt-Team, um die Eignung zu bewerten und Ihre Organisations-ID zu aktivieren.
- Nach der Aktivierung bestätigt der Adobe-Support den Zugriff und stellt zusätzliches Onboarding-Material zur Verfügung.
Voraussetzungen mcp-prerequisites
Stellen Sie vor dem Verbinden des Real-Time CDP-MCP-Servers mit dem MCP-Client Folgendes sicher:
- Sie besitzen eine aktive Real-Time CDP-Lizenz.
- Ihre Adobe-Organisation wurde von Ihrem Adobe-Support-Mitarbeiter für das Beta-Programm aktiviert (siehe Zugriff und Aktivierung).
- Sie haben Zugriff auf einen unterstützten MCP-Client wie Claude, ChatGPT, Claude Code, Codex, Cursor oder VS Code.
- Sie haben Ihre Organisations-ID und den Namen der Sandbox, die Sie abfragen möchten.
- Sie verfügen in Adobe Experience Platform über die erforderlichen Berechtigungen zum Anzeigen von Zielgruppen, Zielen und Flow Service-Entitäten.
Real-Time CDP MCP-Server verbinden mcp-connect
Der Real-Time CDP MCP-Server-Endpunkt ist:
https://rtcdp-mcp.adobe.io/mcp
Der Server verwendet einen Remote-HTTP (Streamable HTTP-Transport) mit einem browserbasierten Adobe-Anmeldefluss. In jedem Client ist das Setup-Muster gleich:
- Fügen Sie die Server-URL hinzu:
https://rtcdp-mcp.adobe.io/mcp - Speichern oder aktivieren Sie die Verbindung.
- Schließen Sie die Browser-basierte Adobe-Anmeldung ab, wenn der Client zum ersten Mal ein Tool aufruft.
- Geben Sie
imsOrgIdundsandboxNamezu Beginn jeder Sitzung an.
Allgemeine JSON-Konfiguration mcp-connect-json
Für Clients, die eine JSON-basierte MCP-Server-Konfiguration akzeptieren - wie Claude Desktop (claude_desktop_config.json), VS Code oder jeder Client, der eine mcp.json-Datei liest - verwenden Sie eines der folgenden Formate, je nachdem, ob Ihr Client natives Remote-HTTP unterstützt oder eine lokale Bridge benötigt:
Über mcp-remote Bridge (Claude Desktop und andere Clients, die eine lokale Bridge benötigen)
{
"mcpServers": {
"rtcdp": {
"command": "npx",
"args": [
"mcp-remote",
"https://rtcdp-mcp.adobe.io/mcp"
]
}
}
}
Natives Remote-HTTP (Clients, die es direkt unterstützen)
{
"mcpServers": {
"rtcdp": {
"url": "https://rtcdp-mcp.adobe.io/mcp",
"transport": "http"
}
}
}
Installieren in benutzeroberflächenbasierten Clients mcp-connect-ui
Claude
Fügen Sie für claude.ai und Claude Desktop den Real-Time CDP-MCP-Server als benutzerdefinierten Connector) der Server-URL-https://rtcdp-mcp.adobe.io/mcp hinzu.
- Individuelle Pläne - Navigieren Sie in Claude zu Anpassen → Connectoren, wählen Sie Connector hinzufügen aus und geben Sie die Server-URL ein.
- Team- und Unternehmenspläne - Ein Arbeitsbereich Verantwortlicher oder Primärer Verantwortlicher fügt den Connector unter Organisationseinstellungen → Connectoren hinzu. Nach dem Hinzufügen aktiviert jeder Benutzer sie in seinen eigenen Claude-Einstellungen.
Nachdem der Connector hinzugefügt wurde, aktivieren Sie ihn in einer Konversation und schließen Sie die Adobe-Browser-Anmeldung bei der ersten Verwendung ab. Claude erkennt den Adobe-Autorisierungsserver automatisch - es ist keine Client-ID oder kein Client-Geheimnis erforderlich.
ChatGPT
Fügen Sie ChatGPT den Real-Time CDP-MCP-Server als benutzerdefinierten Connector“:
- Navigieren Sie zu Einstellungen → Connectoren (oder Einstellungen → Apps und Connectoren je nach Plan).
- Wählen Sie Connector hinzufügen aus und geben Sie
https://rtcdp-mcp.adobe.io/mcpals Server-URL ein. - Speichern Sie den Connector. Abhängig von Ihrem ChatGPT kann dieser Schritt die Genehmigung Entwicklermodus oder des Arbeitsbereich-Administrators erfordern.
- Sobald der Connector aktiviert ist, authentifizieren Sie sich über die Adobe-Browser-Anmeldung, wenn Sie bei der ersten Verwendung dazu aufgefordert werden.
Cursor
Fügen Sie in Cursor den Real-Time CDP MCP-Server als Remote-MCP-Server hinzu:
- Öffnen Sie Einstellungen → MCP.
- Wählen Sie Neuen Server hinzufügen aus und geben Sie
https://rtcdp-mcp.adobe.io/mcpals Server-URL ein. - Wählen Sie Verbinden aus, um den Trigger für die Browser-basierte Adobe-Anmeldung zu erstellen und sich zu authentifizieren.
Sobald die Verbindung hergestellt ist, sind die Real-Time CDP-Tools im Cursor-Composer- und Agenten-Modus verfügbar.
Andere benutzeroberflächenbasierte Clients
Fügen Sie für Clients wie VS Code oder andere Desktop- und Web-Anwendungen mit Remote-MCP-Unterstützung den Real-Time CDP MCP-Server als Remote-HTTP-Server mit https://rtcdp-mcp.adobe.io/mcp hinzu. Wenn der Client optionale Kopfzeilen oder Bearer-Token unterstützt, lassen Sie diese leer - die Authentifizierung wird bei der ersten Verwendung über den browserbasierten Adobe-Anmeldefluss durchgeführt.
Installation in technischen Clients mcp-connect-technical
Claude Code
Fügen Sie den Server vom Terminal aus hinzu:
claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp
Starten Sie dann Claude Code und führen Sie Folgendes aus:
/mcp
Wählen Sie den rtcdp aus und schließen Sie den Anmeldevorgang für Adobe in Ihrem Browser ab. Wenn Sie den Server bereits in claude.ai hinzugefügt haben, wird er möglicherweise automatisch im Claude-Code angezeigt, wenn beide bei demselben Konto angemeldet sind.
Codex
Fügen Sie den Server vom Terminal aus hinzu:
codex mcp add rtcdp --url https://rtcdp-mcp.adobe.io/mcp
Server authentifizieren:
codex mcp login rtcdp
Überprüfen Sie die Konfiguration:
codex mcp list
Sie können den Server auch direkt zu ~/.codex/config.toml hinzufügen:
[mcp_servers.rtcdp]
url = "https://rtcdp-mcp.adobe.io/mcp"
Erforderliche Anfrageparameter mcp-connect-params
Jeder Tool-Aufruf erfordert zwei Parameter, die die Anfrage an Ihren Adobe Experience Platform-Mandanten ausrichten:
imsOrgId- Ihre Organisations-ID, die derx-gw-ims-org-id-Kopfzeile bei nachgelagerten Experience Platform-API-Aufrufen zugeordnet ist.sandboxName- Der Experience Platform-Sandbox-Name, der derx-sandbox-name-Kopfzeile zugeordnet ist.
Stellen Sie diese zu Beginn jeder Sitzung bereit. Beispiel:
„Verwenden Sie
1234ABCD@AdobeOrgund Sandbox-prodfür diese Sitzung.“
Wenn Sie Ihre Organisations-ID nicht kennen, bitten Sie Ihren KI-Assistenten, search_organizations anzurufen. Er gibt jede Organisation zurück, auf die Ihre Adobe-Anmeldeinformationen zugreifen können.
Bekannte Einschränkungen (Beta) mcp-limitations
Die folgenden Einschränkungen gelten für die aktuelle Beta-Version des Adobe Real-Time CDP MCP-Servers:
Preview Audience Membership erfordert einen gültigen PQL- oder SDD-Ausdruck als Eingabe. Der MCP-Server erstellt die Abfrage nicht für Sie.continuationToken verkettet werden.Inspect Activation Runs unterstützt das Filtern nach Status und Abschlusszeitstempel (Epoche ms UTC), jedoch nicht direkt nach Fehlertyp oder Zielplattform.flowId ersten (von List Configured Destinations abgerufenen) Durchläufen zum Bereich, der für ein bestimmtes Ziel bestimmt ist.search_organizations) erfordert imsOrgId und sandboxName als explizite Parameter. Wenn diese nicht angegeben werden, schlagen Tool-Aufrufe fehl.<YOUR_ORG_ID> und Sandbox-<SANDBOX_NAME> für diese Sitzung.“ Wenn Sie Ihre Organisations-ID nicht kennen, rufen Sie zuerst search_organizations auf. Es werden die Organisationen zurückgegeben, auf die Ihre Anmeldeinformationen zugreifen können.