[Disponibilità limitata]{class="badge informative" title="Questa funzione è attualmente in versione beta limitata"}

Server MCP Marketo Engage

Model Context Protocol (MCP) è uno standard aperto che collega gli strumenti di intelligenza artificiale a servizi esterni. Il server MCP Marketo collega l’assistente AI a Marketo. Fornisce più di 100 operazioni per moduli, programmi, campagne intelligenti, lead, e-mail, snippet, elenchi e cartelle.

Quando lo strumento di intelligenza artificiale chiama il server MCP, il server utilizza le credenziali in tale richiesta per eseguire la chiamata API REST corrispondente. Non è necessario installare, distribuire o eseguire software lato server.

Per ulteriori informazioni sulla gestione dei dati con Marketo AI e il server Marketo Engage MCP, vedere la pagina Informazioni sui dati.

Nozioni di base su MCP

Pensa a MCP come a una porta USB-C per applicazioni AI. USB-C offre un modo standardizzato per collegare i dispositivi a varie periferiche e accessori e MCP offre un modo standardizzato per collegare i modelli AI a origini dati e strumenti. — Protocollo contesto modello

MCP consente a uno strumento di intelligenza artificiale di connettersi simultaneamente a più servizi esterni. Ad esempio, un assistente AI può:

Qualsiasi applicazione può implementare MCP per esporre dati e azioni a strumenti di intelligenza artificiale.

Funzionamento di Marketo Engage MCP

Comprendere l’ambito di MCP consente di impostare le aspettative prima di collegare lo strumento AI.

Operazione MCP:

MCP non:

MCP può trasmettere dati, inclusi campi potenzialmente sensibili, a seconda dell’utilizzo dell’API, ma i dati B2B coinvolgono i dati aziendali del cliente e non i dati PII.

Prerequisiti

Ottieni credenziali Marketo

Sono necessari i seguenti valori dall’istanza Marketo:

Se ne hai già uno, passa a Configura il tuo strumento di intelligenza artificiale.

ID client e segreto client

ID account Munchkin

Configurare lo strumento AI

La configurazione varia in base allo strumento di intelligenza artificiale. Le sezioni seguenti forniscono esempi di connessione per gli strumenti più comuni.

Claude Desktop claude-desktop

Per connettersi a Claude Desktop, scarica marketo-mcp-bridge.zip e decomprimi. Posiziona marketo-mcp-bridge.mjs in una posizione nota in modo da poter fare riferimento al passaggio successivo.

Avrà inoltre bisogno di:

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

Cursore cursor

Se la configurazione MCP cursore contiene già altri server, aggiungere la voce marketo in mcpServers.
L’esempio seguente mostra il blocco mcpServers completo in Settings > MCP o .cursor/mcp.json nella directory del progetto:

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

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

Riavvia cursore.

Codice Claude (CLI) claude-code

Esegui il comando seguente nel terminale, sostituendo le credenziali:

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"

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"

Codice OpenAI codex

Codice VS con GitHub Copilot vscode

Premere Ctrl+Shift+P (o Cmd+Shift+P su macOS), digitare MCP: Open User Configuration e premere Invio. Verrà aperto mcp.json. Aggiungi la voce marketo all’interno dell’oggetto servers:

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

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

Glean glean

Per connettere Glean al server Marketo Engage MCP, il team del supporto Glean deve configurare le seguenti intestazioni personalizzate.

Altri strumenti other-tools

Adobe ospita il server MCP Marketo e lo espone a un URL pubblico. Qualsiasi client MCP che supporti server remoti tramite trasporto HTTP semplificabile può connettersi ad esso.
Non è necessario un bridge specifico per lo strumento o un software installato localmente. Se lo strumento non è elencato sopra, utilizza i dettagli di connessione riportati di seguito per configurarlo manualmente.

Dettagli connessione:

Intestazioni di autenticazione:

Invia le intestazioni per uno dei seguenti metodi di autenticazione a ogni richiesta. La posizione in cui inserisci l’URL del server e le intestazioni dipende dallo strumento, quindi consulta la relativa documentazione MCP.

Se lo strumento accetta una configurazione JSON, inizia con gli esempi di Cursore o Codice VS e regola le chiavi (mcpServers, servers) in modo che corrispondano allo schema dello strumento.

Operazioni disponibili

Una volta connesso, puoi chiedere all’assistente AI di eseguire operazioni nelle seguenti categorie. Per l’elenco completo delle operazioni supportate con riferimenti API, vedere Operazioni MCP supportate.

Moduli

Sfogliare, creare, clonare e approvare i moduli. Aggiungi o rimuovi campi, configura regole di visibilità dei campi e identifica dove sono incorporati i moduli.

Esempio di prompt:

Campagne avanzate

Crea campagne intelligenti, configura filtri di elenchi avanzati, aggiungi passaggi di flusso e attiva o disattiva campagne.

Esempio di prompt:

Lead ed elenchi

Trova i lead per indirizzo e-mail, crea o aggiorna i record dei lead e gestisci l’iscrizione all’elenco statico.

Esempio di prompt:

Programmi

Creare, clonare e assegnare tag ai programmi. Sfoglia i programmi per tipo, canale o intervallo di date.

Esempio di prompt:

E-mail e snippet

Sfoglia le e-mail, crea e-mail dai modelli, aggiorna le sezioni di contenuto e gestisci snippet riutilizzabili.

Esempio di prompt:

Struttura dell’istanza

Per comprendere la configurazione di Marketo, sfoglia cartelle, canali, tipi di tag e tipi di attività.

Esempio di prompt:

Operazioni in blocco

Esporta i dati del lead in blocco e controlla lo stato del processo di importazione o esportazione.

Esempio di prompt:

Risoluzione dei problemi

Considerazioni sulla sicurezza

Governance e conservazione dei dati

Gestione delle credenziali

Modello di interazione API

Autenticazione e autorizzazione

Registrazione e monitoraggio