[Begränsad tillgänglighet]{class="badge informative" title="Den här funktionen är för närvarande i en begränsad betaversion"}

Marketo Engage MCP-server

AVAILABILITY
Den här funktionen är i begränsad tillgänglighet. Om du vill begära åtkomst fyller du i det här formuläret. Se till att du har prenumerationens Munchkin-id till hands.

Model Context Protocol (MCP) är en öppen standard som gör att AI-verktyg kan kommunicera med externa tjänster. MCP-servern Marketo fungerar som en brygga mellan AI-assistenten och Marketo. Den visar över 100 operationer för formulär, program, smarta kampanjer, leads, e-post, fragment, listor och mappar.

När AI-verktyget anropar MCP-servern, kör servern motsvarande REST API-anrop åt dig med de autentiseringsuppgifter som du anger i varje begäran. Du behöver inte installera, distribuera eller köra någon programvara på serversidan.

IMPORTANT
Model Context Protocol (MCP) är en ny öppen källkodsstandard som kan utgöra säkerhets- eller tillförlitlighetsrisker. Adobe MCP-serverintegreringar och relaterad dokumentation tillhandahålls "i befintligt skick" utan garantier av något slag.
Att ansluta MCP-klienter eller servrar till Adobe-produkter är en kundvald konfiguration och kunderna ansvarar för att utvärdera säkerheten och lämpligheten för alla MCP-integreringar. Adobe ansvarar inte för problem som uppstår vid felkonfigurering, felanvändning av MCP, säkerhetsluckor i implementeringar från tredje part eller oavsiktliga åtgärder som utförs via MCP-aktiverade arbetsflöden.
För att minska riskerna rekommenderar Adobe att du testar integreringar i en sandlådemiljö innan du använder dem effektivt och att du noggrant granskar och validerar alla MCP-initierade åtgärder och svar innan du bekräftar eller förlitar dig på dem.

Grundläggande om MCP

Fundera på MCP som en USB-C-port för AI-program. På samma sätt som USB-C erbjuder ett standardiserat sätt att ansluta dina enheter till olika kringutrustning och tillbehör erbjuder MCP ett standardiserat sätt att ansluta AI-modeller till datakällor och verktyg. — Modellkontextprotokoll

Med MCP kan ett AI-verktyg ansluta till flera externa tjänster samtidigt. En AI-assistent kan till exempel:

  • Ansluta till en ordbehandlare för AI-assisterad dokumentgenerering
  • Anslut till animeringsverktyg, som Blender, för visualiseringar av bygge
  • Ansluta till Adobe After Effects för videoredigering

MCP är ett kommunikationsprotokoll: en öppen standard som alla program kan implementera för att visa sina data och åtgärder för AI-verktyg.

Vad Marketo Engage MCP gör och inte gör

Om du förstår omfattningen av MCP kan du ställa in förväntningarna innan du ansluter ditt AI-verktyg.

MCP gör:

  • Ge åtkomst till Marketo data och funktioner via REST API:er av standardtyp
  • Kör API-anrop åt dig med de autentiseringsuppgifter du anger för varje begäran
  • Stöd för flera samtidiga användare, var och en anslutna med sina egna autentiseringsuppgifter
  • Hantera automatisk uppdatering av OAuth-token. Du behöver inte hantera utgångsdatum för token
  • Arbeta i miljöer där klienterna är isolerade så att data aldrig överlappar en annan användares session

MCP har inte:

  • Använd, hantera eller kör alla AI- eller maskininlärningsmodeller. All AI-bearbetning sker i AI-verktyget, inte i MCP
  • Utbilda dig på eller lär dig av data, inklusive kunddata
  • Generera prognoser, rekommendationer och beslut. Beslutsfattandet åligger det underliggande AI-verktyget eller användaren
  • Lagra eller bevara autentiseringsuppgifter, data för begäran eller sessionstillstånd mellan begäranden
  • Kräv att du installerar, distribuerar eller hanterar programvara på serversidan

