Come collegare SAGA al proprio assistente AI tramite MCP

Ultimo aggiornamento Circa un mese fa

Questa guida ti spiega come collegare il tuo spazio di lavoro SAGA ai principali fornitori di chat basate sull'intelligenza artificiale utilizzando il server SAGA MCP.

Passaggio 1: assicurati di disporre di un account SAGA

Effettuerai l'accesso tramite il browser durante il flusso OAuth.

Passaggio 2: Connettiti al tuo assistente AI

Scegli il tuo assistente tra quelli riportati di seguito e segui i passaggi indicati.

Claude Desktop / Claude Cowork

  1. Apri Claude Desktop

  2. Fai clic su Personalizza nella barra laterale sinistra

  3. Vai su Connettori → clicca su + Aggiungi connettore personalizzato

  4. Incolla l'URL:

    https://mcp.thesaga.app/mcp

  5. Fai clic su "Aggiungi"

  6. Si aprirà il browser, che ti chiederà di effettuare l'accesso a SAGA e di autorizzare la connessione

  7. Accedi → clicca su Consenti → il gioco è fatto

Gli strumenti SAGA disponibili appariranno automaticamente in Claude.

Se preferisci, puoi seguire questo video tutorial guidato

ChatGPT

  1. Vai su Impostazioni → Plugin → Modalità sviluppatore

  2. Attiva la modalità sviluppatore (pulsante a levetta)

  3. Torna a Plugin → Sfoglia plugin → Clicca sul “+”

  4. Inserisci un nome (ad es. "SAGA")

  5. Incolla l’URL:

    https://mcp.thesaga.app/mcp

  6. In Autenticazione, seleziona OAuth

  7. Fai clic su Crea

  8. Il browser ti chiederà di effettuare l'accesso a SAGA → clicca su Consenti

  9. In una nuova chat, clicca sull'icona + accanto alla barra dei messaggi → seleziona la tua app SAGA

Cursore

  1. Apri Cursor

  2. Vai su Impostazioni → Server MCP

  3. Fai clic su + Aggiungi nuovo server MCP

  4. Inserisci:

    • Nome: saga

    • Tipo: Streamable HTTP

    • URL: https://mcp.thesaga.app/mcp

  5. Fai clic su Aggiungi

  6. Si aprirà il browser → accedi a SAGA → autorizza

Claude Code (terminale)

claude mcp add saga --transport http https://mcp.thesaga.app/mcp

Si aprirà il browser per l'accesso tramite OAuth. Una volta autorizzato, esegui claude mcp list per verificare che sia connesso.

VS Code (GitHub Copilot)

Crea un file denominato ".vscode/mcp.json" nel tuo progetto:

{ "servers": { "saga": { "type": "http", "url": "https://mcp.thesaga.app/mcp" } } }

Riavvia VS Code. La prima volta che Copilot tenterà di utilizzare SAGA, si aprirà il browser per l'accesso tramite OAuth.

Gemini CLI

gemini mcp add saga -- https://mcp.thesaga.app/mcp

Passaggio 3: Inizia a utilizzarlo

Una volta connesso, basta chiedere alla tua IA di eseguire un'operazione con SAGA. Ad esempio:

  • "Mostrami i miei lead recenti in SAGA"

  • "Crea un lead magnet chiamato 'Guida PDF gratuita'"

  • "Quali sono le statistiche della mia pipeline di contatti?"

  • "Aggiungi un'attività di follow-up per John in SAGA"

Carica un file dal browser (agente IA)

Quando il tuo assistente IA (Fibi o un altro agente collegato a SAGA) ha bisogno di un file dal tuo dispositivo, ti invia un link di caricamento nella conversazione.

Passaggi

  1. Clicca il link di caricamento mentre sei connesso a SAGA nello stesso browser.

  2. Nella pagina di caricamento, clicca per scegliere un file.

  3. Attendi Caricamento completato.

  4. Torna alla conversazione con l'agente — l'assistente può ora usare il file.

File supportati

  • PDF

  • Immagini (JPEG, PNG, WebP)

  • Documenti Word

Risoluzione problemi di caricamento

Problema

Cosa fare

"Missing session id"

Il link è scaduto o copiato in modo incompleto. Chiedi all'agente un nuovo link di caricamento.

Caricamento non riuscito

Tocca Riprova o richiedi un nuovo link all'agente.

Non connesso

Accedi prima a SAGA, poi riapri il link.

I link di caricamento sono link di sessione monouso. Non condividerli pubblicamente.

Risoluzione dei problemi

Problema Soluzione

Il browser non si apre per effettuare l'accesso

Verifica che il tuo client AI supporti OAuth per i server MCP remoti

"401 Non autorizzato"

La sessione OAuth potrebbe essere scaduta: rimuovi e aggiungi nuovamente la connessione

Gli strumenti non vengono visualizzati

Riavvia completamente l'app dopo aver aggiunto la connessione

"Trasporto non supportato"

Assicurati di utilizzare Streamable HTTP o SSE, non stdio

Una connessione, un accesso OAuth e il tuo spazio di lavoro SAGA funziona su qualsiasi assistente AI che supporti MCP.