[Beperkte beschikbaarheid]{class="badge informative" title="Deze functie bevindt zich momenteel in een beperkte bètaversie"}

Marketo Engage MCP-server

AVAILABILITY
Deze functie is in beperkte beschikbaarheid. Om toegang te verzoeken, vul ​ deze vorm ​ in. Zorg ervoor dat je Munchkin-id van je abonnement klaar is.

ModelContextProtocol (MCP) is een open norm die AI hulpmiddelen om met de externe diensten toelaat te communiceren. De Marketo MCP-server fungeert als een brug tussen uw AI-assistent en Marketo . Er worden meer dan 100 bewerkingen in verschillende formulieren, programma’s, slimme campagnes, leads, e-mails, fragmenten, lijsten en mappen weergegeven.

Wanneer uw AI hulpmiddel de server MCP roept, voert de server de overeenkomstige REST API vraag op uw naam uit, gebruikend de geloofsbrieven u in elk verzoek ingaat. U hoeft geen software op de server te installeren, implementeren of uitvoeren.

IMPORTANT
Het ModelContextprotocol (MCP) is een nieuwe open-bronnorm en kan veiligheid of betrouwbaarheidsrisico's voorstellen. Adobe MCP server integrations en verwante documentatie worden verstrekt "zoals is,"zonder enige garanties van welke aard ook.
het Verbinden van cliënten MCP of servers met de producten van Adobe is een klant-verkozen configuratie, en de klanten zijn verantwoordelijk voor het evalueren van de veiligheid en de geschiktheid van om het even welke integratie MCP. Adobe is niet verantwoordelijk voor problemen die voortvloeien uit verkeerde configuratie, misbruik van MCP, kwetsbaarheden in derdeimplementaties, of onbedoelde acties die via MCP-Toegelaten werkschema's worden uitgevoerd.
om risico te verminderen, moedigt Adobe het testen van integratie in een zandbakmilieu voorafgaand aan productief gebruik aan en zorgvuldig het herzien en het bevestigen van alle MCP-Gerichte acties en reacties alvorens te bevestigen of op hen te vertrouwen.

Basisbeginselen van MCP

Denk aan MCP als haven USB-C voor toepassingen AI. Net zoals USB-C een gestandaardiseerde manier biedt om uw apparaten aan te sluiten op verschillende randapparaten en accessoires, biedt MCP een gestandaardiseerde manier om AI-modellen aan gegevensbronnen en hulpmiddelen aan te sluiten. — ​ ModelContext Protocol ​

MCP staat een AI hulpmiddel toe om met de veelvoudige externe diensten tezelfdertijd te verbinden. Een AI-assistent kan bijvoorbeeld:

  • Verbinding maken met een tekstverwerker voor het genereren van AI-documenten
  • Verbinding maken met animatieprogramma’s, zoals blender, voor het maken van visualisaties
  • Verbinding maken met Adobe After Effects voor videobewerking

MCP is een communicatieprotocol: een open norm die om het even welke toepassing kan uitvoeren om zijn gegevens en acties aan hulpmiddelen van AI bloot te stellen.

Wat Marketo Engage MCP doet en niet doet

Het begrip van het werkingsgebied van MCP helpt verwachtingen plaatsen alvorens u uw hulpmiddel van AI verbindt.

MCP doet:

  • Toegang tot Marketo gegevens en mogelijkheden bieden via standaard REST API’s
  • Voer API vraag uit namens u gebruikend geloofsbrieven u met elk verzoek verstrekt
  • Meerdere gelijktijdige gebruikers ondersteunen, elk verbonden met hun eigen referenties
  • OAuth-token automatisch vernieuwen. U hoeft het verlopen van token niet te beheren
  • Werken binnen gehuurde milieu’s zodat uw gegevens nooit met de zitting van een andere gebruiker snijden

MCP niet:

  • Gebruik, host of voer eventuele AI- of computerleermodellen uit. Alle AI-verwerking vindt plaats in uw AI-gereedschap, niet in de MCP
  • Leer op of leer van om het even welke gegevens, met inbegrip van uw klantengegevens
  • Hiermee genereert u voorspellingen, aanbevelingen of beslissingen. Besluitvorming valt onder de verantwoordelijkheid van de downstreamgebruiker van AI
  • Opslaan of behouden van referenties, gegevens aanvragen of sessiestatus tussen aanvragen
  • Vereisen dat u serversoftware installeert, implementeert of beheert

MCP kan gegevens, met inbegrip van potentieel gevoelige gebieden, afhankelijk van API gebruik overbrengen maar B2B de gegevens van de klant bedrijfsgegevens impliceren en impliceert geen PII gegevens.

Vereisten

  • Een Marketo -instantie met REST API-toegang ingeschakeld
  • Beheerdersrechten kunnen API-referenties maken in Marketo LaunchPoint
  • Een van de volgende AI-gereedschappen: Claude Desktop, Cursor, Codex, Claude Code (CLI), of de Code van VS met GitHub Copilot
  • Netwerktoegang tot de URL van de MCP-server: https://marketo-mcp.adobe.io/mcp

Marketo-referenties ophalen

U hebt de volgende waarden van uw Marketo -instantie nodig:

  • identiteitskaart van de Cliënt
  • Geheim van de Cliënt
  • identiteitskaart van de Rekening van Munchkin

Als u reeds hen hebt, overslaan aan ​ vorm uw AI hulpmiddel ​.

Client-id en clientgeheim

  1. Ga naar Admin > LaunchPoint .
  2. Selecteer uw API-service. Als u er geen hebt, selecteert u New > New Service , kiest u Custom als het servicetype en wijst u een toegewijde API-gebruiker toe.
  3. Selecteer View Details en kopieer de waarden Client ID en Client Secret .

Munchkin-account-id

  1. Ga naar Admin > Munchkin .
  2. Kopieer de Munchkin Account ID . De indeling is XXX-XXX-XXX en komt overeen met het voorvoegsel van de instantie-URL.

Uw AI-gereedschap configureren

Elk AI-gereedschap heeft een iets andere instelling. Verbindingsvoorbeelden worden gegeven voor algemene gereedschappen.

TIP
Als u verbinding wilt maken met meerdere Marketo -instanties, voegt u afzonderlijke items in uw MCP-configuratie toe met unieke namen: marketo-prod en marketo-staging , elk met de bijbehorende referenties.

Claude Desktop claude-desktop

Om met de Desktop van Claude te verbinden, download ​ marketo-mcp-bridge.zip ​ en pak het uit. Plaats marketo-mcp-bridge.mjs op een bekende locatie, zodat u in de volgende stap kunt verwijzen.

U hebt ook het volgende nodig:

  • Node.js v18+
  • npm
  1. Open Claude Desktop
  2. Ga naar Montages > Ontwikkelaar > geef Config uit
  3. Voeg het volgende toe aan claude_desktop_config.json:
{
  "preferences": {
    ...
  },
  "mcpServers": {
    "marketo-mcp": {
      "command": "node",
      "args": ["/path/to/marketo-bridge/bridge.mjs"],
      "env": {
        "MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
        "MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
        "MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
      }
    }
  }
}
  1. Start Claude Desktop opnieuw

Cursor cursor

Als uw MCP-configuratie van Cursor al andere servers bevat, voegt u de marketo -vermelding toe onder mcpServers . In het volgende voorbeeld wordt het volledige mcpServers blok in Settings > MCP of .cursor/mcp.json in de projectmap getoond:

de cliëntgeloofsbrieven van Marketo
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}
IMS teken
code language-json
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}

Start de cursor opnieuw.

Claude Code (CLI) claude-code

Voer het volgende bevel in uw terminal in werking, die uw geloofsbrieven vervangt:

de cliëntgeloofsbrieven van Marketo
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
  --header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
  --header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"
IMS teken
code language-bash
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "Authorization: Bearer YOUR-IMS-TOKEN" \
  --header "x-gw-ims-org-id: YOUR-IMS-ORG-ID"

