DokumentationUtvecklarhandbok för Marketo

[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

Senast uppdaterad: 8 maj 2026

Skapat för:

  • Admin
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 olika 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 3D-modelleringsprogram som Blender för att skapa animeringar
  • Ansluta till After Effects för videoredigering

MCP är ett kommunikationsprotokoll - en öppen standard som alla program kan implementera för att visa 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 eller beslut - beslutsfattandet ligger i det efterföljande 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, 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 läser MCP-serverkonfiguration från en annan plats. Hitta verktyget nedan och följ stegen för att lägga till MCP-servern Marketo.

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

Claude Desktop

Konfigurationsfilen är claude_desktop_config.json. Öppna den från någon av följande platser:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Om filen redan innehåller andra MCP-servrar lägger du till posten marketo under mcpServers. I följande exempel visas det fullständiga mcpServers-blocket:

{
  "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"
      }
    }
  }
}

Spara filen, avsluta Claude Desktop och öppna den igen.

Markör

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:

{
  "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)

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

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"

VS-kod med GitHub Copilot

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:

{
  "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 i oformaterad text i filer som kan implementeras för versionskontroll.

Tillgängliga åtgärder

När du är ansluten kan du be AI-assistenten att utföra åtgärder i följande kategorier.

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 fyra rubrikerna finns i konfigurationen.
“Autentiseringsfel”
Dina autentiseringsuppgifter är ogiltiga eller har upphört att gälla.
Kontrollera ditt klient-ID och klienthemlighet igen i Admin > LaunchPoint.
“403 Förbjuden”
Ditt Munchkin-ID finns inte på tillåtelselista på servern.
Kontakta din Marketo MCP-administratör för att lägga till ditt Munchkin-ID.
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 filer som implementeras i en databas.
recommendation-more-help
marketo-developer-help