Usare il server Microsoft Web IQ MCP

Authentication

Tutte le richieste (SIA MCP che API REST) possono essere autenticate usando una chiave API o Entra ID token di accesso. Per istruzioni dettagliate sulla configurazione, vedere Autenticazione.

Integrazione del server MCP

Il server Web IQ MCP consente agli agenti di intelligenza artificiale di integrarsi facilmente con le funzionalità di ricerca avanzate fornite dalle offerte Microsoft Web IQ. Questa integrazione offre ai modelli di intelligenza artificiale l'accesso in tempo reale ai contenuti più recenti dal Web, dalle notizie, dai video, dalle immagini e dalle funzionalità di esplorazione.

I risultati degli strumenti seguono le stesse regole di presenza dei campi delle risposte REST: i campi del modello null, stringa vuota ed elenco/array vuoto vengono omessi sia dal contenuto strutturato che dal relativo fallback di testo JSON. Considera un campo elenco assente come senza elementi. Vengono mantenute stringhe solo spazi vuoti, false, 0, dizionari vuoti, voci di array/dizionario e JSON non elaborato incorporato. Ciò non modifica i parametri della richiesta MCP, gli identificatori JSON-RPC o gli array dell’involucro del protocollo come content.

Endpoint:mcp https://api.microsoft.ai/v3/mcp

Strumenti MCP disponibili:

  • web - Cercare nel Web e recuperare il contenuto della pagina Web
  • videos - Cercare video pertinenti
  • browse - Recuperare il contenuto da un URL specifico
  • news - Cercare gli ultimi articoli di notizie
  • images - Cercare immagini pertinenti

Note

Gli strumenti esposti dal server WebIQ MCP sono limitati all'elenco di servizi consentiti dell'account. Se la chiave API o Entra ID token di accesso non dispone dell'autorizzazione per uno strumento specifico, non verrà visualizzata nell'elenco degli strumenti MCP. Contattare il rappresentante Microsoft per richiedere l'accesso ad altri strumenti.

Configurazione del server MCP:

Aggiungi questo al file mcp.json da usare con VS Code Copilot o altri client compatibili con MCP:

{
  "mcpServers": {
    "WebIQ-MCP": {
      "url": "https://api.microsoft.ai/v3/mcp",
      "type": "http",
      "headers": {
        "x-apikey": "<your-api-key>"
      }
    }
  }
}

Per l'interfaccia a riga di comando di Copilot, aggiungere il contenuto seguente al file di configurazione disponibile in:

  • Mac/Linux: ~/.copilot/mcp-config.json
  • Windows: %USERPROFILE%\.copilot\mcp-config.json
{
  "mcpServers": {
    "WebIQ-MCP": {
      "url": "https://api.microsoft.ai/v3/mcp",
      "type": "http",
      "authtype": "api-key",
      "headers": {
        "x-apikey": "<your-api-key>"
      }
    }
  }
}

Strumento MCP di ricerca Web

Nome dello strumento:web

Lo strumento MCP accetta gli stessi parametri dell'API REST. Per informazioni di riferimento complete, vedere Parametri di ricerca Web .

Strumento MCP per la ricerca di video

Nome dello strumento:videos

Lo strumento MCP accetta gli stessi parametri dell'API REST. Per informazioni di riferimento complete, vedere Videos Search Parameters.

Esplora lo strumento MCP

Nome dello strumento:browse

Lo strumento MCP accetta gli stessi parametri dell'API REST. Per informazioni di riferimento complete, vedere Browse Parameters.

Strumento MCP ricerca notizie

Nome dello strumento:news

Lo strumento MCP accetta gli stessi parametri dell'API REST. Per informazioni di riferimento complete, vedere Parametri di ricerca notizie.

Strumento MCP ricerca immagini

Nome dello strumento:images

Lo strumento MCP accetta gli stessi parametri dell'API REST. Per informazioni di riferimento complete, vedere Parametri di ricerca immagini.

  • Ultimo aggiornamento: