Claude Code, Cursor, VS Code e Codex

O init escreve no formato certo de cada cliente e preserva o que já existe.

Claude Code

npx -y moretes-builder-workshops init claude

.mcp.json

{ "mcpServers": { "builder-workshops": { "type": "stdio", "command": "npx", "args": ["-y", "moretes-builder-workshops", "mcp"] } } }

Cursor

npx -y moretes-builder-workshops init cursor

.cursor/mcp.json

{ "mcpServers": { "builder-workshops": { "type": "stdio", "command": "npx", "args": ["-y", "moretes-builder-workshops", "mcp"] } } }

VS Code

npx -y moretes-builder-workshops init vscode

Atenção: aqui a chave é servers, não mcpServers.

.vscode/mcp.json

{ "servers": { "builder-workshops": { "type": "stdio", "command": "npx", "args": ["-y", "moretes-builder-workshops", "mcp"] } } }

Codex

npx -y moretes-builder-workshops init codex

Instala a skill em .agents/skills/. O servidor MCP se configura no próprio Codex, com o comando npx -y moretes-builder-workshops mcp.

Docker em qualquer cliente

Para quem prefere não ter Node.js:

{ "mcpServers": { "builder-workshops": { "command": "docker", "args": ["run", "--rm", "-i", "ghcr.io/fernando-moretes/builder-workshops", "mcp"] } } }

O que foi testado

Cliente	Situação
Cliente oficial do MCP (SDK)	Testado automaticamente em cada mudança
Claude Code	Detecta o servidor do repo. O uso pede sua aprovação na primeira vez
Kiro, Cursor, VS Code	Formato conferido na documentação oficial, sem teste no aplicativo

Se testar em algum destes, abra um relato.