Salta ai contenuti
Screeb Help CenterCentro assistenza
Apri Screeb

Collega un assistente IA al server MCP di Screeb

Lascia che Claude, ChatGPT, Cursor o un altro client MCP legga i tuoi dati Screeb e risponda alle tue domande, dopo l'accesso e la scelta di un'organizzazione.

Guida4 min di lettura, aggiornato il 15 ott 2026

Questa pagina è stata tradotta automaticamente. La versione inglese fa fede.

Il server MCP di Screeb permette a un assistente IA come Claude, ChatGPT o Cursor di leggere i tuoi dati Screeb e rispondere a domande come “Di cosa si lamentano gli utenti nel mio sondaggio NPS questo mese?”. Accedi con il tuo account Screeb e scegli l’organizzazione che l’assistente può leggere.

  • Il tuo account Screeb è membro dell’organizzazione che vuoi collegare.
  • Il tuo assistente IA o il tuo editor di codice supporta i server MCP remoti con accesso OAuth, come Claude, ChatGPT, Cursor, Claude Code o Visual Studio Code. Un client che accetta solo un token API fisso non può collegarsi.
  • L’accesso è in sola lettura: l’assistente non può modificare nulla in Screeb.
  1. Apri la tua organizzazione, clicca su Impostazioni nella barra laterale, poi, sotto IA, clicca su Generale. Le impostazioni dell’organizzazione sono visibili solo agli amministratori: se sei un membro, apri direttamente la pagina delle impostazioni generali dell’IA.
  2. Nella sezione Server MCP, copia l’indirizzo.
Le impostazioni generali dell'IA di un'organizzazione, con la sezione del server MCP e il suo indirizzo pronto da copiare

La maggior parte degli account usa https://mcp.screeb.app/mcp. Gli account su un ambiente Screeb dedicato hanno un proprio indirizzo, quindi copia sempre quello mostrato dal tuo amministratore.

  1. Apri le impostazioni dei connettori o di MCP del tuo assistente. In Claude si trova in Settings, poi Connectors, poi Add custom connector.
  2. Inserisci un nome, per esempio Screeb, e l’indirizzo del server. Non serve alcun token né chiave API.
  3. Salva, poi collegati. L’assistente apre una finestra di accesso a Screeb.

In un editor di codice o in uno strumento da riga di comando, aggiungi il server alla sua configurazione MCP. Per Claude Code:

Finestra del terminale
claude mcp add --transport http screeb https://mcp.screeb.app/mcp

Per Cursor, in .cursor/mcp.json:

{
"mcpServers": {
"screeb": { "url": "https://mcp.screeb.app/mcp" }
}
}
  1. Accedi con il tuo account Screeb, se non l’hai già fatto.
  2. Nella schermata di consenso, scegli un’organizzazione in Organizzazione. L’accesso richiesto è “Lettura dei tuoi workspace e dei dati dei sondaggi”.
  3. Clicca su Consenti. Torni al tuo assistente, ora collegato.
La schermata di consenso di Screeb, con la scelta dell'organizzazione, l'accesso in lettura richiesto e il pulsante Consenti

L’assistente può leggere una sola organizzazione, e solo i Workspace a cui il tuo account ha accesso al suo interno. Per collegarlo a un’altra organizzazione, accedi di nuovo dall’assistente e scegli quella.

Il server mette a disposizione del tuo assistente tre strumenti in sola lettura. Li sceglie da solo mentre fai domande.

Strumento Cosa fa
list_workspaces Elenca i Workspace dell’organizzazione a cui hai accesso.
search_surveys Trova sondaggi e messaggi per nome o tag, con il loro stato, il numero di risposte e le domande.
ask_screeb_ai Pone a Screeb AI una domanda sui tuoi dati: risposte e punteggi, segmenti, eventi, sessioni e messaggi.

Quando l’organizzazione ha un solo Workspace, l’assistente usa quello. Se ce ne sono diversi, indicane uno nella domanda (“nel Workspace Marketing”), scrivi “in tutti i Workspace”, oppure rispondi quando l’assistente ti chiede di sceglierne uno. Le domande successive nella stessa conversazione mantengono il contesto di quelle precedenti.

  1. Clicca sul tuo nome in fondo alla barra laterale, poi su Account.
  2. In Applicazioni connesse, trova l’assistente e l’organizzazione che può leggere.
  3. Clicca su Revoca. L’assistente perde l’accesso entro un’ora al massimo e deve rifare l’accesso per ricollegarsi.
La sezione Applicazioni collegate delle impostazioni dell'account, con un assistente, la sua organizzazione e un pulsante Revoca

L’accesso viene concesso per organizzazione: revocarne una lascia collegate le altre.

Il tuo assistente risponde con cifre e sintesi calcolate a partire dai tuoi dati Screeb, senza esportazioni né dashboard. Ogni assistente che colleghi compare nelle impostazioni del tuo account, dove puoi rimuoverlo in qualsiasi momento.

L’assistente non riesce a collegarsi. Confronta l’indirizzo con quello della sezione Server MCP del tuo admin e verifica che il tuo assistente supporti l’accesso OAuth per i server MCP remoti.

La schermata di consenso mostra “Autorizzazione non riuscita”. La richiesta di accesso scade dopo 10 minuti. Riavvia la connessione dal tuo assistente.

La tua organizzazione non è nell’elenco. Il tuo account non ne è membro. Chiedi a un amministratore di quell’organizzazione di invitarti.

L’assistente ti chiede quale Workspace usare. Indica il Workspace nella tua domanda, oppure scrivi “in tutti i Workspace”.

L’assistente ti chiede di accedere di nuovo. Di solito succede dopo diverse settimane senza utilizzo, o dopo una revoca. Rifai l’accesso e il consenso.