Início Rápido: Integrar o Servidor MCP do Azure ao SDK do GitHub Copilot

Neste início rápido, você configura o SDK do GitHub Copilot para usar as ferramentas do Azure Model Context Protocol (MCP), para que seus aplicativos possam interagir com recursos do Azure por meio de linguagem natural.

Azure MCP fornece ferramentas que permitem que os assistentes de IA interajam diretamente com Azure recursos. Ao integrar essas ferramentas ao SDK do Copilot, você pode criar aplicativos que usam linguagem natural para gerenciar assinaturas Azure, grupos de recursos, contas de armazenamento e muito mais.

Pré-requisitos

CLI do GitHub Copilot instalada.
Node.js instalado (para executar o servidor por meio npx).
CLI do Azure instalada e autenticada (az login).

O Servidor MCP do Azure autentica-se no Microsoft Entra ID usando a biblioteca Azure Identity para .NET. O servidor dá suporte a dois modos de autenticação:

Modo de agente: usa a autenticação nativa do sistema operacional (como o Gerenciador de Contas Web do Windows) com InteractiveBrowserCredential.
Modo de cadeia de credenciais: tenta vários métodos de autenticação em sequência: variáveis de ambiente, Visual Studio Code, Visual Studio, CLI do Azure, Azure PowerShell, CLI do Desenvolvedor do Azure e autenticação interativa do navegador.

Entre usando qualquer um destes métodos:

Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P no Mac).
Execute o comando Azure: Sign In e siga as instruções.

az login

Connect-AzAccount

azd auth login

Depois de entrar, o Servidor MCP do Azure pode autenticar e executar operações nos serviços do Azure com base em suas permissões.

Exemplo de configuração do Servidor MCP do Azure

Independentemente do SDK de programação que você usa, você deve configurar Azure SERVIDOR MCP no contexto do aplicativo para que suas ferramentas estejam disponíveis. A configuração essencial se parece com o seguinte exemplo:

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

O tools: ["*"] parâmetro é essencial: ele habilita todas as ferramentas do servidor MCP para a sessão.

Exemplos de integração

Os exemplos a seguir mostram como integrar o SDK em diferentes idiomas.

Observação

Para uma inicialização mais rápida, você pode instalar o Servidor MCP do Azure globalmente usando npm install -g @azure/mcp@latest.

Installation

Instale o pacote do SDK do Python usando pip.

pip install github-copilot-sdk

Código de exemplo

O código a seguir demonstra um fluxo completo:

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())

O código anterior:

Inicializa o cliente Copilot.
Configura o servidor MCP do Azure usando npx.
Cria uma sessão com o modelo GPT-4.1 e o streaming habilitados.
Gerencia eventos para exibir respostas do assistente e logs de execução de ferramentas.
Envia um prompt para listar grupos de recursos do Azure.

Installation

Instale o pacote do SDK Node.js usando o npm.

npm install @github/copilot-sdk

Código de exemplo

O código a seguir demonstra um fluxo completo:

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);

O código anterior:

Inicializa o cliente Copilot.
Configura o servidor MCP do Azure usando npx.
Cria uma sessão com o modelo GPT-4.1 e o streaming habilitados.
Gerencia eventos para exibir respostas do assistente e logs de execução de ferramentas.
Envia um prompt para listar grupos de recursos do Azure.

Installation

Adicione o conteúdo do pacote NuGet ao seu projeto.

dotnet add package GitHub.Copilot.SDK

Código de exemplo

O código C# a seguir demonstra um fluxo completo:

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"
});

O código anterior:

Inicializa o cliente Copilot.
Configura o servidor MCP do Azure usando npx.
Cria uma sessão com o modelo GPT-4.1 e o streaming habilitados.
Gerencia eventos para exibir respostas do assistente e logs de execução de ferramentas.
Envia um prompt para listar grupos de recursos do Azure.

Installation

Obtenha o pacote do SDK go usando go get.

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

Código de exemplo

O código a seguir demonstra um fluxo completo:

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)
    }
}

O código anterior:

Inicializa o cliente Copilot.
Configura o servidor MCP do Azure usando npx.
Cria uma sessão com o modelo GPT-4.1 e o streaming habilitados.
Gerencia eventos para exibir respostas do assistente e logs de execução de ferramentas.
Envia um prompt para listar grupos de recursos do Azure.

Comentários

Esta página foi útil?

Last updated on 2026-08-20

Início Rápido: Integrar o Servidor MCP do Azure ao SDK do GitHub Copilot

Pré-requisitos

Entrar no Servidor MCP do Azure para desenvolvimento local

Exemplo de configuração do Servidor MCP do Azure

Exemplos de integração

Installation

Código de exemplo

Conteúdo relacionado

Comentários

Recursos adicionais