Connettiti a Copilot Studio MCP con Visual Studio Code e GitHub Copilot CLI

Aggiungi Copilot Studio MCP a Visual Studio Code o GitHub Copilot CLI utilizzando il pacchetto npm pubblicato da Microsoft. Il tuo client avvia il server con npx e comunica con esso tramite stdio. Accedi e seleziona un ambiente per accedere agli strumenti del servizio connesso.

Prerequisites

  • Completa Configurare l'accesso a Copilot Studio MCP, inclusa la disponibilità di Node.js, npm e npx nell'ambiente in cui viene eseguito il server.
  • Per Visual Studio Code, installa una versione supportata con chat GitHub Copilot e accesso MCP.
  • Per GitHub Copilot CLI, installa una versione supportata di GitHub Copilot CLI.
  • Verifica che la tua azienda autorizzi il pacchetto @microsoft/copilot-studio-mcp.

Non è necessario clonare il repository pubblico di documentazione o configurare un URL MCP remoto.

Visual Studio Code

Installa dal registro

  1. Apri la vista Estensioni e cerca @mcp copilot-studio.

  2. Seleziona l'elenco MCP di Microsoft Copilot Studio e rivedi i requisiti di editore, pacchetto e installazione.

  3. Seleziona Installa, oppure usa Installa nell'area di lavoro se hai bisogno di una configurazione con ambito area di lavoro.

  4. Rivedi il prompt di configurazione e di attendibilità del server prima di avviare il server.

Puoi anche trovare il server nel registro MCP di GitHub e utilizzare l'opzione di installazione di Visual Studio Code quando disponibile. Il README del repository pubblico fornisce la documentazione del server. NPM fornisce il pacchetto eseguibile.

Configura manualmente il server

Come alternativa all'installazione del registro, aggiungi questa configurazione in .vscode/mcp.json:

{
  "servers": {
    "copilot-studio-mcp": {
      "command": "npx",
      "args": ["-y", "@microsoft/copilot-studio-mcp@latest"]
    }
  }
}

Unisci la voce a qualsiasi oggetto esistente servers invece di sovrascrivere server non correlati. Per utilizzare invece l'ambito del profilo utente, esegui MCP: Apri configurazione utente.

Avvia il server usando i controlli MCP di Visual Studio Code e rivedi il prompt di fiducia. npx Recupera e lancia il pacchetto. Non concede permessi a Copilot Studio né autorizza le operazioni aziendali. L'opzione -y accetta il prompt di recupero del pacchetto di npm, non l'attendibilità del cliente, il consenso all'autenticazione o le approvazioni delle azioni dello strumento. @latest utilizza la versione più recente attualmente disponibile di npm. Usa una versione fissa approvata se la tua organizzazione richiede il pinning della versione.

Visual Studio Code supporta anche la configurazione portatile con un oggetto mcpServers di primo livello, incluso un file .mcp.json dell'area di lavoro. Usa lo schema per la tua destinazione di output. La CLI di GitHub Copilot non legge il file specifico .vscode/mcp.json di Visual Studio Code.

Scopri di più su Aggiungi e gestisci server MCP in VS Code.

Usa gli strumenti in chat

  1. Apri una modalità chat che supporti gli strumenti e abilita gli strumenti MCP di Copilot Studio.

  2. Inizia con questa richiesta:

    Connettermi a Copilot Studio MCP e mostrare gli ambienti disponibili così posso sceglierne uno. Non creare, pubblicare, eseguire o riparare nulla.

  3. Completa l'accesso al browser e scegli l'ambiente previsto.

  4. Dopo la connessione, aggiorna gli strumenti disponibili se richiesto, e poi prova questa richiesta:

    Mostra le capacità MCP di Copilot Studio disponibili in questa connessione e conferma l'ambiente target. Non cambiare nulla.

interfaccia della riga di comando (CLI) di GitHub Copilot