OpenAI Codex codex

  1. Ga naar Instellingen > MCP-servers > Server toevoegen
  2. Voeg de URL van de server toe: https://marketo-mcp.adobe.io/mcp
  3. Voeg de kopballen voor uw authentificatiemethode toe:
de cliëntgeloofsbrieven van Marketo
  • X-Marketo-Client-ID: “UW-CLIENT-ID”
  • X-Marketo-Client-Secret: “UW-CLIENT-SECRET”
  • X-Marketo-Munchkin-ID: “UW-MUNCHKIN-ID”
IMS teken
  • Autorisatie: “Drager UW IMS-TOKEN”
  • x-gw-ims-org-id: “UW-IMS-ORG-ID”
  1. Klik op Opslaan om het proces te voltooien.

VS-code met GitHub Copilot vscode

Druk op Ctrl+Shift+P (of Cmd+Shift+P op macOS), typ MCP: Open User Configuration en druk op Enter. Dit wordt geopend mcp.json . Voeg de vermelding marketo toe in het object servers :

de cliëntgeloofsbrieven van Marketo
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "YOUR-CLIENT-ID",
        "X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
        "X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
      }
    }
  }
}
IMS teken
code language-json
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
NOTE
Voor veiligheidsdoeleinden, gebruik milieu veranderlijke interpolatie in configuratiedossiers in plaats van het kleven van geloofsbrieven direct. U kunt naar variabelen verwijzen met syntaxis als ${MARKETO_CLIENT_SECRET} en deze in uw omgeving instellen. Hiermee voorkomt u dat referenties worden opgeslagen in onbewerkte tekst in bestanden met versiebeheer.

Beschikbare bewerkingen

Zodra verbonden, kunt u uw AI medewerker vragen om verrichtingen over de volgende categorieën uit te voeren. Voor de volledige lijst van gesteunde verrichtingen met API verwijzingen, zie ​ Gesteunde verrichtingen MCP ​.

Forms

Bladeren, maken, klonen en goedkeuren van formulieren. U kunt velden toevoegen of verwijderen, zichtbaarheidsregels voor velden configureren en bepalen waar formulieren worden ingesloten.

Voorbeeld vraagt:

  • “Alle goedgekeurde formulieren weergeven”
  • “Clone the Contact US form into the Q2 Campaign folder”
  • “Voeg een gebied van het Bedrijf aan de vorm van het Verzoek van de Demo toe”

Slimme campagnes

Maak slimme campagnes, configureer filters voor slimme lijsten, voeg flowstappen toe en activeer of deactiveer campagnes.

Voorbeeld vraagt:

  • “Welke slimme campagnes zijn nu actief?”
  • “Maak een nieuwe slimme campagne met de naam Update voor het weergeven van leads in de map Operations”
  • “Toon me de stroomstappen in de Welkome E-mailcampagne”

Leads en lijsten

Leden zoeken op e-mailadres, leadrecords maken of bijwerken en lidmaatschap van statische lijsten beheren.

Voorbeeld vraagt:

  • “Zoek de lead met e-mail jane@example.com”
  • “Voeg loodnummer 12345 toe aan de lijst Q2 MQL.”
  • “Maak een nieuwe statische lijst met de naam Zomergebeurtenisdeelnemers”

Programma’s

Maak, kloon en tagprogramma’s. Blader door programma’s op type, kanaal of datumbereik.

Voorbeeld vraagt:

  • “Clone the Q4 Webinar program into the 2026 Events folder”
  • “Maak een nieuw e-mailprogramma met de naam Summer Sale in de map Campaigns”
  • “Toon me alle programma’s die als Webinar worden geëtiketteerd”

E-mails en fragmenten

Blader door e-mailberichten, maak e-mails van sjablonen, werk inhoudssecties bij en beheer herbruikbare fragmenten.

Voorbeeld vraagt:

  • “Alle e-mailconcepten weergeven”
  • “De koptekstsectie van het welkomstbericht bijwerken”
  • “Welke middelen gebruiken het fragment van de Promo van de Vakantie?”

Instantiestructuur

