Quickstart: Azure MCP Server integreren met GitHub Copilot SDK

In deze quickstart configureert u de GitHub Copilot SDK voor het gebruik van Azure MCP-hulpprogramma's (Model Context Protocol), zodat uw toepassingen kunnen communiceren met Azure resources via natuurlijke taal.

Azure MCP biedt hulpprogramma's waarmee AI-assistenten rechtstreeks met Azure resources kunnen communiceren. Wanneer u deze hulpprogramma's integreert met de Copilot SDK, kunt u toepassingen bouwen die natuurlijke taal gebruiken om Azure abonnementen, resourcegroepen, opslagaccounts en meer te beheren.

Vereiste voorwaarden

GitHub Copilot CLI geïnstalleerd.
Node.js geïnstalleerd (voor het uitvoeren van de server via npx).
Azure CLI is geïnstalleerd en geverifieerd (az login).

Azure MCP Server wordt geverifieerd bij Microsoft Entra ID met behulp van de Azure Identity-bibliotheek voor .NET. De server ondersteunt twee verificatiemodi:

Brokermodus: maakt gebruik van de systeemeigen verificatie van uw besturingssysteem (zoals Windows Web Account Manager) met InteractiveBrowserCredential.
Modus referentieketen: probeert meerdere verificatiemethoden op volgorde: omgevingsvariabelen, Visual Studio Code, Visual Studio, Azure CLI, Azure PowerShell, Azure Developer CLI en interactieve browserverificatie.

Meld u aan met een van deze methoden:

Open het opdrachtpalet (Ctrl+Shift+P of Cmd+Shift+P op de Mac).
Voer Azure uit: meld u aan en volg de aanwijzingen.

az login

Connect-AzAccount

azd auth login

Nadat u zich hebt aangemeld, kan Azure MCP Server bewerkingen verifiëren en uitvoeren op Azure-services op basis van uw machtigingen.

Voorbeeld van configuratie van Azure MCP-server

Ongeacht de programmeer-SDK die u gebruikt, moet u Azure MCP-server configureren in de app-context, zodat de hulpprogramma's beschikbaar zijn. In het volgende voorbeeld ziet u de minimale configuratie:

{
  "mcp_servers": {
    "azure-mcp": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@azure/mcp@latest", "server", "start"],
      "tools": ["*"]
    }
  }
}

Met tools: ["*"] de parameter worden alle hulpprogramma's van de MCP-server voor de sessie ingeschakeld. In veel gevallen moet u in plaats daarvan een specifieke lijst met hulpprogrammanamen opgeven, zodat de Copilot sessie alleen de Azure MCP-hulpprogramma's kan aanroepen die uw app nodig heeft. In het volgende voorbeeld wordt de sessie beperkt tot een kleine set hulpprogramma's:

{
  "mcp_servers": {
    "azure-mcp": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@azure/mcp@latest", "server", "start"],
      "tools": ["group_list", "storage_account_list", "subscription_list"]
    }
  }
}

Zie Azure MCP Server-hulpprogramma's voor een volledige lijst met beschikbare hulpprogramma's.

Voorbeelden van integratie

In de volgende voorbeelden ziet u hoe u de SDK in verschillende talen kunt integreren.

Opmerking

Voor een snellere start kunt u Azure MCP Server wereldwijd installeren met behulp van npm install -g @azure/mcp@latest.

Opmerking

De volgende voorbeelden gebruiken --allow-all-tools en --allow-all-paths om de voorbeelden eenvoudig te houden. Deze vlaggen zijn niet vereist of aanbevolen voor elke app. Beperk de CLI-machtigingen en de MCP-configuratie tools tot wat uw app daadwerkelijk nodig heeft. Met brede instellingen voor 'toestaan van alle' kunnen meer hulpprogramma's en toegang tot het bestandssysteem beschikbaar worden gemaakt dan uw Azure MCP-integratie vereist.

Installatie

Installeer het Python SDK-pakket met behulp van pip.

pip install github-copilot-sdk

Voorbeeldcode

De volgende code demonstreert een volledige stroom:

import asyncio
from copilot import CopilotClient
from copilot.generated.session_events import SessionEventType

async def main():
    # Initialize the Copilot client
    client = CopilotClient({
        "cli_args": [
            "--allow-all-tools",
            "--allow-all-paths",
        ]
    })

    await client.start()

    # Configure Azure MCP server in session config
    azure_mcp_config = {
        "azure-mcp": {
            "type": "local",
            "command": "npx",
            "args": ["-y", "@azure/mcp@latest", "server", "start"],
            "tools": ["*"],  # Enable all Azure MCP tools
        }
    }

    # Create session with MCP servers
    session = await client.create_session({
        "model": "gpt-4.1",  # Default model; BYOK can override
        "streaming": True,
        "mcp_servers": azure_mcp_config,
    })

    # Handle events
    def handle_event(event):
        if event.type == SessionEventType.ASSISTANT_MESSAGE_DELTA:
            if hasattr(event.data, 'delta_content') and event.data.delta_content:
                print(event.data.delta_content, end="", flush=True)
        elif event.type == SessionEventType.TOOL_EXECUTION_START:
            tool_name = getattr(event.data, 'tool_name', 'unknown')
            print(f"\n[TOOL: {tool_name}]")

    session.on(handle_event)

    # Send prompt
    await session.send_and_wait({
        "prompt": "List all resource groups in my Azure subscription"
    })

    await client.stop()

if __name__ == "__main__":
    asyncio.run(main())

De voorgaande code:

Initialiseert de Copilot-client.
Hiermee configureert u de Azure MCP-server met behulp van npx.
Hiermee maakt u een sessie met het GPT-4.1-model en streaming ingeschakeld.
Hiermee worden gebeurtenissen verwerkt om antwoorden van assistenten en uitvoeringslogboeken van hulpprogramma's af te drukken.
Hiermee wordt een prompt verzonden om Azure-resourcegroepen weer te geven.

Installatie

Installeer het Node.js SDK-pakket met behulp van npm.

npm install @github/copilot-sdk

Voorbeeldcode

De volgende code demonstreert een volledige stroom:

import { CopilotClient } from '@github/copilot-sdk';
import type { MCPLocalServerConfig } from '@github/copilot-sdk';

async function main() {
  // Initialize the Copilot client
  const client = new CopilotClient({
    cliArgs: [
      '--allow-all-tools',
      '--allow-all-paths',
    ]
  });

  await client.start();

  // Configure Azure MCP server in session config
  const azureMcpConfig: Record<string, MCPLocalServerConfig> = {
    'azure-mcp': {
      type: 'local',
      command: 'npx',
      args: ['-y', '@azure/mcp@latest', 'server', 'start'],
      tools: ['*'],  // Enable all Azure MCP tools
    }
  };

  // Create session with MCP servers
  const session = await client.createSession({
    model: 'gpt-4.1',  // Default model; BYOK can override
    streaming: true,
    mcpServers: azureMcpConfig,
  });

  // Handle events
  session.on((event) => {
    if (event.type === 'assistant.message_delta') {
      if (event.data?.deltaContent) {
        process.stdout.write(event.data.deltaContent);
      }
    } else if (event.type === 'tool.execution_start') {
      const toolName = event.data?.toolName || 'unknown';
      console.log(`\n[TOOL: ${toolName}]`);
    }
  });

  // Send prompt
  await session.sendAndWait({
    prompt: 'List all resource groups in my Azure subscription 16caa5c4-46f1-4bfd-8c1b-a99f1efc8845'
  });

  await client.stop();
}

main().catch(console.error);

De voorgaande code:

Initialiseert de Copilot-client.
Hiermee configureert u de Azure MCP-server met behulp van npx.
Hiermee maakt u een sessie met het GPT-4.1-model en streaming ingeschakeld.
Hiermee worden gebeurtenissen verwerkt om antwoorden van assistenten en uitvoeringslogboeken van hulpprogramma's af te drukken.
Hiermee wordt een prompt verzonden om Azure-resourcegroepen weer te geven.

Installatie

Voeg de inhoud van het NuGet-pakket toe aan uw project.

dotnet add package GitHub.Copilot.SDK

Voorbeeldcode

De volgende C#-code demonstreert een volledige stroom:

using GitHub.Copilot.SDK;

// Initialize the Copilot client
await using var client = new CopilotClient(new CopilotClientOptions
{
    CliArgs = new[] { "--allow-all-tools", "--allow-all-paths" }
});

await client.StartAsync();

