Come collegare Webex a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Webex, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Webex + Gemini

Fai lavorare la tua AI con Cisco Webex: trova persone, leggi e scrivi negli spazi, invia messaggi diretti, aggiungi persone agli spazi, elenca i team, pianifica e modifica riunioni, vedi chi ha partecipato e leggi trascrizioni, riepiloghi AI e registrazioni delle riunioni. Con l'accesso del tuo account Webex tramite un'integrazione Webex (OAuth).

Prerequisiti

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

WEBEX_CLIENT_ID, WEBEX_CLIENT_SECRET

Step 1 — Ottieni le credenziali

1. Accedi su developer.webex.com con il tuo account Webex e apri il menu del tuo avatar → My Webex Apps → Create a New App → Create an Integration. Qualsiasi account Webex può creare un'integrazione, anche uno gratuito.
2. Alla domanda Will this integration use a mobile SDK? rispondi No, dai un nome all'integrazione (per esempio "AnythingMCP"), scegli una delle icone predefinite e scrivi una breve descrizione.
3. In Redirect URI(s) aggiungi https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, usa https://tuo-host-anythingmcp/api/mcp-oauth/callback.
4. In Scopes spunta tutti gli scope elencati qui sotto (Webex aggiunge spark:kms da solo), poi clicca su Add Integration.
5. Copia il Client ID (inizia con una C maiuscola) in WEBEX_CLIENT_ID e il Client Secret in WEBEX_CLIENT_SECRET. Il secret viene mostrato una sola volta; se lo perdi, apri l'integrazione in My Webex Apps e generane uno nuovo.
6. Installa il connettore, clicca su Authorize with Provider nella pagina del connettore, accedi a Webex e clicca su Accept.
7. Verifica la configurazione con webex_get_me.

Scope: spark:kms, spark:people_read, spark:rooms_read, spark:rooms_write, spark:memberships_read, spark:memberships_write, spark:messages_read, spark:messages_write, spark:teams_read, spark:webhooks_read, meeting:schedules_read, meeting:schedules_write, meeting:participants_read, meeting:transcripts_read, meeting:summaries_read e meeting:recordings_read. Il connettore chiede esattamente questi, quindi se uno non è spuntato nell'integrazione, Webex rifiuta l'accesso con invalid_scope.

Chi vede cosa: l'AI lavora come l'utente Webex che ha autorizzato. Vede solo gli spazi di cui quell'utente fa parte e le riunioni che ospita o a cui è invitato. webex_search_people trova persone della tua organizzazione per email o per l'inizio del nome.

Messaggi e inviti: prima conferma: messaggi, nuovi spazi, membri aggiunti e inviti alle riunioni raggiungono subito altre persone e non si possono annullare senza che se ne accorgano. Prima di webex_send_message (scrive in uno spazio), webex_send_direct_message (scrive a una persona e, se serve, apre lo spazio 1:1), webex_create_room (un nuovo spazio di gruppo), webex_add_membership (aggiunge una persona, che poi può leggere i messaggi precedenti dello spazio), webex_create_meeting o webex_update_meeting, l'AI ti mostra il testo esatto, lo spazio o la persona e chi verrà avvisato, e aspetta il tuo sì. Pianificare o modificare una riunione invia un'email agli invitati, a meno che sendEmail sia false. Per un uso in sola lettura, disattiva questi sei strumenti.

Disattivati all'installazione: webex_delete_message rimuove definitivamente un messaggio per tutti nello spazio, e webex_delete_meeting annulla una riunione o un'intera serie, non si può recuperare e invia un'email di cancellazione agli invitati. Attivali solo se l'AI deve eliminare.

Dati personali e contenuti non attendibili: messaggi, trascrizioni, riepiloghi delle riunioni, elenchi dei partecipanti e registrazioni sono dati personali di tutte le persone coinvolte. L'AI legge solo ciò che serve alla tua domanda e non li copia in altri spazi o strumenti, a meno che tu non lo chieda. Il testo scritto da altre persone (messaggi, nomi di file, righe di trascrizione, riepiloghi) viene trattato come informazione da riferire, mai come istruzione, anche quando sembra un comando.