Als u de Marketo -configuratie wilt begrijpen, bladert u door mappen, kanalen, typen tags en typen activiteiten.

Voorbeeld vraagt:

  • “Alle mappen weergeven in Marketo”
  • “Alle beschikbare kanalen weergeven”
  • “Welke markeringstypes worden gevormd?”

Bulkbewerkingen

Gegevens voor lead bulksgewijs exporteren en status van import- of exporttaak controleren.

Voorbeeld vraagt:

  • “Maak een grote export van leads die in de afgelopen 30 dagen zijn gemaakt”
  • “De status van exporttaak xx controleren”

Problemen oplossen

Fout
Oorzaak
Repareren
“Marketo credentials not provided”
Een of meer van X-Marketo-Client-Id, X-Marketo-Client-Secret of X-Marketo-Munchkin-Id ontbreken.
Controleer of alle Marketo-clientverificatieheaders aanwezig zijn in uw configuratie.
“401 Onbevoegd”
Uw referenties ontbreken, zijn ongeldig of zijn verlopen. Bij Marketo-clientreferenties is de client-id of het clientgeheim onjuist. Bij een IMS-token is de token ongeldig of verlopen.
Verifieer de geloofsbrieven voor uw authentificatiemethode. Controleer Client ID en Client Secret in Admin > LaunchPoint opnieuw voor clientreferenties. Voor een IMS-token genereert u een nieuw token en werkt u de header Authorization bij.
“403 Verboden”
Uw referenties zijn geldig, maar uw Marketo -instantie is niet ingeschakeld voor MCP-toegang.
Neem contact op met uw Marketo MCP-beheerder om MCP-toegang voor uw Munchkin-account-id in te schakelen.
“Te veel aanvragen” (tarieflimiet)
U hebt te veel verzoeken in een korte periode of te veel aanvragen tegelijkertijd verzonden en hebt de API-limieten van uw Marketo -instantie bereikt.
Verminder hoe vaak en hoeveel verzoeken u tegelijk verzendt en wacht even voordat u het opnieuw probeert. Gebruik een specifieke API-gebruiker om uw quota te volgen en te beheren.
Time-out verbinding of geweigerd
De server MCP is onbereikbaar van uw netwerk.
Bevestig dat u de server-URL vanuit uw omgeving kunt bereiken. Controleer de VPN-vereisten, indien van toepassing.
De vraag van het hulpmiddel keert lege resultaten terug
De API-gebruiker heeft geen machtigingen voor het aangevraagde elementtype.
Vraag uw Marketo -beheerder om de API-gebruikersrol en -machtigingen te controleren.

Beveiligingsoverwegingen

IMPORTANT
Gebruik een specifieke API-gebruiker in Marketo met alleen de machtigingen die nodig zijn voor uw werk. Gebruik de beheerdersreferenties niet opnieuw voor API-toegang.
  • geloofsbrieven per-verzoek. Clientid, clientgeheim, Munchkin-id en het REST API-eindpunt worden met elke aanvraag verzonden in HTTP-headers. Deze worden niet opgeslagen of in cache opgeslagen door de server.
  • multi-huurdersisolatie. Elk verzoek gebruikt zijn eigen reeks geloofsbrieven. Uw gegevens hebben geen interactie met een sessie van een andere gebruiker.
  • de lijst van gewenste personen van identiteitskaart van Munchkin. De server accepteert alleen aanvragen voor goedgekeurde Marketo -instanties. Aanvragen met een niet-geautoriseerde Munchkin-id worden afgewezen met een fout van 403.
  • API tariefgrenzen. De MCP-server overerft de API-snelheidslimieten van uw Marketo -instantie. Gebruik een specifieke API-gebruiker om quotaverbruik te volgen en te beheren.
  • houd geloofsbrieven uit versiecontrole. Gebruik omgevingsvariabele interpolatie (${MARKETO_CLIENT_SECRET}) als uw AI-gereedschap dit ondersteunt, zodat referenties niet worden opgeslagen in onbewerkte tekst in gegevensopslagbestanden.
recommendation-more-help
marketo-developer-help