Server MCP

Permetti a client AI come Claude, ChatGPT o Cursor di fare domande all'assistente del tuo sito.

Ogni sito Webble è raggiungibile anche come server MCP. Un client MCP (Claude, ChatGPT, Cursor, un tuo agente) fa una domanda e riceve la stessa risposta che darebbe il widget a un visitatore, scritta a partire dai contenuti del sito.

Attivalo

MCP è spento di default. Apri il sito nella dashboard, premi MCP e attiva il server. Il pannello mostra l'endpoint:

https://webble.it/api/mcp

Spegnere MCP interrompe subito tutte le connessioni a quel sito, comunque siano state create.

Collega un client

Una connessione copre uno o più dei tuoi siti. Ci sono due modi per crearla.

Accedi con OAuth

Ai client che supportano OAuth (Claude Code, Claude Desktop, ChatGPT, Cursor) basta l'endpoint:

claude mcp add --transport http webble https://webble.it/api/mcp

Il client apre il browser: accedi a Webble, scegli i siti da collegare e conferma. Si possono scegliere solo i siti con MCP attivo.

Usa un API token

Per i tuoi agenti e script, invia un API token come bearer token. La connessione copre i siti coperti dal token, quindi non c'è niente da scegliere:

claude mcp add --transport http webble https://webble.it/api/mcp \
  --header "Authorization: Bearer $WEBBLE_API_TOKEN"

I tool

list_sites elenca i siti a cui la connessione può fare domande, ciascuno con il valore site da passare ad ask. I siti con MCP spento non compaiono.

ask fa una domanda all'assistente di un sito.

Argomento	Obbligatorio	Significato
`question`	sì	La domanda per l'assistente.
`site`	se la connessione copre più siti	Il sito a cui chiedere: il valore `site` o l'host da `list_sites`, ad esempio `dkr.srl`.
`conversationId`	no	Continua una conversazione precedente, sul suo sito. Omettilo per iniziarne una nuova.
`language`	no	Lingua della domanda, ad esempio `it` o `en`.
`timezone`	no	Fuso orario IANA di chi chiede, ad esempio `Europe/Rome`.

Restituisce la risposta dell'assistente (answer), il sito che ha risposto (site) e un conversationId. Passa il conversationId con la domanda successiva per continuare la conversazione. Una conversazione può essere continuata solo dalla connessione che l'ha iniziata, e solo finché il sito resta nella modalità (test o live) in cui è iniziata.

Consumi e conversazioni

Quando il sito è live, le risposte via MCP contano nelle interazioni del piano come quelle del widget. La dashboard mostra quante arrivano da ciascuna sorgente, e le conversazioni MCP hanno il badge MCP nell'elenco. Quando il sito raggiunge la soglia di interazioni, ask restituisce un errore fino al periodo successivo.