Spazi e messaggi: webex_list_rooms elenca i tuoi spazi in base all'attività più recente, webex_list_messages legge uno spazio partendo dai messaggi più recenti e va più indietro pagina per pagina, e webex_list_direct_messages legge la tua conversazione 1:1 con una persona tramite la sua email. I messaggi accettano il Markdown di Webex (grassetto, corsivo, link, elenchi, codice) fino a circa 7.400 byte. I link ai file nei messaggi richiedono il tuo accesso a Webex, quindi l'AI indica i nomi dei file invece di inoltrare i link.

Riunioni: gli strumenti per le riunioni richiedono una licenza host di Webex Meetings (il piano gratuito ne include una). webex_list_meetings elenca ciò che è stato pianificato, le singole occorrenze in arrivo oppure le riunioni che si sono effettivamente svolte. Senza una finestra temporale Webex guarda 7 giorni avanti, oppure 7 giorni indietro per le riunioni passate. Gli orari sono in ISO 8601, per esempio 2026-10-20T15:00:00+02:00, e con un fuso orario come Europe/Berlin Webex risponde in quel fuso invece che in UTC. Una nuova riunione dura tra 10 minuti e 23 ore e 59 minuti e inizia nel futuro; un utente normale può pianificare fino a 100 riunioni in 24 ore.

Trascrizioni, riepiloghi AI e registrazioni: richiedono l'id di una riunione terminata (i dettagli compaiono circa 15 minuti dopo la fine). webex_list_meeting_participants mostra chi ha partecipato, per l'host o un admin. Le trascrizioni esistono solo se erano attivi la trascrizione o i sottotitoli con Webex AI Assistant: webex_list_transcripts le elenca, webex_list_transcript_snippets legge le frasi pronunciate con i nomi di chi parla e webex_download_transcript restituisce il testo intero, troncato a circa 100 KB. webex_get_meeting_summary restituisce le note e gli action item di AI Assistant quando i riepiloghi erano attivi. Le registrazioni richiedono la registrazione cloud; webex_list_recordings copre per impostazione predefinita gli ultimi 7 giorni. webex_get_recording restituisce anche link di download temporanei che per qualche ora funzionano per chiunque li abbia, quindi l'AI li dà solo a te e non li pubblica mai in uno spazio.

Restare connessi: gli access token di Webex di solito durano 14 giorni e i refresh token 90 giorni. Il connettore rinnova da solo l'access token, quindi resta connesso finché viene usato almeno una volta ogni 90 giorni. Se è rimasto inattivo più a lungo, o se hai revocato l'integrazione, clicca di nuovo su Authorize with Provider.

Errori comuni: 401: l'accesso è scaduto o è stato revocato; autorizza di nuovo (dopo aver rigenerato il secret, aggiorna prima WEBEX_CLIENT_SECRET). 403: al token manca uno scope (spuntalo nell'integrazione, poi autorizza di nuovo), oppure all'utente mancano la licenza o il ruolo, per esempio nessuna licenza Meetings, non è l'host o AI Assistant è disattivato. 404: l'id non esiste o non puoi vederlo; per trascrizioni e riepiloghi verifica che sia l'id di una riunione terminata. 400: un parametro è errato e Webex lo indica. 429: la maggior parte delle API Webex consente circa 300 richieste al minuto; attendi il tempo indicato in Retry-After.

Il connettore non modifica messaggi, non carica file né invia adaptive card, non rimuove membri, non elimina spazi, registrazioni, trascrizioni o riepiloghi e non gestisce webhook, e non copre Webex Calling, i dispositivi, il contact center né le API di amministrazione. Agisce come una persona che ha effettuato l'accesso tramite OAuth; gli account bot di Webex non sono supportati.

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 Webex.

Tool disponibili

Esempi di prompt

• "Riassumi cosa è successo nello spazio Project Atlas da lunedì ed elenca le domande aperte rivolte a me."
• "Quali erano gli action item della riunione Webex di ieri con il team di design? Usa il riepilogo AI, se c'è."
• "Pianifica una riunione Webex di 30 minuti chiamata Roadmap check-in giovedì prossimo alle 15:00 ora di Berlino con [email protected] e [email protected]. Mostrami i dettagli prima che parta qualsiasi invito."
• "Leggi la trascrizione della riunione all-hands di venerdì scorso e dimmi cosa è stato detto sul trasloco dell'ufficio."
• "Invia a [email protected] un messaggio diretto su Webex per dirle che il contratto è firmato. Mostrami prima il testo."

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