Collegare Siggmund al vostro assistente IA (MCP)

A cosa serve

L'MCP (Model Context Protocol) è uno standard che permette a un assistente IA, come Claude, di consultare un servizio esterno. Una volta collegato Siggmund, ponete le vostre domande al vostro assistente, che va a leggere le vostre misurazioni Siggmund per rispondere: a che punto siete, cosa è cambiato dalla settimana scorsa, chi vi precede.

Con una chiave dell'organizzazione (shg_) l'accesso è in sola lettura e limitato ai vostri dati (l'accesso con Google di claude.ai e ChatGPT, descritto più sotto, apre qualcosa in più). Il vostro assistente non può né modificare nulla presso Siggmund, né generare un rapporto, né vedere un altro cliente.

Due modi per collegare Siggmund

Senza chiave, con il vostro account Google: da claude.ai o ChatGPT. Aggiungete Siggmund come connettore e accedete con Google, senza copiare nulla. Qualsiasi membro di un'organizzazione può farlo, non solo gli amministratori.
Con una chiave: per Claude Code, Claude Desktop, Cursor e gli altri client che si configurano con un comando o un file (sezioni più sotto).

In claude.ai

In claude.ai aprite Settings (Impostazioni), poi Connectors (Connettori) e scegliete Add custom connector (Aggiungi connettore personalizzato). A seconda del vostro piano, questa opzione può essere riservata agli amministratori del vostro spazio Claude.
Date il nome «Siggmund» e l'indirizzo https://mcp.siggmund.com/mcp, poi confermate.
Fate clic su Connect (Connetti). Si apre una finestra Google: scegliete l'account Google il cui indirizzo e-mail è quello del vostro accesso a Siggmund, poi accettate. Siggmund chiede a Google soltanto il vostro indirizzo e-mail.
In una conversazione, attivate il connettore Siggmund, poi ponete la vostra domanda.

In ChatGPT

In ChatGPT aprite Settings (Impostazioni), poi Apps (o Connectors) e attivate la Developer mode (modalità sviluppatore) se ChatGPT la richiede per aggiungere un server MCP.
Create un connettore: nome «Siggmund», indirizzo del server MCP https://mcp.siggmund.com/mcp, autenticazione OAuth.
Salvate, poi accedete con il vostro account Google, come in claude.ai (passaggio 3 qui sopra).
In una conversazione, aggiungete Siggmund agli strumenti usati, poi ponete la vostra domanda.

Cosa sapere sull'accesso con Google

Il vostro accesso è quello del vostro indirizzo e-mail in Siggmund: ritrovate i clienti che vedete nell'applicazione. Un account Google con un altro indirizzo accede, ma non vede alcuno strumento Siggmund.
Cosa può fare l'assistente: leggere i vostri dati, produrre un rapporto o una presentazione e scrivere al nostro supporto. Vede solo i clienti del vostro accesso, mai quelli di un altro.
Un accesso revocato si interrompe dopo circa un minuto. Per scollegarvi da soli, eliminate il connettore in claude.ai o ChatGPT.

Prima di iniziare: creare una chiave

Questa sezione e le tre successive riguardano i collegamenti con una chiave (Claude Code, Claude Desktop, Cursor). Da claude.ai o ChatGPT non serve alcuna chiave: vedete sopra.

Gli amministratori dell'organizzazione possono creare una chiave. Se non avete dimestichezza con un terminale o un file di configurazione, passate questa guida alla persona che gestisce i vostri strumenti.

Aprite Connessioni nel menu, poi la sezione Accesso MCP.
Aprite la scheda Chiavi di accesso MCP e date un nome alla chiave, ad esempio «Claude di Marco».
Scegliete la sua durata: 1 giorno, 1 settimana, 1 mese, 1 anno o senza scadenza.
Cliccate su Crea la chiave e copiatela. Inizia con shg_.

La chiave viene mostrata una sola volta. Siggmund non ne conserva il valore: se la perdete, createne un'altra.

Cosa vi serve

L'indirizzo del server: https://mcp.siggmund.com/mcp (se avete configurato il vecchio indirizzo run.app, resta valido)
La vostra chiave, trasmessa in un header HTTP: Authorization: Bearer shg_…

Sostituite shg_… con la vostra chiave negli esempi qui sotto.

In Claude Code

In un terminale, lanciate:

Terminal

claude mcp add --transport http siggmund https://mcp.siggmund.com/mcp \
  --header "Authorization: Bearer shg_…"

Perché la connessione valga in tutti i vostri progetti, aggiungete --scope user prima dell'indirizzo. Altrimenti vale solo per la cartella corrente.

Verificate poi: claude mcp list deve mostrare siggmund con la dicitura «Connected». In Claude Code, il comando /mcp dà lo stesso stato. Un errore con codice 401 significa che la chiave è sbagliata, revocata o scaduta.

In Claude Desktop

Il menu Connettori di Claude Desktop non offre un campo per una chiave. Si collega quindi Siggmund tramite il file di configurazione, con il piccolo ponte mcp-remote. Richiede che Node.js sia installato.

In Claude Desktop, aprite Settings (Impostazioni), scheda Developer, poi cliccate su Edit Config. Si apre il file claude_desktop_config.json. Si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.
Aggiungete il blocco siggmund (conservate gli altri server, se ce ne sono):

JSON

{
  "mcpServers": {
    "siggmund": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.siggmund.com/mcp",
        "--header",
        "Authorization:${SIGGMUND_AUTH}"
      ],
      "env": {
        "SIGGMUND_AUTH": "Bearer shg_…"
      }
    }
  }
}

