MCP Easy Setup

Uma extensão para guiar devs, QAs e pessoas menos experientes na criação de integrações MCP sem precisar decorar JSON, comandos ou variáveis de ambiente.

O foco é simples: escolher o serviço, preencher as credenciais em linguagem direta e receber a configuração pronta para usar em clientes como Claude Desktop, Codex e outros clientes compatíveis com MCP.

Suporte por cliente (sem confusao)

• VS Code (MCP nativo): suportado com aplicacao automatica em .vscode/mcp.json.
• Claude Code no VS Code: suportado com aplicacao automatica em .mcp.json.
• Claude Desktop (app separado): suportado, mas normalmente exige colar no arquivo de configuracao do Claude Desktop.

Por que no Claude Desktop ainda pode pedir copia manual?

• Esta extensao roda no contexto do VS Code e prioriza arquivos do workspace.
• O arquivo do Claude Desktop fica fora do projeto (ex.: %APPDATA%/Claude/claude_desktop_config.json), entao o caminho mais seguro e gerar o bloco pronto para colar.

Comece aqui (passo a passo para leigos)

Se voce instalou a extensao e "nao apareceu nada", isso e normal. Ela nao abre como aplicativo separado automaticamente: voce precisa chamar o comando dela no VS Code.

1. Abra o VS Code.
2. Pressione Ctrl + Shift + P (ou F1) para abrir o Command Palette.
3. Digite MCP Easy Setup.
4. Clique no comando MCP Easy Setup.
5. Escolha os servicos que quer configurar.
6. Escolha o cliente de IA de destino.
7. Preencha os campos (URL, token, usuario, senha, etc.).
8. Se escolher VS Code ou Claude Code, clique em Aplicar automaticamente.
9. Pronto: a configuracao e salva no arquivo certo e voce ja pode usar.

Arquivo gerado quando voce escolhe salvar:

• .vscode/mcp.easy-setup.json

Arquivos de aplicacao automatica (novo):

• VS Code (MCP nativo): .vscode/mcp.json
• Claude Code: .mcp.json

Nao apareceu nada? (solucao rapida)

1. Confirme se a extensao esta instalada e habilitada no VS Code.
2. Rode novamente Ctrl + Shift + P e procure por MCP Easy Setup.
3. Se o comando nao aparecer, recarregue a janela com Developer: Reload Window.
4. Se ainda nao aparecer, feche e abra o VS Code e teste de novo.
5. Verifique se voce esta no VS Code (desktop) ou ambiente compativel com extensoes.

O que ela resolve

• Evita setup manual de JSON.
• Reduz erro de configuração em credenciais e URLs.
• Centraliza serviços internos em um fluxo guiado.
• Gera um arquivo pronto para copiar ou salvar no workspace.
• Ajuda a padronizar integrações para dev, QA e análise de código.

Como funciona

flowchart TD
    A[Abrir o comando MCP Easy Setup] --> B[Escolher um ou mais serviços]
    B --> C[Selecionar o cliente de IA]
    C --> D[Preencher URL, token, usuário e senha]
  D --> E[Gerar JSON MCP]
  E --> F[Aplicar automaticamente em .vscode/mcp.json ou .mcp.json]
  E --> G[Ou copiar/colar para Claude Desktop]

Fluxo do usuário

1. Execute o comando MCP Easy Setup no Command Palette.
2. Selecione os serviços que deseja integrar.
3. Escolha o cliente de IA de destino.
4. Preencha os campos apresentados de forma guiada.
5. Para VS Code e Claude Code, use Aplicar automaticamente.
6. Para Claude Desktop, copie e cole no arquivo de configuracao do Claude Desktop.

Serviços suportados

A extensão só monta JSON com pacotes MCP que foram verificados como existentes no registry. Se um serviço não tiver pacote público confiável, ele fica fora da geração automática para não quebrar a instalação.

Exemplo de saída

A extensão gera a estrutura MCP padrão no formato mcpServers.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:senha@localhost:5432/app_db"]
    }
  }
}

Exemplo para Claude Desktop

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gitlab"],
      "env": {
        "GITLAB_URL": "https://gitlab.sua-empresa.local",
        "GITLAB_TOKEN": "<TOKEN>"
      }
    }
  }
}

O que a extensão entrega

• Resumo legível dos serviços escolhidos.
• Geração automática do JSON MCP.
• Campos de credencial com máscara para senhas.
• Opção de aplicar automaticamente para VS Code e Claude Code.
• Opção de copiar o JSON para a área de transferência.
• Opção de salvar em .vscode/mcp.easy-setup.json.

Como rodar localmente

npm run compile-web
npm test

Desenvolvimento

Se você quiser adaptar a extensão para os servidores reais da empresa, o ponto principal fica em src/web/mcpCatalog.ts.

Roadmap sugerido

• Adicionar suporte a mais clientes MCP.
• Permitir salvar perfis reutilizáveis por equipe.
• Trocar os templates genéricos pelos comandos reais da empresa.
• Exportar também arquivos prontos para Claude Desktop e outros clientes.
• Adicionar validação visual de URL, token e porta.

Licença

Descreva aqui a licença que você deseja publicar no Marketplace e no GitHub.