MCP kan överföra data, inklusive potentiellt känsliga fält, beroende på API-användning, men B2B-data inbegriper kundaffärsdata och omfattar inte PII-data.

Förutsättningar

  • En Marketo-instans med REST API-åtkomst aktiverad
  • Administratörsåtkomst för att skapa API-autentiseringsuppgifter i Marketo LaunchPoint
  • Ett av följande AI-verktyg: Claude Desktop, Cursor, Codex, Claude Code (CLI) eller VS Code med GitHub Copilot
  • Nätverksåtkomst till MCP-serverns URL: https://marketo-mcp.adobe.io/mcp

Hämta Marketo-inloggningsuppgifter

Du behöver följande värden från din Marketo-instans:

  • Klient-ID
  • Klienthemlighet
  • Munchkin konto-ID

Om du redan har dem går du till Konfigurera ditt AI-verktyg.

Klient-ID och klienthemlighet

  1. Gå till Admin > LaunchPoint.
  2. Välj API-tjänst. Om du inte har någon väljer du New > New Service, väljer Custom som tjänstetyp och tilldelar en dedikerad API-användare.
  3. Markera View Details och kopiera värdena Client ID och Client Secret.

Munchkin konto-ID

  1. Gå till Admin > Munchkin.
  2. Kopiera Munchkin Account ID. Formatet är XXX-XXX-XXX och matchar prefixet för din instans-URL.

Konfigurera ditt AI-verktyg

Varje AI-verktyg har något olika inställningar. Exempel på anslutningar finns för vanliga verktyg.

TIP
Om du vill ansluta till flera Marketo-instanser lägger du till separata poster i MCP-konfigurationen med unika namn: marketo-prod och marketo-staging , var och en med motsvarande autentiseringsuppgifter.

Claude Desktop claude-desktop

Om du vill ansluta till Claude Desktop hämtar du marketo-mcp-bridge.zip och packar upp det. Placera marketo-mcp-bridge.mjs på en känd plats så att du kan referera i nästa steg.

Du behöver också:

  • Node.js v18+
  • npm
  1. Open Claude Desktop
  2. Gå till Inställningar > Utvecklare > Redigera konfiguration
  3. Lägg till följande i 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. Starta om Claude Desktop

Markör cursor

Om MCP-konfigurationen för pekaren redan innehåller andra servrar lägger du till posten marketo under mcpServers.
I följande exempel visas det fullständiga mcpServers -blocket i Settings > MCP eller .cursor/mcp.json i din projektkatalog:

IMS-token
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"
      }
    }
  }
}
Marketo-klientautentiseringsuppgifter
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"
      }
    }
  }
}

Starta om markören.

Claude Code (CLI) claude-code

Kör följande kommando i terminalen och ersätt dina autentiseringsuppgifter:

IMS-token
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"
Marketo-klientautentiseringsuppgifter
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"

OpenAI Codex codex

  1. Gå till Inställningar > MCP-servrar > Lägg till server
  2. Lägg till server-URL: https://marketo-mcp.adobe.io/mcp
  3. Lägg till rubrikerna för din autentiseringsmetod:
IMS-token
  • Behörighet: “Bearer YOUR-IMS-TOKEN”
  • x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
Marketo-klientautentiseringsuppgifter
  • X-Marketo-klient-ID: “YOUR-CLIENT-ID”
  • X-Marketo-Client-Secret: “DITT KLIENTSEKRET”
  • X-Marketo-Munchkin-ID: “DITT-MUNCHKIN-ID”
  1. Klicka på Spara för att slutföra processen.

VS-kod med GitHub Copilot vscode

Tryck på Ctrl+Shift+P (eller Cmd+Shift+P på macOS), skriv MCP: Open User Configuration och tryck på Retur. mcp.json öppnas. Lägg till posten marketo inuti objektet servers:

IMS-token
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"
      }
    }
  }
}
Marketo-klientautentiseringsuppgifter
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"
      }
    }
  }
}
NOTE
Av säkerhetsskäl bör du använda miljövariabel interpolation i konfigurationsfiler i stället för att klistra in autentiseringsuppgifter direkt. Du kan referera till variabler med syntax som ${MARKETO_CLIENT_SECRET} och ange dem i din miljö. Detta förhindrar att autentiseringsuppgifter lagras som oformaterad text i versionskontrollerade filer.

Andra verktyg other-tools

MCP-servern Marketo finns hos Adobe och visas på en offentlig URL. Alla MCP-klienter som stöder fjärrservrar via strömlinjeformad HTTP-transport kan ansluta till den.
Du behöver ingen verktygsspecifik brygga eller någon lokalt installerad programvara. Om verktyget inte finns med i listan ovan kan du konfigurera det manuellt med hjälp av anslutningsinformationen nedan.

Anslutningsinformation:

Inställning
Värde
Transport
HTTP (strömningsbar HTTP)
Server-URL
https://marketo-mcp.adobe.io/mcp

Autentiseringsrubriker:

Skicka rubrikerna för någon av följande autentiseringsmetoder med varje begäran. Var du anger serverns URL och rubriker beror på verktyget, så läs i dess MCP-dokumentation.

IMS-token
table 0-row-2 1-row-2 2-row-2
Sidhuvud Värde
Authorization Bearer YOUR-IMS-TOKEN
x-gw-ims-org-id Ditt IMS-organisations-ID
Marketo-klientautentiseringsuppgifter
table 0-row-2 1-row-2 2-row-2 3-row-2
Sidhuvud Värde
X-Marketo-Client-Id Ditt klient-ID
X-Marketo-Client-Secret Din klienthemlighet
X-Marketo-Munchkin-Id Ditt Munchkin-konto-ID

Om verktyget accepterar en JSON-konfiguration börjar du med exemplen Cursor eller VS Code och justerar nycklarna (mcpServers, servers) så att de matchar verktygets schema.

Tillgängliga åtgärder

När du är ansluten kan du be AI-assistenten att utföra åtgärder i följande kategorier. En fullständig lista över åtgärder som stöds med API-referenser finns i MCP-åtgärder som stöds.

Forms

Bläddra, skapa, klona och godkänn formulär. Lägg till eller ta bort fält, konfigurera regler för fältsynlighet och identifiera var formulär är inbäddade.

Exempelmeddelanden:

  • “Visa alla godkända formulär”
  • “Klona formuläret Kontakta oss till mappen Q2 Campaign”
  • “Lägg till ett företagsfält i formuläret för demonstrationsbegäran”

Smarta kampanjer

Skapa smarta kampanjer, konfigurera smarta listfilter, lägg till flödessteg och aktivera eller inaktivera kampanjer.

Exempelmeddelanden:

  • “Vilka smarta kampanjer är aktiva just nu?”
  • “Skapa en ny smart kampanj med namnet Lead Scoring Update i mappen Operations”
  • “Visa mig flödesstegen i välkomstkampanjen via e-post”

Leads och listor

Hitta leads via e-postadress, skapa eller uppdatera lead-poster och hantera statiskt listmedlemskap.

Exempelmeddelanden:

  • “Hitta leads med e-post jane@example.com”
  • “Lägg till lead-ID 12345 i Q2 MQL-listan”
  • “Skapa en ny statisk lista som heter Sommarevent-deltagare”

Program

Skapa, klona och tagga program. Bläddra bland program efter typ, kanal eller datumintervall.

Exempelmeddelanden:

  • “Clone the Q4 Webinar program into the 2026 Events folder”
  • “Skapa ett nytt e-postprogram som heter Sommarförsäljning i mappen Campaigns”
  • “Visa alla program som är taggade som webbinarier”

Mejl och textutdrag

Bläddra bland e-postmeddelanden, skapa e-postmeddelanden från mallar, uppdatera innehållsavsnitt och hantera återanvändbara fragment.