Aggiungi il server in modo interattivo

  1. Avvia GitHub Copilot CLI.

  2. Inserisci /mcp add.

  3. Imposta Nome server su copilot-studio-mcp.

  4. Imposta Tipo di server su STDIO o Local. Queste opzioni avviano un processo, a differenza dell'opzione HTTP.

  5. Imposta Comando su npx -y @microsoft/copilot-studio-mcp@latest.

  6. Rivedi quali strumenti vuoi abilitare, seguendo la politica della tua organizzazione. Abilitare gli strumenti non sostituisce l'approvazione per azioni consequenziali.

  7. Premere CTRL+S per salvare.

I server aggiunti in questo modo sono disponibili senza riavviare la CLI. Completa l'accesso e la selezione dell'ambiente prima di utilizzare gli strumenti del servizio connesso.

Aggiungi il server dal terminale

Come alternativa al modulo interattivo, registra il server locale dal terminale:

copilot mcp add copilot-studio-mcp -- npx -y @microsoft/copilot-studio-mcp@latest

Questo comando aggiunge il server alla tua configurazione utente. Non concede permessi di servizio, non crea una connessione del connettore né autorizza un'implementazione.

Configura manualmente il server

Per la configurazione a livello utente su Windows, modifica %USERPROFILE%\.copilot\mcp-config.json nella posizione predefinita della configurazione:

{
  "mcpServers": {
    "copilot-studio-mcp": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@microsoft/copilot-studio-mcp@latest"],
      "tools": ["*"]
    }
  }
}

Unisci con le voci esistenti. Se usi una directory di configurazione personalizzata, usa invece quella posizione. L'impostazione tools rende disponibili al client gli strumenti pubblicizzati. Non approva tutte le azioni che possono compiere.

Per le impostazioni a livello di progetto, segui i requisiti documentati di configurazione e di attendibilità dell'area di lavoro del cliente. Scopri di più in Aggiunta di server MCP per GitHub Copilot CLI.

Confermare la connessione

Usalo /mcp per ispezionare il server registrato. Controlla lo stato e gli strumenti disponibili, poi usa la richiesta di connessione nella sezione Usa gli strumenti nella chat per accedere e scegliere un ambiente. Riutilizza una connessione già pronta invece di accedere di nuovo.

Per compiti più ampi, vedi Usa Copilot Studio MCP e le richieste di esempio.

Risolvere i problemi di connessione del client

Sintomo Action
npx non è stato trovato Controlla che Node.js e npm siano installati e disponibili sul PATH usato dal client MCP. Nello sviluppo remoto, controlla il computer o il contenitore che esegue il server.
NPM non riesce a recuperare il pacchetto Conferma il nome esatto del pacchetto Microsoft e l'accesso approvato al npm e alla rete.
Il server non è nel registro Conferma che l'elemento sia disponibile nel registro configurato dal tuo cliente. Usa la configurazione manuale se il pacchetto npm è consentito.
La configurazione non è riconosciuta Controlla la posizione del file e l'oggetto di primo livello: servers per la configurazione specifica di Visual Studio Code, mcpServers per il formato portatile e CLI.
Il server è disabilitato o bloccato Rivedi l'attendibilità del client, gli strumenti abilitati e le policy del server organizzativo. Non bypassare la policy per connettersi.
Impossibile completare l'autenticazione Controlla i requisiti di account, consenso e accesso del browser. Non incollare un token in chat come soluzione alternativa.
Appaiono solo strumenti di connessione Completa l'accesso e la selezione dell'ambiente, poi aggiorna la scoperta degli strumenti utilizzando i controlli supportati dal client.
La risposta viene interrotta Ispeziona lo stato noto dell'operazione prima di riprovare. Un'interruzione del client potrebbe non annullare il lavoro lato server.

Usa i controlli di gestione del server del client per bloccare, disabilitare o rimuovere la registrazione quando necessario. Questa azione non cancella gli artefatti di Copilot Studio né annulla le modifiche precedenti.

  • Ultimo aggiornamento: