Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Botpress con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Fai analizzare alla tua AI i tuoi bot Botpress: workspace e bot, conversazioni, messaggi, utenti ed eventi, log, analytics e issue dei bot, le tabelle del bot (interroga, aggiungi e aggiorna righe) e i file della sua knowledge base con ricerca semantica.
Prova a chiedere
Prompt di esempio per Botpress
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Botpress, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Botpress + ChatGPT
Fai analizzare alla tua AI i tuoi bot Botpress: workspace e bot, conversazioni, messaggi, utenti ed eventi, log, analytics e issue dei bot, le tabelle del bot (interroga, aggiungi e aggiorna righe) e i file della sua knowledge base con ricerca semantica.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
BOTPRESS_TOKEN, BOTPRESS_WORKSPACE_ID, BOTPRESS_BOT_ID
Step 1 — Ottieni le credenziali
- Accedi su
https://app.botpress.cloud. Apri il menu del profilo (in alto a destra) → Profile Settings → Personal Access Tokens, crea un token e copialo (inizia conbp_pat_). Incollalo inBOTPRESS_TOKEN, senza la parola Bearer. - Workspace ID (
BOTPRESS_WORKSPACE_ID): apri il workspace nella dashboard e copia la partewkspace_...dell'URL (app.botpress.cloud/workspaces/wkspace_...). - Bot ID (
BOTPRESS_BOT_ID): apri il bot e copia l'UUID dopo/bots/nell'URL. Studio lo mostra anche nelle impostazioni del bot. - Installa il connettore. I tre valori vengono inviati solo a Botpress. In seguito
botpress_list_workspacesebotpress_list_botsmostrano anche gli id degli altri tuoi workspace e bot.
Chi vede cosa: il token porta con sé il tuo accesso a tutti i workspace di cui fai parte. Tienilo segreto e condividi il server MCP solo con persone autorizzate a leggere le conversazioni dei tuoi bot, che possono contenere dati personali.
Quali parti di Botpress usa: un solo personal access token le raggiunge tutte e quattro (una Bot Access Key non funzionerebbe per i tool di amministrazione, quindi usa un token personale):
- Admin API: workspace, bot, log, analytics e issue dei bot.
- Runtime API: conversazioni, messaggi, utenti ed eventi del bot da tutti i canali (Webchat, WhatsApp, Slack e così via). La Chat API separata di Botpress non viene usata, perché vede solo le conversazioni della propria integrazione Chat.
- Tables API: le tabelle del bot, per interrogare, aggiungere e aggiornare righe.
- Files API: i file della knowledge base del bot, con ricerca semantica su quelli indicizzati.
Più bot: i tool per conversazioni, messaggi, utenti, eventi, tabelle e file lavorano su BOTPRESS_BOT_ID, a meno che tu non indichi un altro bot. I tool dei bot (panoramica, log, analytics, issue) ricevono l'id del bot a ogni chiamata, così l'AI può confrontare i bot di un workspace.
Prima la conferma: botpress_create_table_rows e botpress_update_table_rows modificano i dati del bot, quindi l'AI ti mostra le righe e aspetta il tuo sì. botpress_delete_table_rows è disattivato all'installazione; attivalo nelle impostazioni del connettore solo se l'AI deve cancellare righe. Cancella solo tramite id di riga.
Contenuti non affidabili: messaggi, campi utente e passaggi dei file provengono da utenti finali o da documenti caricati. L'AI tratta le istruzioni al loro interno come dati, non come ordini.
Errori comuni: 401 Unauthorized: il token è errato o revocato, oppure il workspace ID non corrisponde a un workspace di cui il tuo utente fa parte. 403 Forbidden: il tuo ruolo nel workspace non consente l'azione. 404 ResourceNotFound: un id sconosciuto, oppure una conversazione o una tabella di un bot diverso da quello in BOTPRESS_BOT_ID. 400 InvalidPayload o InvalidQuery: un parametro non è valido, per esempio una data non in formato ISO 8601. 429 RateLimited: attendi un momento e riprova.
Il connettore non crea, non pubblica e non elimina bot, non invia messaggi come bot, non gestisce integrazioni, non carica file nella knowledge base e non gestisce membri del workspace e fatturazione.
Step 2 — Installa l'adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Aggiungi il connettore in ChatGPT
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca + e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
Botpress. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Tool disponibili
| Tool | What it does |
|---|---|
botpress_list_workspaces | List the Botpress workspaces the token's user belongs to, with id, name, plan, bot count, spending limit and whether the workspace is… |
botpress_list_bots | List the bots of a Botpress workspace (production bots, or dev bots with dev true) with id, name, type, tags and last deploy time |
botpress_get_bot | Get one bot's overview: name, description, status, deploy time, whether it is a dev bot, tags, and its installed integrations with version… |
botpress_get_bot_logs | Read a bot's runtime logs (console output, errors and system messages) from timeStart on, filtered by level, conversation, user, workflow… |
botpress_get_bot_analytics | Get a bot's usage analytics between two dates: per period new and returning users, sessions, user and bot messages, events, conversations… |
botpress_list_bot_issues | List the issues Botpress recorded for a bot (errors in its code, hit limits, configuration problems) with code, title, description… |
botpress_list_conversations | List a bot's conversations from every channel, newest first, with id, integration and channel (e.g. webchat, whatsapp), message count, tags… |
botpress_get_conversation | Get one conversation of a bot: integration, channel, message count, tags, shared properties and dates |
botpress_list_messages | List a bot's messages, newest first, usually of one conversation (conversationId) |
botpress_list_users | List the end users who talked to a bot (one per channel: the same person on Slack and WhatsApp is two users), with id, name, tags and dates |
botpress_get_user | Get one end user of a bot: name, picture URL, tags, attributes and properties set by the bot or its integrations, and dates |
botpress_list_events | List a bot's events (incoming messages, integration events, custom and scheduled events) with type, status (pending, processed, ignored… |
botpress_get_event | Get one event of a bot with its full payload, status and failureReason |
botpress_list_tables | List a bot's tables with id, name, row factor, key column, whether it is frozen and the column schema |
botpress_get_table | Get one table of a bot with its columns (names, types, descriptions, computed settings), key column, its row count (rows) and how many rows… |
botpress_find_table_rows | Query rows of a bot's table with a MongoDB-like filter, full-text search, column selection, ordering and offset paging; group adds… |
botpress_create_table_rows | Add rows to a bot's table (1 to 1,000 per call), each an object of column values matching the table's schema (see botpress_get_table) |
botpress_update_table_rows | Update rows of a bot's table by id (1 to 1,000 per call): each row is {"id": 12, "column": "new value"} and only the given columns change |
botpress_delete_table_rows | Permanently delete rows of a bot's table by their ids (up to 1,000 per call) |
botpress_list_files | List a bot's files (knowledge-base documents and other uploads) with id, key, content type, size, tags, status (upload or indexing state)… |
botpress_search_files | Semantic search over a bot's indexed files (its knowledge base): returns the passages that best match a natural-language query, with score… |
Esempi di prompt
- "Cosa hanno chiesto più spesso le persone al nostro bot di assistenza questa settimana? Riassumi i temi principali delle ultime conversazioni."
- "Perché ieri il bot ha avuto problemi? Controlla le sue issue e i log di errore dalle 9:00."
- "Mostrami utenti nuovi e di ritorno, sessioni e messaggi del nostro bot negli ultimi 30 giorni."
- "Trova nella tabella Leads la riga con l'email [email protected] e imposta lo stato su contacted. Mostrami prima la modifica."
- "Cerca nella knowledge base del bot la nostra politica di rimborso e dimmi da quale file viene la risposta."
FAQ
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?
