Vai al contenuto
Panelia
Connettore MCP

Collega il tuo agente IA a Panelia

Avvia uno studio di mercato sintetico da Claude, Cursor o qualsiasi client compatibile MCP, e ottieni risultati calibrati senza uscire dalla conversazione. Nulla da installare: basta un URL.

Model Context Protocol è lo standard aperto che collega un assistente IA ai tuoi strumenti. Panelia si integra con un solo indirizzo, tramite un'autorizzazione che concedi — e revochi — dalla tua dashboard. Incluso in tutti i piani, a partire dal Gratuito.

Collegarsi

Il connettore è ospitato da Panelia. Non c'è alcun pacchetto da installare, nessun file da compilare, nessuna chiave da copiare: il tuo client MCP capisce da solo come autenticarsi.

Indirizzo del connettore
https://www.panelia.io/api/mcp
  1. 01

    Incollare l'indirizzo

    Aggiungi questo URL come server MCP remoto nel tuo client.

  2. 02

    Accedere

    Il client apre Panelia nel tuo browser. Accedi normalmente, come sul sito.

  3. 03

    Autorizzare

    Scegli l'organizzazione e i permessi concessi. Puoi toglierne qualcuno prima di confermare.

  4. 04

    Usarlo

    L'agente dispone degli strumenti. L'autorizzazione resta revocabile in qualsiasi momento da questa pagina.

Cosa sa fare il connettore

Ogni strumento viene eseguito dentro Panelia, con i tuoi diritti e le tue quote — esattamente come se agissi dall'interfaccia.

  • panelia_list_panelsLettura

    Elenca i mercati simulabili e gli archetipi di audience, con il dominio d'età reale di ciascun mercato.

  • panelia_create_studyScrittura

    Crea e avvia uno studio in una sola chiamata. Riserva crediti; accetta una chiave di idempotenza perché un nuovo tentativo non riavvii nulla.

  • panelia_list_studiesLettura

    Elenca gli studi dell'organizzazione, dal più recente al più vecchio, con lo stato dell'ultima esecuzione.

  • panelia_get_studyLettura

    Stato e avanzamento di uno studio. I risultati sono inclusi non appena l'esecuzione termina.

  • panelia_get_resultsLettura

    Aggregati dell'ultima esecuzione conclusa: distribuzione Likert, intervalli di confidenza, segmenti, driver e barriere, verbatim.

  • panelia_export_resultsLettura

    Export JSON integrale: la definizione dello studio e il suo report completo, per archiviazione o analisi a valle.

  • panelia_create_checkout_linkScrittura

    Genera un link di pagamento Stripe per ricaricare crediti o sottoscrivere un piano. Non addebita nulla di per sé.

Percorso tipico

Uno studio è asincrono: nulla attende il risultato in linea. L'agente avvia, poi interroga.

  1. panelia_list_panels — scegliere un mercato valido
  2. panelia_create_study — risposta immediata: identificativo, stato QUEUED, crediti riservati
  3. panelia_get_study — ripetere fino allo stato COMPLETED
  4. panelia_get_results — leggere gli aggregati, poi esportare se serve
panelia_create_study
{
  "title": "Sérum Vitamine C",
  "type": "PRODUCT",
  "market": {
    "country": "FR",
    "audience": "representative"
  },
  "panelSize": 500,
  "engine": "standard",
  "concepts": [
    {
      "label": "A",
      "title": "Sérum Vit. C 30 ml",
      "description": "Concentré 15 %, flacon verre ambré",
      "price": 24.9,
      "category": "cosmétique"
    }
  ],
  "idempotencyKey": "serum-vitc-2026-08"
}

Dichiarare il connettore

A seconda del client, l'indirizzo si dichiara in un file di configurazione o con un comando. In entrambi i casi non contiene alcun segreto.

Claude Desktop e Cursor

Aggiungi il connettore alla configurazione del tuo client.

claude_desktop_config.json
{
  "mcpServers": {
    "panelia": {
      "url": "https://www.panelia.io/api/mcp"
    }
  }
}

Claude Code

Basta un solo comando.

shell
claude mcp add --transport http panelia https://www.panelia.io/api/mcp

Cursor: stessa struttura JSON, in .cursor/mcp.json nella radice del progetto.

Scoperta automatica

Il tuo client interroga questi indirizzi per capire come autenticarsi. Normalmente non dovrai mai digitarli.

https://www.panelia.io/.well-known/oauth-protected-resourcehttps://www.panelia.io/.well-known/oauth-authorization-server

Che cosa autorizzi

Al momento della connessione scegli l'organizzazione e i permessi concessi. Ognuno è deselezionabile.

  • studies:read

    Leggere i tuoi studi, il loro stato e i loro risultati. Concesso per impostazione predefinita.

  • studies:write

    Creare e avviare studi. Consuma crediti.

  • billing:manage

    Generare un link di pagamento per ricaricare crediti o cambiare piano. Non addebita nulla di per sé.

Il tuo ruolo resta il limite

Un'autorizzazione non può mai concedere più di quanto il tuo ruolo già permetta. Un lettore che autorizza la scrittura non potrà comunque avviare studi: si applica l'intersezione dei due, mai l'uno o l'altro.

Multilingue: due lingue da non confondere

Lingua dell'interfaccia

Quella delle descrizioni degli strumenti e dei messaggi d'errore del connettore. Segue la lingua del tuo profilo Panelia: non c'è nulla da configurare lato client.

Lingua dello studio

Quella dei rispondenti sintetici. Discende dal mercato simulato, e solo da quello: i persona sono chiamati e rispondono nella lingua e nella cultura del loro mercato.

Mercati simulabili

FRDEESITGBUSCA_ENCA_FR

Archetipi di audience

representativemenwomenb2b

Sicurezza

  • Autorizzazione OAuth 2.1

    Il client non vede mai la tua password. Accedi su Panelia e il token emesso è legato a questo connettore e a nessun altro.

  • Nessun segreto da maneggiare

    Non c'è alcuna chiave da copiare né file da proteggere. Nulla di sensibile resta in un file di configurazione.

  • Revoca immediata

    Togliere un'autorizzazione interrompe l'accesso all'istante, senza attendere la scadenza di un token.

  • Un'organizzazione alla volta

    Un token vale per l'organizzazione scelta al consenso. Non ne apre nessun'altra, nemmeno una di cui fai parte.

  • Operazioni a pagamento

    Avviare uno studio consuma crediti. Gli strumenti interessati sono annotati perché il tuo client chieda conferma.

  • Quote del piano

    Il connettore applica esattamente gli stessi limiti dell'interfaccia: crediti, concept confrontati, studi detenuti. Non apre alcuna scorciatoia.

Uno studio di mercato, dal tuo agente IA

Descrivi un concept: l'agente avvia il panel e torna con una distribuzione calibrata dell'intenzione d'acquisto.