Salvate, poi chiudete completamente Claude Desktop e riavviatelo.
Nel campo di inserimento, aprite il menu Connettori: siggmund deve comparirvi con i suoi strumenti.

Lo spazio mancante dopo Authorization: è voluto: evita che Windows divida il valore in due. La chiave si trova nella voce env, non nella riga di comando.

In Cursor (o un altro client compatibile)

Cursor sa inviare direttamente un header, senza ponte. Nel file ~/.cursor/mcp.json (per tutti i vostri progetti) o .cursor/mcp.json (per un progetto):

JSON

{
  "mcpServers": {
    "siggmund": {
      "url": "https://mcp.siggmund.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SIGGMUND_KEY}"
      }
    }
  }
}

Definite la variabile d'ambiente SIGGMUND_KEY con la vostra chiave (senza la parola Bearer), poi riavviate Cursor.

Per qualsiasi altro client MCP: scegliete un server remoto con trasporto HTTP («Streamable HTTP»), indicate l'indirizzo qui sopra e aggiungete l'header Authorization: Bearer shg_….

Domande da porre

Il vostro assistente sceglie da solo lo strumento adatto. Ecco alcune domande che Siggmund sa trattare oggi e cosa leggerà l'assistente.

Chiedete	Cosa consulta l'assistente
«Su cosa vengo misurato?»	Le vostre linee di ricavo e i loro punti di ingresso
«Qual è il mio punteggio su ciascuno dei miei punti di ingresso, motore per motore?»	I vostri indicatori: tasso di citazione, preferenza, punteggio
«Chi mi precede su ChatGPT per questa linea di ricavo?»	La classifica dei vostri concorrenti per motore
«Cosa è cambiato dall'ultima misurazione?»	Il riepilogo della settimana: le vostre misurazioni, i concorrenti, i siti più o meno citati
«Quali siti citano le IA quando si parla del mio mercato?»	I siti e le pagine citati: i vostri, quelli dei concorrenti o di terzi
«A che punto ero il mese scorso?»	L'elenco delle vostre misurazioni passate, poi la misurazione della data richiesta
«Cosa rimproverano gli acquirenti ai miei prezzi?»	Le risposte delle IA e le opinioni di acquirenti simulati
«Come ha capito Siggmund la mia attività?»	La vostra scheda: mestiere, linee di ricavo, preoccupazioni di reputazione
«Cosa significa il punteggio di raccomandabilità?»	Le definizioni di Siggmund
«Cosa dice la ricerca sul modo in cui le IA scelgono le loro fonti?»	La biblioteca di studi sul GEO

Potete anche chiedere una tabella incrociata dei vostri numeri (ad esempio «ordina i miei punti di ingresso dal punteggio più basso al più alto»): l'assistente interroga allora direttamente i vostri dati.

Cosa l'MCP non fa con una chiave di questo tipo: produrre un rapporto o una presentazione, scrivere al nostro supporto, modificare il vostro account.

Sicurezza

La chiave viene mostrata una sola volta. Copiatela nel vostro strumento appena appare. Non è recuperabile né inviata via e-mail.
Non condividetela e non incollatela in un documento condiviso, in un'e-mail o in un repository di codice. Una chiave per persona o per strumento permette di interrompere un accesso senza disturbare gli altri.
Scegliete una durata breve se non vi serve un accesso permanente. Una chiave scaduta viene rifiutata alla chiamata successiva.
Revocatela in qualsiasi momento in Connessioni, sezione Accesso MCP, tramite il pulsante di revoca della chiave: l'accesso viene interrotto subito. Fatelo appena sospettate che sia trapelata.
La chiave dell'organizzazione (shg_) dà accesso solo alla vostra organizzazione, in sola lettura.

Se non funziona

401 o «Failed to connect»: la chiave è copiata male, revocata o scaduta. Verificate l'elenco in Connessioni e createne una nuova se necessario.
Il server non compare in Claude Desktop: Node.js è installato? Avete chiuso completamente l'applicazione prima di riavviarla? Il file di configurazione deve essere JSON valido (virgole, virgolette).
Prima chiamata lenta: il servizio può impiegare qualche secondo a risvegliarsi. Riprovate.
L'assistente non trova alcuno strumento Siggmund: verificate che il server sia attivato nelle impostazioni del vostro assistente e chiedetegli esplicitamente di usare Siggmund.
L'accesso con Google non riesce o scade (claude.ai, ChatGPT): il servizio può impiegare qualche secondo a svegliarsi e claude.ai rinuncia dopo circa 10 secondi. Riavviate il collegamento.
Connessi, ma nessuno strumento Siggmund: l'indirizzo dell'account Google non è quello del vostro accesso a Siggmund. Rimuovete il connettore, accedete di nuovo con l'indirizzo giusto, oppure chiedete a un amministratore di aggiungervi in Membri.

Ultimo aggiornamento: 13 novembre 2026 · Prima pubblicazione: 26 ottobre 2026