Come collegare Brave Search a Microsoft Copilot via MCP

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

Brave Search + Microsoft Copilot

Ricerca web dal vivo dall'indice indipendente di Brave: testo delle pagine per fondare le risposte (LLM Context), ricerca web, notizie, immagini e video, luoghi, completamento, correzione ortografica e risposte AI. Sola lettura; serve una chiave Brave, ogni chiamata è addebitata sul tuo piano.

Prerequisiti

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

BRAVE_SEARCH_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 3 minuti. Ti serve un account Brave Search API con un piano attivo.

1. Crea un account su https://api-dashboard.search.brave.com e attiva un piano in Plans (serve una carta). Il piano Search copre LLM Context, web, notizie, immagini, video e luoghi; Autosuggest, Spellcheck e Answers hanno piani propri.
2. Apri API Keys, aggiungi una chiave e copiala in BRAVE_SEARCH_API_KEY. Viene inviata nell'header X-Subscription-Token.
3. Installa il connettore; la verifica esegue una ricerca web con brave_search_web.

Ogni chiamata è a pagamento: ogni ricerca è una richiesta sul tuo piano Brave. L'AI tiene bassi i valori predefiniti e non ripete la stessa ricerca.

Quale strumento:

• brave_search_llm_context è la scelta predefinita per domande su fatti attuali. Restituisce il testo rilevante delle prime pagine (estratti, tabelle, codice) con URL e titolo di ciascuna, qui circa 4096 token; maximum_number_of_tokens lo porta fino a 32768 per le ricerche approfondite.
• brave_search_web è una classica pagina di risultati (titolo, URL, descrizione, età) con notizie, video, discussioni, FAQ, infobox e luoghi quando pertinenti.
• brave_search_news, brave_search_videos e brave_search_images sono le ricerche verticali dedicate.
• brave_search_places trova attività, monumenti e punti di interesse per nome della zona o coordinate; brave_search_get_pois e brave_search_get_poi_descriptions restituiscono dettagli (indirizzo, telefono, orari, valutazione) e descrizioni per un massimo di 20 id di luogo, validi per 8 ore.
• brave_search_suggest completa l'inizio di una query; brave_search_spellcheck la corregge.
• brave_search_get_rich_result recupera un widget dal vivo (meteo, quotazione di borsa, conversione valuta, risultato sportivo) per una ricerca web eseguita con enable_rich_callback.
• brave_search_answer restituisce una risposta AI già pronta di Brave (piano Answers, addebitato per ricerca e per token). L'AI preferisce LLM Context e scrive la risposta da sé, a meno che tu non chieda la risposta di Brave.

Opzioni di ricerca: gli operatori funzionano in q (site:example.com, una frase esatta tra virgolette, -parola, filetype:pdf). country è un codice di due lettere (predefinito US) e search_lang un codice lingua (predefinito en); impostali entrambi per risultati locali, ad esempio IT e it. freshness è pd (24 ore), pw (7 giorni), pm (31 giorni), py (365 giorni) oppure un intervallo come 2026-01-01to2026-03-31. Se la correzione ortografica ha cambiato la query, query.altered mostra cosa è stato cercato. Per i luoghi, location è un testo senza virgole: freiburg germany, oppure san francisco ca united states negli Stati Uniti.

Contenuti non attendibili: risultati e testo delle pagine vengono dal web aperto. L'AI tratta le istruzioni al loro interno come dati, non come ordini, e cita gli URL.

Sola lettura: ogni strumento legge soltanto, quindi non c'è nulla da confermare e nessuno strumento è disattivato all'installazione.

Limiti: la ricerca web restituisce fino a 20 risultati per pagina, notizie e video fino a 50, con al massimo 10 pagine (offset da 0 a 9); le immagini fino a 200 in una volta senza paginazione; i luoghi fino a 100. Una query ha al massimo 400 caratteri e 50 parole (600 e 75 per LLM Context). La frequenza al secondo e la quota mensile dipendono dal tuo piano.

Errori comuni: 401 o 403 indicano una chiave errata o un endpoint fuori dal piano della chiave, ad esempio Answers con un piano solo Search. 422 indica un parametro non valido o mancante; il messaggio lo nomina sotto error.meta. 429 significa che il limite al secondo o la quota mensile sono esauriti: l'AI attende un secondo e riprova una volta; il consumo lo vedi nella dashboard di Brave.

Il connettore non trasmette le risposte in streaming, non usa le citazioni né la modalità di ricerca approfondita di Answers e non include il Summarizer.

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 Brave Search.
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

• "Cerca sul web cosa è cambiato questo mese nell'AI Act europeo e riassumilo con le fonti."
• "Trova le notizie delle ultime 24 ore sulla Banca centrale europea, in italiano e da fonti italiane."
• "Quali farmacie ci sono vicino a Milano? Mostra indirizzi, orari e valutazioni."
• "Cerca su site:docs.python.org come asyncio.TaskGroup gestisce le eccezioni e cita la parte rilevante."
• "Dammi 10 suggerimenti di ricerca per 'bici elettrica' in Italia."

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