Usar o servidor MCP

O servidor Dev Proxy MCP (Model Context Protocol) permite que assistentes de programação com IA o ajudem a trabalhar com Dev Proxy. Usando este servidor, pode pedir ao seu assistente de IA que crie configurações de Proxy de Desenvolvimento, encontre documentação e obtenha ajuda contextual — tudo usando linguagem natural.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite aos assistentes de IA conectarem-se a ferramentas e fontes de dados externas. O servidor MCP do Proxy de Desenvolvimento dá ao seu assistente de IA acesso à documentação e às melhores práticas do Proxy de Desenvolvimento, permitindo-lhe fornecer ajuda precisa e consciente do contexto.

Pré-requisitos

Antes de começar, certifique-se de que tem:

Configurar o servidor MCP

O servidor Proxy de Desenvolvimento MCP é publicado no npm como @devproxy/mcp. Configure-o no seu assistente de IA usando estes valores:

Configuração Valor
Tipo stdio
Comando npx
Argumentos -y, @devproxy/mcp

Os passos exatos de configuração variam consoante o assistente de IA.

Visual Studio Code com GitHub Copilot

  1. Abre Visual Studio Code.
  2. Abra a paleta de comandos (Ctrl+Shift+P ou Cmd+Shift+P).
  3. Escreve MCP: Add Server e seleciona-o.
  4. Selecionar Comando (stdio).
  5. Digite npx como o comando.
  6. Introduza -y @devproxy/mcp como argumento.
  7. Pressione Enter para guardar.

Em alternativa, adicione o seguinte às suas definições de VS Code em JSON (.vscode/mcp.json no seu espaço de trabalho ou nas definições de utilizador):

{
  "servers": {
    "Dev Proxy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@devproxy/mcp"]
    }
  }
}

GitHub Copilot CLI

Adicione o seguinte à sua configuração Copilot CLI MCP:

Ficheiro: ~/.copilot/mcp-config.json

{
  "mcpServers": {
    "devproxy": {
      "command": "npx",
      "args": ["-y", "@devproxy/mcp"]
    }
  }
}

Alternativamente, use o comando de barra /mcp add numa sessão interativa do Copilot CLI para adicionar o servidor.

Código Claude

Execute o seguinte comando no seu terminal para adicionar o servidor MCP do Proxy de Desenvolvimento:

claude mcp add devproxy -- npx -y @devproxy/mcp

Cursor

Adicione o seguinte à sua configuração do Cursor MCP:

Ficheiro: ~/.cursor/mcp.json

{
  "mcpServers": {
    "devproxy": {
      "command": "npx",
      "args": ["-y", "@devproxy/mcp"]
    }
  }
}

Reinicia o Cursor depois de guardar a configuração.

Ferramentas disponíveis

O servidor Dev Proxy MCP fornece as seguintes ferramentas aos assistentes de IA:

Tool Description
GetBestPractices Devolve as melhores práticas para configurar e usar Dev Proxy. O assistente de IA normalmente chama esta ferramenta antes de gerar qualquer configuração de Proxy Dev.
FindDocs Pesquisa na documentação do Dev Proxy por informações relacionadas a uma consulta. Útil para encontrar documentação específica de plugins ou guias práticos.
GetVersion Devolve a versão Dev Proxy instalada. Ajuda a garantir que as configurações geradas são compatíveis com a tua versão.

Exemplos de sugestões

Depois de configurar o servidor MCP, pode fazer perguntas ao seu assistente de IA sobre Dev Proxy em linguagem natural. Aqui estão alguns exemplos de prompts:

Criar uma configuração para simular uma API

Crie uma configuração de Proxy de Desenvolvimento para simular uma API REST em https://api.example.com/products que devolva uma lista de produtos.

Simular erros de API

Configurar o Dev Proxy para devolver aleatoriamente 500 erros para 30% de pedidos para https://api.contoso.com/*.

Peça ajuda com um plugin específico

Como configuro o *RateLimitingPlugin* para simular o estrangulamento?

Testar permissões da API Microsoft Graph

Crie uma configuração de Proxy de Desenvolvimento para verificar se a minha aplicação está a usar permissões mínimas para o Microsoft Graph.

O assistente de IA usa o servidor MCP para encontrar documentação relevante e boas práticas, gerando depois configurações precisas de Proxy de Desenvolvimento, adaptadas às suas necessidades.

Verifique se o servidor MCP funciona

Para verificar se o servidor MCP está a funcionar:

  1. Abra a interface de chat do seu assistente de IA.
  2. Faça uma pergunta sobre o Dev Proxy, por exemplo: "Que versão do Dev Proxy tenho instalado?"
  3. O assistente de IA deve usar a GetVersion ferramenta e reportar a versão instalada.

Se o assistente de IA não conseguir aceder às ferramentas, verifique:

  • Node.js está instalado e disponível no seu PATH
  • A configuração do servidor MCP está correta
  • Reiniciaste o teu assistente de IA após a configuração

Próximo passo

Aprenda a configurar o Dev Proxy para as suas necessidades específicas: