Vai al contenuto principale

Collega Socialinsider al tuo assistente AI (Guida rapida alla configurazione)

Guida rapida per integrare i dati Socialinsider nelle chat AI.

Scritto da Diana Gogolan

Questa guida ti mostra come collegare il server Socialinsider MCP a Claude e ChatGPT per importare gli analytics Socialinsider in tempo reale nelle tue conversazioni AI, senza installare nulla sul tuo dispositivo.

✅ Cosa ti serve:

  • Un account Socialinsider attivo (disponibile su tutti i piani)

Il server Socialinsider MCP è già attivo qui:

💡 Funziona con qualsiasi tool compatibile MCP - Socialinsider MCP funziona con Claude, ChatGPT e qualsiasi altro AI assistant o tool che supporta il Model Context Protocol. Se il tuo tool supporta MCP, incolla l’URL del server qui sopra e segui lo stesso flusso OAuth.

Quando aggiungi quell'URL a un client supportato, ti verrà chiesto di accedere tramite un flusso OAuth 2.0 sicuro. Nessuna API key, token o variabile di ambiente richiesta.


Come funziona l’autenticazione

La prima volta che usi Socialinsider nel tuo AI assistant, l’app farà quanto segue:

  1. Apre una finestra di login Socialinsider nel tuo browser

  2. Ti chiede di approvare l’accesso

  3. Ti riporta all’app con la connessione pronta

Se rimani bloccato in un loop di richieste di login, vai su Risoluzione dei problemi.


Collega a Claude

Opzione 1 - Web

Questa è l’opzione più semplice.

  1. Clicca su Customize (dalla barra di navigazione)

3. Vai su 'Connectors'

4. Clicca sull'icona 'più' - 'add custom connector'

6. Clicca su 'Connect'

7. Accedi al tuo account Socialinsider nella finestra del browser che si apre, poi approva l'accesso. Verrai reindirizzato su Claude automaticamente quando la connessione è completata.

8. Controlla se ora Socialinsider compare nella sezione 'Connectors'

Ora puoi iniziare una nuova conversazione e provarlo 👇

"Mostrami l'Engagement Rate del nostro profilo Instagram nel progetto ‘Automotive’ negli ultimi 30 giorni."

Opzione 2 - Claude Desktop

Claude Desktop supporta i server MCP remoti.

  1. Trova il tuo file di configurazione:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\\\\Claude\\\\claude_desktop_config.json

2. Aggiungi questo blocco (crea il file se non esiste):

{
"mcpServers": {
"socialinsider": {
"type": "http",
"url": "https://mcp.socialinsider.io/mcp"
}
}
}

3. Salva il file e riavvia Claude Desktop

4. Al primo utilizzo, completa il login OAuth di Socialinsider nella finestra del browser

Verifica la connessione (opzionale): se Claude Desktop mostra gli strumenti Socialinsider, hai finito.

💡Nota: Se gli strumenti non compaiono, assicurati di avere una versione recente di Claude Desktop (vedi le note di rilascio).

Opzione 3 - Claude Code (CLI)

Se usi Claude Code nel terminale:

claude mcp add socialinsider https://mcp.socialinsider.io/mcp

Al primo utilizzo, Claude Code apre una finestra del browser per il login OAuth. Dopo l’autorizzazione, gli strumenti saranno disponibili in quel progetto.

Per verificare la connessione:

claude mcp list


Collega a ChatGPT

1. Apri ChatGPT. Puoi usare il browser senza problemi. Non serve l’app per macOS o Windows.

2. Vai su impostazioni account tramite la piccola icona in basso a sinistra.

3. Vai su App

4. Clicca su ‘Impostazioni avanzate’

5. Assicurati di abilitare la ‘Modalità sviluppatore’

6. Clicca su ‘Crea app’

7. Compila i campi come segue:

Assicurati di selezionare l’ultima casella e clicca su ‘Crea’.

Da lì, ti verrà chiesto di collegarti al tuo account Socialinsider. Usa le tue credenziali per accedere.

Dopo, vedrai Socialinsider nella sezione App.

Per verificare la connessione, avvia una nuova chat e clicca sull’icona ‘+’Altro. Dovresti vedere Socialinsider collegato a ChatGPT e puoi cliccarci sopra.

Poi inizia a chattare e fai domande sui tuoi progetti Socialinsider.


Esempi prompt

Usa un linguaggio naturale: indica solo progetto, profilo e periodo.

👉 Analisi competitiva

“Confronta l’Engagement Rate di @netflix e @disneyplus su Instagram per Q1 2025 e dimmi quale ha generato più interazioni per post.”

👉 Audit profilo proprietario

“Recupera gli ultimi 30 giorni di analytics del profilo della nostra pagina Facebook nel progetto ‘Acme Corp’ e sintetizza l’andamento della crescita dei follower.”

👉 Top contenuti

“Recupera gli ultimi 50 post dal nostro account Instagram nel progetto ‘Brand’ per marzo 2025 e ordinali per Engagement Rate.”

👉 Benchmark multipiattaforma

“Confronta la media delle visualizzazioni per video dei canali YouTube nel progetto ‘Competitors’ negli ultimi 90 giorni.”

👉 Performance campagna

"Mostrami i post taggati con la campagna ‘Summer24’ nel progetto ‘Marketing’ su Instagram tra giugno e agosto 2024."


Strumenti disponibili

Dopo la connessione, il tuo assistente può usare questi strumenti Socialinsider:

Strumento

Cosa fa

socialinsider_get_profiles

Elenca i profili tracciati (opzionalmente filtrati per progetto)

socialinsider_profile_search

Cerca un profilo tramite URL o handle

socialinsider_add_profile

Inizia il tracking di un nuovo profilo (tuo o concorrente)

socialinsider_delete_profile

Rimuove un profilo tracciato e i suoi dati storici

socialinsider_get_posts

Recupera post con metriche per post (supporta paginazione + campagne)

socialinsider_get_profile_data

Restituisce analytics giornalieri (followers, engagement, reach, impressions)

socialinsider_get_instagram_stories

Recupera Instagram Stories (solo per account aziendali propri/autorizzati)

socialinsider_get_brands

Elenca i gruppi brand all’interno di un progetto.

socialinsider_get_campaigns

Elenca i tag campagna disponibili in un progetto.


Risoluzione problemi

"Non autorizzato" o richieste di accesso ripetute

  • Completa il flusso OAuth nella finestra del browser che si apre (non chiuderla prima del tempo)

  • Rimuovi il server e aggiungilo di nuovo per forzare un nuovo accesso

  • Controlla che l’URL sia esattamente: https://mcp.socialinsider.io/mcp

Errori limite di richiesta (429)

  • Il messaggio di errore indica quanto tempo attendere prima di riprovare

  • Riduci l’intervallo di date o il numero di profili nella richiesta

Risposta troncata

  • Se la risposta è molto lunga, usa la paginazione (from / size) per ottenere gruppi più piccoli

Timezone non valida

  • Usa un formato timezone IANA come UTC, America/New_York, Europe/London, Asia/Tokyo

Hai ricevuto la risposta alla tua domanda?