Come collegare SAP Sales Cloud and Service Cloud (C4C) a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → SAP Sales Cloud and Service Cloud (C4C), inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

SAP Sales Cloud and Service Cloud (C4C) + Gemini

Lettura di SAP Sales Cloud e Service Cloud (Cloud for Customer, C4C) tramite la sua API OData: account, contatti, lead, opportunità, offerte di vendita, richieste di assistenza, prodotti e dipendenti, più tool OData generici per ogni altro entity set. Autenticazione Basic, sola lettura.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

SAP_C4C_HOST, SAP_C4C_USER, SAP_C4C_PASSWORD

Step 1 — Ottieni le credenziali

La configurazione richiede circa 10 minuti. Ti servono un tenant di SAP Sales Cloud o Service Cloud (Cloud for Customer, C4C) e un utente con autenticazione Basic, idealmente un utente tecnico di integrazione.

1. Consigliato: un utente tecnico di integrazione. In C4C vai su Administrator > Integration > Communication Systems e crea un sistema di comunicazione. Poi, in Communication Arrangements, creane uno con lo scenario OData Services for Business Objects e autenticazione User ID and Password, e seleziona i servizi OData (almeno c4codataapi). L'accordo mostra l'id utente; la password la imposti lì.
2. In alternativa, usa un utente business con autenticazione Basic i cui ruoli aziendali danno accesso in lettura ai work center che l'AI deve vedere.
3. Imposta SAP_C4C_HOST sull'host del tenant, ad esempio my123456.crm.ondemand.com, senza https:// né percorso, e compila SAP_C4C_USER e SAP_C4C_PASSWORD.
4. Installa il connettore ed esegui sap_c4c_list_accounts con top 1 per verificare l'accesso.

Sola lettura: il connettore legge l'API OData V2 standard del tenant, https://<tenant>.crm.ondemand.com/sap/c4c/odata/v1/c4codataapi, e non scrive mai. SAP controlla le autorizzazioni dell'utente a ogni chiamata, quindi l'AI vede solo ciò che consentono l'accordo di comunicazione o i ruoli aziendali dell'utente.

Cosa legge: gli account aziendali (clienti e prospect) con ruolo, stato, classificazione ABC, settore, responsabile, indirizzo principale, telefono ed e-mail; i referenti con il loro account; i lead con stato del ciclo di vita, livello di qualificazione, origine e responsabile; le opportunità con fase di vendita, stato, probabilità, valore atteso e data di chiusura prevista, per la pipeline commerciale; le offerte di vendita con importo netto e lordo, data di validità e l'opportunità a cui appartengono; le richieste di assistenza (ticket) con cliente, referente, stato, priorità, incaricato, categoria di servizio, scadenze e tempi SLA, per l'arretrato del servizio; i prodotti; e i dipendenti, per tradurre in nomi gli id di responsabili e incaricati. sap_c4c_guide spiega il flusso di lavoro e non costa chiamate API.

Ogni altro entity set: i tool OData generici raggiungono il resto del servizio. sap_c4c_list_services indica dove si trova il servizio, sap_c4c_describe_service elenca tutti gli entity set (una risposta grande, in cache per un giorno), sap_c4c_describe_entity mostra i campi con le loro etichette, sap_c4c_query legge le righe e sap_c4c_get_entity legge un record dal suo ObjectID.

Query: i filtri supportano eq, ne, ge, le, gt, lt, and, startswith ed endswith; or funziona solo su un campo. Le date si scrivono datetimeoffset'2026-01-01T00:00:00Z', e EntityLastChangedOn trova ciò che è cambiato da un certo momento. search è la ricerca full-text di SAP. I record hanno come chiave ObjectID; gli id di business come AccountID o ID sono campi separati. L'AI chiede con select solo i campi che le servono.

Limiti: al massimo 1000 righe per pagina (top, poi skip); le liste restituiscono il conteggio totale. expand è lento sui set grandi.

Errori comuni: 401 indica utente o password errati, oppure un utente bloccato. 403 significa che l'accordo di comunicazione o i ruoli aziendali dell'utente non coprono questo oggetto di business. Un 404 su ogni chiamata di solito indica un SAP_C4C_HOST errato. Un 400 indica un campo o un filtro che l'API non accetta; sap_c4c_describe_entity mostra i nomi di campo corretti.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di SAP Sales Cloud and Service Cloud (C4C).

Tool disponibili

Esempi di prompt

• "Mostrami le opportunità aperte con chiusura prevista in questo trimestre, con fase di vendita, probabilità e valore atteso."
• "Trova l'account Esempio Industrie S.p.A. ed elenca i suoi referenti e le sue richieste di assistenza aperte."
• "Quali richieste di assistenza ad alta priorità sono scadute, e chi le sta gestendo?"
• "Elenca i lead creati negli ultimi 7 giorni per origine e livello di qualificazione."
• "Quali offerte di vendita scadono questo mese, e a quali opportunità appartengono?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot