Usar o servidor MCP

O servidor MCP (Protocolo de Contexto de Modelo) do Proxy de Desenvolvimento possibilita que assistentes de codificação de IA te ajudem a trabalhar com o Dev Proxy. Usando esse servidor, você pode pedir ao assistente de IA para criar configurações de Proxy de Desenvolvimento, encontrar documentação e obter ajuda contextual, tudo usando linguagem natural.

O que é MCP?

O PROTOCOLO MCP (Model Context Protocol) é um padrão aberto que permite que os assistentes de IA se conectem a ferramentas externas e fontes de dados. O servidor MCP do Proxy de Desenvolvimento fornece ao assistente de IA acesso à documentação do Proxy de Desenvolvimento e às práticas recomendadas, permitindo que ele forneça ajuda precisa e com reconhecimento de contexto.

Pré-requisitos

Antes de começar, verifique se você tem:

Configurar o servidor MCP

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

Configurações Valor
Tipo stdio
Comando npx
Argumentos -y, @devproxy/mcp

As etapas exatas de configuração variam de acordo com o assistente de IA.

Visual Studio Code com GitHub Copilot

  1. Abra o Visual Studio Code.
  2. Abra a paleta de comandos (Ctrl+Shift+P ou Cmd+Shift+P).
  3. Digite MCP: Adicione o Servidor e selecione-o.
  4. Selecione Comando (stdio).
  5. Insira npx como o comando.
  6. Insira -y @devproxy/mcp como os argumentos.
  7. Pressione Enter para salvar.

Como alternativa, adicione o seguinte às configurações do VS Code JSON (.vscode/mcp.json em seu workspace ou configurações de usuário):

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

CLI do GitHub Copilot

Adicione o seguinte à configuração da CLI do Copilot MCP:

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

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

Como alternativa, use o /mcp add comando de barra em sessão interativa da CLI do Copilot para adicionar o servidor.

Código Claude

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

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

Cursor

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

Arquivo: ~/.cursor/mcp.json

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

Reinicie o Cursor depois de salvar a configuração.

Ferramentas disponíveis

O servidor MCP do Proxy de Desenvolvimento fornece as seguintes ferramentas para os assistentes de IA:

Tool DESCRIÇÃO
GetBestPractices Retorna as práticas recomendadas para configurar e usar o Proxy de Desenvolvimento. O assistente de IA normalmente chama essa ferramenta antes de gerar qualquer configuração de Proxy de Desenvolvimento.
FindDocs Pesquisa a documentação do Proxy de Desenvolvimento para obter informações relacionadas a uma consulta. Útil para localizar a documentação específica do plug-in ou guias de instruções.
GetVersion Retorna a versão do Proxy de Desenvolvimento instalada. Ajuda a garantir que as configurações geradas sejam compatíveis com sua versão.

Prompts de exemplo

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

Criar uma configuração para simular uma API

Crie uma configuração de Proxy Dev para simular uma API REST no https://api.example.com/products que retorna uma lista de produtos.

Simular erros de API

Configure o Proxy de Desenvolvimento para retornar aleatoriamente 500 erros para 30% de solicitações para https://api.contoso.com/*.

Obter ajuda com um plug-in específico

Como posso configurar o plugin de limitação de taxa para simular o controle de fluxo?

Testar permissões da API do Microsoft Graph

Crie uma configuração de Proxy de Desenvolvimento para verificar se meu aplicativo está usando permissões mínimas para o Microsoft Graph.

O assistente de IA usa o servidor MCP para encontrar a documentação e as práticas recomendadas relevantes e, em seguida, gera configurações precisas de Proxy de Desenvolvimento adaptadas às suas necessidades.

Verificar se o servidor MCP funciona

Para verificar se o servidor MCP está funcionando:

  1. Abra a interface de chat do assistente de IA.
  2. Faça uma pergunta sobre o Proxy de Desenvolvimento, por exemplo: "Qual versão do Proxy de Desenvolvimento eu instalei?"
  3. O assistente de IA deve usar a GetVersion ferramenta e relatar sua versão instalada.

Se o assistente de IA não puder acessar as ferramentas, verifique:

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

Próxima etapa

Saiba como configurar o Proxy de Desenvolvimento para suas necessidades específicas:

Configuração

  • Última atualização em