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.
Configurazione guidata
Collega Botpress a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Botpress con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Botpress. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?