// Configure Azure MCP server in session config
var mcpServers = new Dictionary<string, object>
{
    ["azure-mcp"] = new McpLocalServerConfig
    {
        Type = "local",
        Command = "npx",
        Args = ["-y", "@azure/mcp@latest", "server", "start"],
        Tools = ["*"]  // Enable all Azure MCP tools
    }
};

// Create session with MCP servers
await using var session = await client.CreateSessionAsync(new SessionConfig
{
    Model = "gpt-4.1",  // Default model; BYOK can override
    Streaming = true,
    McpServers = mcpServers
});

// Handle events
session.On(evt =>
{
    if (evt is AssistantMessageDeltaEvent delta)
    {
        if (!string.IsNullOrEmpty(delta.Data.DeltaContent))
        {
            Console.Write(delta.Data.DeltaContent);
        }
    }
    else if (evt is ToolExecutionStartEvent toolStart)
    {
        Console.WriteLine($"\n[TOOL: {toolStart.Data.ToolName}]");
    }
});

// Send prompt
await session.SendAndWaitAsync(new MessageOptions
{
    Prompt = "List all resource groups in my Azure subscription"
});

De voorgaande code:

Initialiseert de Copilot-client.
Hiermee configureert u de Azure MCP-server met behulp van npx.
Hiermee maakt u een sessie met het GPT-4.1-model en streaming ingeschakeld.
Hiermee worden gebeurtenissen verwerkt om antwoorden van assistenten en uitvoeringslogboeken van hulpprogramma's af te drukken.
Hiermee wordt een prompt verzonden om Azure-resourcegroepen weer te geven.

Installatie

Haal het Go SDK-pakket op met behulp van go get.

go get github.com/github/copilot-sdk/go

Voorbeeldcode

De volgende code demonstreert een volledige stroom:

package main

import (
    "context"
    "fmt"
    "log"

    copilot "github.com/github/copilot-sdk/go"
)

func main() {
    ctx := context.Background()

    // Initialize the Copilot client
    client, err := copilot.NewClient(copilot.ClientOptions{
        CLIArgs: []string{
            "--allow-all-tools",
            "--allow-all-paths",
        },
    })
    if err != nil {
        log.Fatal(err)
    }

    if err := client.Start(ctx); err != nil {
        log.Fatal(err)
    }
    defer client.Stop(ctx)

    // Configure Azure MCP server in session config
    azureMcpConfig := map[string]copilot.MCPServerConfig{
        "azure-mcp": {
            Type:    "local",
            Command: "npx",
            Args:    []string{"-y", "@azure/mcp@latest", "server", "start"},
            Tools:   []string{"*"}, // Enable all Azure MCP tools
        },
    }

    // Create session with MCP servers
    session, err := client.CreateSession(ctx, copilot.SessionConfig{
        Model:      "gpt-4.1",  // Default model; BYOK can override
        Streaming:  true,
        MCPServers: azureMcpConfig,
    })
    if err != nil {
        log.Fatal(err)
    }

    // Handle events
    session.OnEvent(func(event copilot.SessionEvent) {
        switch event.Type {
        case copilot.AssistantMessageDelta:
            if event.Data.DeltaContent != "" {
                fmt.Print(event.Data.DeltaContent)
            }
        case copilot.ToolExecutionStart:
            fmt.Printf("\n[TOOL: %s]\n", event.Data.ToolName)
        }
    })

    // Send prompt
    err = session.SendAndWait(ctx, copilot.Message{
        Prompt: "List all resource groups in my Azure subscription",
    })
    if err != nil {
        log.Fatal(err)
    }
}

De voorgaande code:

Initialiseert de Copilot-client.
Hiermee configureert u de Azure MCP-server met behulp van npx.
Hiermee maakt u een sessie met het GPT-4.1-model en streaming ingeschakeld.
Hiermee worden gebeurtenissen verwerkt om antwoorden van assistenten en uitvoeringslogboeken van hulpprogramma's af te drukken.
Hiermee wordt een prompt verzonden om Azure-resourcegroepen weer te geven.

Feedback

Is deze pagina nuttig?

Laatst bijgewerkt om 2026-09-25

Quickstart: Azure MCP Server integreren met GitHub Copilot SDK

Vereiste voorwaarden

Aanmelden bij Azure MCP Server voor lokale ontwikkeling

Voorbeeld van configuratie van Azure MCP-server

Voorbeelden van integratie

Installatie

Voorbeeldcode

Verwante onderwerpen

Feedback

Aanvullende resources