Servidor MCP
O servidor MCP do GenPM dá ao seu agente o mesmo motor do CLI: ele pode buscar, inspecionar e injetar módulos, e pergunta antes de mexer em qualquer coisa fora do seu código.
O jeito mais rápido é deixar o GenPM escrever a configuração dos clientes que ele detecta no seu projeto:
genpm mcp setupEle mostra a mudança exata e pergunta antes de escrever. Use --client e --scope para escolher um, ou configure à mão abaixo.
O servidor vem dentro do binário genpm: seu cliente executa genpm mcp serve, sem Node.js. Sem o binário, use o pacote do npm: troque genpm mcp serve por npx -y @genpm-net/mcp ("command": "npx", "args": ["-y", "@genpm-net/mcp"]) nos exemplos abaixo; genpm mcp setup rodado via npm ou npx faz isso por você.
Claude Code
claude mcp add genpm -- genpm mcp serveIsso registra o servidor para o seu usuário. Para compartilhar com o time, faça commit de um .mcp.json na raiz do projeto (genpm mcp setup --client claude --scope project o escreve):
{
"mcpServers": {
"genpm": { "command": "genpm", "args": ["mcp", "serve"] }
}
}Cursor
Projeto: .cursor/mcp.json. Usuário: ~/.cursor/mcp.json.
{
"mcpServers": {
"genpm": { "command": "genpm", "args": ["mcp", "serve"] }
}
}genpm mcp setup --client cursor # projeto
genpm mcp setup --client cursor --scope user # usuárioVS Code (GitHub Copilot)
Projeto: .vscode/mcp.json (repare na chave servers e no type):
{
"servers": {
"genpm": { "type": "stdio", "command": "genpm", "args": ["mcp", "serve"] }
}
}Usuário:
code --add-mcp '{"name":"genpm","command":"genpm","args":["mcp","serve"]}'Windsurf
Só usuário: ~/.codeium/windsurf/mcp_config.json.
{
"mcpServers": {
"genpm": { "command": "genpm", "args": ["mcp", "serve"] }
}
}genpm mcp setup --client windsurfCodex
Só usuário: ~/.codex/config.toml.
[mcp_servers.genpm]
command = "genpm"
args = ["mcp", "serve"]genpm mcp setup --client codexGemini CLI
Projeto: .gemini/settings.json · Usuário: ~/.gemini/settings.json. Só mcpServers é alterado; o resto das suas configurações do Gemini fica igual.
{ "mcpServers": { "genpm": { "command": "genpm", "args": ["mcp", "serve"] } } }genpm mcp setup --client gemini --scope projectServidor remoto (somente leitura)
Clientes que suportam servidores MCP remotos via Streamable HTTP podem se conectar a https://mcp.genpm.net sem instalar nada. Ele só oferece genpm_search e genpm_info (sem arquivos nem credenciais): para instalar, o agente te passa o comando genpm add ou você usa o servidor local acima.
{ "mcpServers": { "genpm": { "url": "https://mcp.genpm.net" } } }Ferramentas
| Ferramenta | O que faz |
|---|---|
genpm_search |
Busca pacotes pela necessidade. Nunca retorna resultados patrocinados. |
genpm_info |
Manifesto, dependências, variáveis de ambiente, servidores MCP e regras de IA. |
genpm_add |
Planeja (dryRun: true) e injeta. allowMcp e installNpmDeps precisam do seu consentimento. |
genpm_list |
Pacotes instalados com mudanças locais. |
genpm_remove |
Remove um pacote; nunca apaga código que você modificou. |
genpm_outdated |
Versões mais novas disponíveis. |
genpm_diff |
Patch upstream de um pacote instalado e as suas mudanças locais. |
genpm_update |
Atualiza com merge de três vias ou registra um patch que o agente já aplicou (strategy: "ai"). |
genpm_audit |
Integridade, assinaturas e avisos de segurança. |
genpm_validate |
Valida um pacote que você está criando. |
O servidor não tem force, publish nem login. As regras dos pacotes são devolvidas como conteúdo de terceiros (<package-rules trust="third-party">): descrevem um módulo e nunca autorizam ações que você não pediu.
Prompts
genpm-find: busca → info → simulação → confirmação → instalação.genpm-integrate: lê<d>/AGENTS.mde integra o módulo na aplicação.
Servidores MCP declarados por pacotes
Um pacote pode declarar os servidores MCP de que precisa (por exemplo, o do Stripe). Eles nunca são adicionados em silêncio: genpm add pergunta antes, --no-mcp os ignora e você pode adicioná-los depois com genpm mcp add <pacote>. Os segredos são referenciados como variáveis de ambiente (${STRIPE_SECRET_KEY} no .mcp.json, ${env:STRIPE_SECRET_KEY} no Cursor e no VS Code), nunca escritos como valores.
Solução de problemas
- O cliente não vê as ferramentas: reinicie o cliente depois de mudar a configuração; confira se
genpm mcp serveinicia em um terminal (ele fica esperando entrada; pare com Ctrl+C). - O cliente não encontra o
genpm: alguns apps não leem oPATHdo seu shell. Use o caminho absoluto como comando:which genpmmostra no macOS e no Linux (por exemplo/Users/voce/.genpm/bin/genpm),where.exe genpmno Windows. - Telemetria: defina
GENPM_TELEMETRY=0(ouDO_NOT_TRACK=1) noenvdo servidor. - Outro registry: defina
GENPM_REGISTRYnoenvdo servidor.