[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 consente agli strumenti di intelligenza artificiale di comunicare con servizi esterni. Il server MCP Marketo funge da ponte tra l’assistente AI e Marketo. Espone più di 100 operazioni tra moduli, programmi, campagne intelligenti, lead, e-mail, snippet, elenchi e cartelle.

Quando lo strumento di intelligenza artificiale chiama il server MCP, il server esegue la chiamata API REST corrispondente per tuo conto, utilizzando le credenziali fornite in ogni richiesta. Non è necessario installare, distribuire o eseguire software lato server.

Nozioni di base su MCP

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

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

MCP è un protocollo di comunicazione: uno standard aperto che qualsiasi applicazione può implementare per esporre i propri dati e azioni agli 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

Ogni strumento di intelligenza artificiale ha una configurazione leggermente diversa. Per gli strumenti comuni vengono forniti esempi di connessione.

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

Altri strumenti other-tools

Il server MCP Marketo è ospitato da Adobe ed esposto 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