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

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", "@company/mcp-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.