Exempelmeddelanden:

  • “Visa mig alla e-postutkast”
  • “Uppdatera rubrikdelen i välkomstmeddelandet”
  • “Vilka resurser använder Kodavsnittet för helgerbjudanden?”

Instansstruktur

Bläddra bland mappar, kanaler, taggtyper och aktivitetstyper för att förstå din Marketo-konfiguration.

Exempelmeddelanden:

  • “Lista alla mappar i Marketo”
  • “Visa alla tillgängliga kanaler”
  • “Vilka taggtyper har konfigurerats?”

Massåtgärder

Exportera lead-data i bulk och kontrollera import- eller exportjobbstatus.

Exempelmeddelanden:

  • “Skapa en bulkexport av leads som skapats de senaste 30 dagarna”
  • “Kontrollera status för exportjobb xx”

Felsökning

Fel
Orsak
Korrigera
“Marketo-autentiseringsuppgifter har inte angetts”
En eller flera av X-Marketo-Client-Id, X-Marketo-Client-Secret eller X-Marketo-Munchkin-Id saknas.
Kontrollera att alla Marketo-klientautentiseringsuppgifter finns i konfigurationen.
“401 Obehörig”
Dina autentiseringsuppgifter saknas, är ogiltiga eller har gått ut. Klient-ID:t eller klienthemligheten är felaktiga med Marketo klientautentiseringsuppgifter. Med en IMS-token är token ogiltig eller har gått ut.
Verifiera autentiseringsuppgifterna för din autentiseringsmetod. Om du vill ha klientautentiseringsuppgifter kontrollerar du Client ID och Client Secret i Admin > LaunchPoint. Generera en ny token för en IMS-token och uppdatera rubriken Authorization.
“403 Förbjuden”
Dina autentiseringsuppgifter är giltiga, men din Marketo-instans har inte aktiverats för MCP-åtkomst.
Kontakta din Marketo MCP-administratör om du vill aktivera MCP-åtkomst för ditt Munchkin konto-ID.
“För många begäranden” (hastighetsgräns)
Du skickade för många begäranden under en kort period, eller för många begäranden samtidigt, och nådde API-gränserna för din Marketo-instans.
Minska hur ofta och hur många förfrågningar du skickar samtidigt och vänta en kort stund innan du försöker igen. Använd en dedikerad API-användare för att spåra och hantera din kvot.
Anslutningens timeout eller nekade
Det går inte att nå MCP-servern från nätverket.
Bekräfta att du kan nå serverns URL från din miljö. Kontrollera VPN-kraven om tillämpligt.
Verktygsanrop returnerar tomma resultat
API-användaren saknar behörigheter för den begärda resurstypen.
Be din Marketo-administratör att granska API-användarrollen och behörigheter.

Säkerhetsaspekter

IMPORTANT
Använd en dedikerad API-användare i Marketo med endast de behörigheter som krävs för ditt arbete. Återanvänd inte administratörsautentiseringsuppgifter för API-åtkomst.
  • Autentiseringsuppgifter per begäran. Klient-ID, Klienthemlighet, Munchkin-ID och REST API-slutpunkten överförs i HTTP-huvuden vid varje begäran. Servern lagrar eller cachelagrar dem inte.
  • Multi-tenant-isolering. Varje begäran använder sin egen uppsättning med autentiseringsuppgifter. Dina data korsar inte någon annan användares session.
  • Munchkin ID tillåtelselista. Servern accepterar endast begäranden för godkända Marketo instanser. Begäranden som använder ett obehörigt Munchkin-ID avvisas med ett 403-fel.
  • Gränser för API-frekvens. MCP-servern ärver API-hastighetsgränserna för din Marketo-instans. Använd en dedikerad API-användare för att spåra och hantera kvotförbrukning.
  • Håll autentiseringsuppgifterna utanför versionskontrollen. Använd interpolation med miljövariabel (${MARKETO_CLIENT_SECRET}) om AI-verktyget stöder det, så autentiseringsuppgifterna lagras inte i oformaterad text i databasfiler.
recommendation-more-help
marketo-developer-help