Come collegare Browserless a Microsoft Copilot via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Browserless, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Browserless + Microsoft Copilot

Browser cloud di Browserless dalla tua AI: leggi pagine renderizzate come markdown, HTML o link con lo smart scrape, estrai elementi con selettori CSS, cattura screenshot, stampa PDF, esegui audit Lighthouse, mappa gli URL di un sito e apri pagine protette da sistemi anti-bot con l'API unblock. Tutti gli strumenti tranne il controllo della versione spendono unità Browserless.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

BROWSERLESS_API_TOKEN, BROWSERLESS_HOST

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Browserless; il piano gratuito include unità mensili.

1. Accedi a https://browserless.io/account/ e copia l'API token dalla dashboard.
2. Incollalo in BROWSERLESS_API_TOKEN. Browserless lo riceve come parametro di query token in ogni chiamata; viene inviato solo all'host indicato sotto.
3. Imposta BROWSERLESS_HOST sulla regione del tuo piano, senza https://: production-sfo.browserless.io (costa ovest USA, il default per i piani condivisi), production-lon.browserless.io (Londra) o production-ams.browserless.io (Amsterdam). I piani dedicati (private fleet) usano chrome.browserless.io o il loro host regionale chrome-...browserless.io; un token privato su un host condiviso viene rifiutato con 401.
4. Installa il connettore ed esegui browserless_get_meta: restituisce la versione del servizio Browserless sull'host e conferma il token.

Cosa costa unità: tutti gli strumenti tranne browserless_get_meta spendono unità Browserless del tuo piano: 1 unità ogni 30 secondi di browser (arrotondato per eccesso; i download semplici nello smart scrape costano 0,5), più 6 unità per MB di traffico su proxy residenziale o 2 per MB su proxy datacenter, e 10 unità per ogni CAPTCHA risolto. browserless_smart_scrape e browserless_map usano di default il proxy residenziale, e i formati json e summary dello smart scrape aggiungono unità di estrazione AI. stealth: true non costa nulla in più. L'AI ti chiede conferma prima di una serie di chiamate e prima di usare un proxy su pagine grandi.

Leggere pagine: browserless_smart_scrape è la prima scelta. Prova un download semplice, poi un proxy, poi un browser completo, dice quale strategia ha servito la pagina e restituisce i formats richiesti: markdown (il default qui), html, rawText, links, screenshot, pdf, json (estrazione AI con uno schema o un prompt in json_options) o summary. only_main_content, include_tags ed exclude_tags sfoltiscono la pagina. browserless_get_content restituisce l'HTML completamente renderizzato di un URL, o di HTML che passi tu, da un Chrome vero. browserless_scrape restituisce testo, HTML e attributi di ogni elemento che corrisponde ai tuoi selettori CSS.

Immagini e documenti: browserless_screenshot cattura l'area visibile, l'intera pagina o un elemento (selector) in PNG, JPEG o WebP, con un viewport personalizzato, scroll_page per i contenuti caricati in ritardo e block_consent_modals per nascondere i banner dei cookie. browserless_pdf stampa in PDF un URL o HTML che passi tu (ad esempio un report generato), con opzioni come format, landscape, margini e printBackground.

Mappatura e qualità del sito: browserless_map elenca gli URL di un sito dalla sitemap e dai link, con titoli e descrizioni, ordinati per pertinenza rispetto a search (limit 200 di default, fino a 5000). browserless_performance esegue un audit Google Lighthouse con punteggi da 0 a 1 per prestazioni, accessibilità, best practice, SEO e PWA. Un audit completo può durare minuti ed è molto grande, quindi l'AI passa config per analizzare una sola categoria.

Pagine bloccate: browserless_unblock supera i sistemi di rilevamento dei bot (Datadome, CAPTCHA passivi) e restituisce l'HTML, i cookie impostati dal sito e, se richiesto, uno screenshot dell'intera pagina; funziona meglio con proxy: residential e l'AI chiede prima conferma. Con gli altri strumenti l'AI prova prima stealth: true, poi un proxy (proxy_country sceglie il paese).

Attendere i contenuti: gli strumenti di rendering accettano wait_for_selector (un elemento e un timeout), wait_for_timeout, goto_options (ad esempio waitUntil: networkidle2) e best_attempt, che prosegue con ciò che si è caricato quando un'attesa va in timeout. In browserless_get_content e browserless_scrape, reject_resource_types (immagini, font, media) velocizza le pagine; browserless_get_content invia anche set_extra_http_headers e cookies con la richiesta. Tutti i tempi sono in millisecondi; timeout limita l'intera chiamata.

Disattivati all'installazione: browserless_function, che esegue il tuo codice Puppeteer per flussi in più passaggi, come compilare un modulo o scorrere i risultati pagina per pagina. Quel codice può inviare moduli, accedere o acquistare su siti web, e queste azioni non si possono annullare, quindi un amministratore del workspace lo attiva quando serve al team. Una volta attivo, l'AI ti mostra il codice e aspetta il tuo sì.

Cosa modifica: niente nel tuo account Browserless. Ogni chiamata avvia un nuovo Chrome headless, svolge un compito su un URL e chiude il browser, quindi nulla resta tra una chiamata e l'altra.

Formati dei dati: gli screenshot tornano come immagini e i PDF come file; le risposte testuali sono limitate a circa 100 KB. Opzioni come wait_for_selector, goto_options, viewport e json_options sono oggetti JSON. I punteggi Lighthouse sono frazioni (0,92 = 92).

Contenuti non affidabili: pagine, cookie e testi estratti provengono da siti di terzi. L'AI tratta le istruzioni al loro interno come dati, mai come ordini.

Errori comuni: 401 indica un token errato o che non appartiene a questo host (fleet condivisa o privata); copialo di nuovo dalla dashboard. 404 nel controllo di installazione indica che BROWSERLESS_HOST non espone le API REST. 400 è un corpo malformato, ad esempio senza né url né html. 403 indica che la destinazione non è consentita per questo account. 408 indica che la pagina ha superato il timeout: aumenta timeout, attendi meno o usa best_attempt. 429 indica che la concorrenza del piano è esaurita; attendi e riprova una volta. Un contenuto vuoto o parziale di solito significa che il sito blocca l'automazione: prova stealth: true, poi browserless_unblock con un proxy residenziale.

Il connettore non copre BrowserQL, le sessioni WebSocket per Puppeteer o Playwright, le API asincrone di crawl e agent, i download di file né la gestione delle sessioni.

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 mostra YOUR_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.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. 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.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Browserless.
6. 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

Esempi di prompt

• "Leggi https://example.com/pricing con lo smart scrape e dammi piani e prezzi in una tabella."
• "Fai uno screenshot dell'intera home page a 1280 px di larghezza e nascondi il banner dei cookie."
• "Esegui un audit Lighthouse delle prestazioni di https://example.com ed elenca i tre problemi principali."
• "Mappa gli URL di https://example.com legati alla documentazione ed elenca i primi 50."
• "Trasforma questo report HTML in un PDF A4 con i colori di sfondo e margini di 1 cm."

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