Installazione di Adobe CX Customer Gateway mcp-install

Leggere questa guida per scoprire come collegare un client compatibile con MCP a Adobe CX Customer Gateway. Il gateway di lavoro CX utilizza un unico endpoint per tutti gli strumenti documentati:

https://cx-coworker-gateway.adobe.io/mcp

Prima di eseguire l’installazione, verifica che l’organizzazione e l’account utente possano accedere agli strumenti di prodotto necessari. Vedere Accedere agli strumenti di Gateway aziendale CX.

Come funziona l’installazione mcp-install-how

Il gateway di lavoro CX utilizza un trasporto HTTP remoto con un flusso di accesso Adobe basato su browser. In ogni client supportato, il modello di configurazione è lo stesso:

Installazione Enterprise (gestita dall’amministratore) mcp-install-enterprise

La maggior parte dei piani client MCP del team e dell’organizzazione richiede che un amministratore aggiunga connettori personalizzati per l’organizzazione. In questi ambienti, l’installazione prevede due passaggi:

Passaggio 1: un amministratore aggiunge l’endpoint mcp-install-enterprise-admin

L’amministratore aggiunge https://cx-coworker-gateway.adobe.io/mcp come connettore personalizzato o server MCP remoto nelle impostazioni dell’organizzazione del client. La posizione esatta dipende dal client.

Claude Team ed Enterprise mcp-install-enterprise-claude

Nei piani Team ed Enterprise di Claude, i connettori a livello di organizzazione sono gestiti da un’area di lavoro Proprietario o Proprietario principale.

Team e organizzazione ChatGPT mcp-install-enterprise-chatgpt

Nelle aree di lavoro Team ed Enterprise di ChatGPT, i connettori vengono aggiunti da un amministratore dell’area di lavoro.

Altri client gestiti dall’organizzazione mcp-install-enterprise-other

Per altri client che supportano i connettori remoti gestiti dall’organizzazione, aggiungere il gateway di lavoro CX come server MCP HTTP remoto utilizzando https://cx-coworker-gateway.adobe.io/mcp. Lascia vuote le intestazioni facoltative, i campi del token Bearer, i campi dell’ID client e i campi del segreto client, a meno che il client non richieda un valore segnaposto.

Passaggio 2: gli utenti abilitano il connettore mcp-install-enterprise-user

Dopo che un amministratore ha aggiunto il gateway di lavoro CX, ogni utente lo abilita per il proprio account:

Gli utenti non devono immettere l’URL personalmente quando un amministratore ha già aggiunto il connettore per l’organizzazione.

Installazione singola (self-service) mcp-install-individual

Se utilizzi un piano individuale, un client sviluppatore configurato localmente o un’organizzazione che consente ai membri di aggiungere i propri connettori, aggiungi l’endpoint direttamente nelle impostazioni client.

Claude individual mcp-install-individual-claude

Per il desktop claude.ai e Claude su un piano individuale:

Individuo ChatGPT mcp-install-individual-chatgpt

Cursore mcp-install-individual-cursor

Dopo la connessione, gli strumenti Adobe per CX Customer Gateway sono disponibili in modalità Compositore cursore e Agente.

Claude Code mcp-install-individual-claude-code

Aggiungi l’endpoint dal terminale:

claude mcp add --transport http cx-enterprise https://cx-coworker-gateway.adobe.io/mcp

Quindi avviare Claude Code ed eseguire:

/mcp

Seleziona il server cx-enterprise e completa il flusso di accesso di Adobe nel browser.

Codice mcp-install-individual-codex

Aggiungi l’endpoint dal terminale:

codex mcp add cx-enterprise --url https://cx-coworker-gateway.adobe.io/mcp

Autentica:

codex mcp login cx-enterprise

Verifica la configurazione:

codex mcp list

È inoltre possibile aggiungere l’endpoint direttamente a ~/.codex/config.toml:

[mcp_servers.cx-enterprise]
url = "https://cx-coworker-gateway.adobe.io/mcp"

Configurazione JSON generale mcp-install-individual-json

Per i client che accettano una configurazione del server MCP basata su JSON, utilizza uno dei seguenti formati a seconda che il client supporti HTTP remoto nativo o richieda un bridge locale.

Tramite mcp-remote ponte

{
  "mcpServers": {
    "cx-enterprise": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://cx-coworker-gateway.adobe.io/mcp"
      ]
    }
  }
}

HTTP remoto nativo

{
  "mcpServers": {
    "cx-enterprise": {
      "url": "https://cx-coworker-gateway.adobe.io/mcp",
      "transport": "http"
    }
  }
}

Altri clienti mcp-install-individual-other

Per altri client desktop o Web con supporto MCP remoto, aggiungere Adobe for CX Customer Gateway come server HTTP remoto utilizzando https://cx-coworker-gateway.adobe.io/mcp. Lascia vuote le intestazioni facoltative, i campi del token Bearer, i campi dell’ID client e i campi del segreto client, a meno che il client non richieda un valore segnaposto.

Contesto del prodotto per le chiamate allo strumento mcp-connect-params

MCP rivolge ogni chiamata allo strumento a un’organizzazione Adobe attiva. Inoltre, i requisiti di contesto dipendono dal prodotto:

Imposta il contesto una sola volta all’inizio di una sessione: i singoli strumenti di prodotto non cambiano organizzazioni, sandbox o visualizzazioni dati a metà sessione. Consulta Strumenti di contesto sessione per gli strumenti che impostano il contesto dell’organizzazione, della sandbox e della visualizzazione dati.

Esempio:

“Utilizzare l’organizzazione 1234ABCD@AdobeOrg, la sandbox prod e la visualizzazione dati My Company — Global per questa sessione.”

Se non conosci i valori richiesti, chiedi al client MCP di elencare le organizzazioni, le sandbox o le visualizzazioni dati disponibili per le tue credenziali Adobe.