{"_id":"@ddmp/megazord-mcp","name":"@ddmp/megazord-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@ddmp/megazord-mcp","version":"0.1.0","description":"Servidor MCP (stdio) do Megazord — bridge fina entre clientes de IA e a API HTTP do Megazord.","keywords":["mcp","model-context-protocol","megazord","cms","ai"],"license":"MIT","author":{"name":"Megazord"},"type":"module","engines":{"node":">=20"},"bin":{"megazord-mcp":"dist/cli.js"},"publishConfig":{"access":"public"},"scripts":{"build":"tsup","dev":"tsup --watch","test":"vitest run","test:watch":"vitest","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0"},"devDependencies":{"@types/node":"^26.4.0","tsup":"^8.5.1","typescript":"^7.0.2","vitest":"^4.1.11"},"gitHead":"48d33aa464bdf60bf37b8d4077987fee6f6af656","_id":"@ddmp/megazord-mcp@0.1.0","_nodeVersion":"24.17.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-cuiXgRb5439DMqQ35nS1awXM4enNIVeN+JWPfE0gWs46zbxsRSCtofVBUjYA0cZE56LoSFuR7NtzW+9crZMb7w==","shasum":"5449d7f064723fece6e17e12dd663f80a6d7fb02","tarball":"https://registry.npmjs.org/@ddmp/megazord-mcp/-/megazord-mcp-0.1.0.tgz","fileCount":4,"unpackedSize":32516,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGSV0CdwMt1nZAC8+UZJxUCJg3rSl0dgJEEzA6dbR4u8AiEAoAo65RVsUPUuN6/vh1YTp0jPQdsszTj9zJAa68ExgEs="}]},"_npmUser":{"name":"marmottajr","email":"marcio@camposmotta.com.br"},"directories":{},"maintainers":[{"name":"marmottajr","email":"marcio@camposmotta.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/megazord-mcp_0.1.0_1787891342996_0.5601946481548037"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-28T04:29:02.834Z","0.1.0":"2026-08-28T04:29:03.144Z","modified":"2026-08-28T04:29:03.374Z"},"maintainers":[{"name":"marmottajr","email":"marcio@camposmotta.com.br"}],"description":"Servidor MCP (stdio) do Megazord — bridge fina entre clientes de IA e a API HTTP do Megazord.","keywords":["mcp","model-context-protocol","megazord","cms","ai"],"author":{"name":"Megazord"},"license":"MIT","readme":"# @ddmp/megazord-mcp\n\nServidor [MCP](https://modelcontextprotocol.io) (stdio) do **Megazord**. Ele conecta assistentes de IA — Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (Copilot), Gemini CLI — à API do Megazord, para operar CMS, sites, receitas, prompts e relatórios conversando.\n\n## O que é (e o que não é)\n\nEste pacote é uma **bridge fina**: ele autentica com a sua chave e repassa as chamadas para a API HTTP do Megazord. **As tools vivem no backend** e são descobertas em tempo real, filtradas pelas permissões da sua chave.\n\nNa prática:\n\n- **Tools novas aparecem sozinhas.** Quando o Megazord ganha uma funcionalidade, ela vira tool sem que você precise atualizar nada.\n- **A chave nunca vê mais do que você.** As permissões efetivas são o cruzamento (`chave ∩ usuário`), recalculado a cada requisição. Se você perde acesso a um módulo, a tool some.\n- **Nenhuma lógica de negócio roda na sua máquina.** O pacote não define tools, não valida schemas nem toma decisões — só transporta.\n\n## Instalação\n\nNenhuma. Os clientes de IA executam `npx -y @ddmp/megazord-mcp@latest`, que baixa (e cacheia) a versão mais recente automaticamente.\n\nRequer **Node.js 20 ou superior**.\n\n## Chave de acesso\n\n1. Entre no Megazord e abra o menu **MCP**.\n2. Clique em **Nova chave**, escolha a empresa, marque os módulos e os níveis (Ver / Adicionar / Editar / Excluir).\n3. Copie a chave `mzk_live_…` — ela é exibida **uma única vez**.\n4. Na tela **Configurar**, copie o snippet pronto do seu cliente de IA.\n\n> Trate a chave como uma senha: ela opera o Megazord em seu nome, dentro da empresa escolhida.\n\n## Variáveis de ambiente\n\n| Variável | Obrigatória | Default | Descrição |\n|---|---|---|---|\n| `MEGAZORD_API_KEY` | **sim** | — | A chave `mzk_live_…` (ou `mzk_test_…` fora de produção). Sem ela o processo sai com erro. |\n| `MEGAZORD_URL` | não | `https://megazord.app` | Base da instalação, sem barra final. Use `http://localhost:8000` em desenvolvimento. |\n| `MEGAZORD_TIMEOUT_MS` | não | `120000` | Timeout por requisição. Builds, importações e PageSpeed são lentos — não abaixe demais. |\n| `MEGAZORD_MCP_DEBUG` | não | — | `1` registra cada requisição no stderr (método, caminho, status, duração). A chave **nunca** é registrada. |\n\n## Configuração por cliente\n\n### Claude Desktop\n\n`claude_desktop_config.json` — macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\\Claude\\`.\n\n```json\n{\n  \"mcpServers\": {\n    \"megazord\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ddmp/megazord-mcp@latest\"],\n      \"env\": {\n        \"MEGAZORD_API_KEY\": \"mzk_live_xxxxxxxx_...\",\n        \"MEGAZORD_URL\": \"https://megazord.app\"\n      }\n    }\n  }\n}\n```\n\nReinicie o Claude Desktop depois de salvar.\n\n### Claude Code\n\n```bash\nclaude mcp add megazord \\\n  -e MEGAZORD_API_KEY=mzk_live_xxxxxxxx_... \\\n  -e MEGAZORD_URL=https://megazord.app \\\n  -- npx -y @ddmp/megazord-mcp@latest\n```\n\nConfira com `claude mcp list`. Para remover: `claude mcp remove megazord`.\n\n### Cursor\n\n`.cursor/mcp.json` no projeto (ou `~/.cursor/mcp.json` para todos os projetos):\n\n```json\n{\n  \"mcpServers\": {\n    \"megazord\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ddmp/megazord-mcp@latest\"],\n      \"env\": {\n        \"MEGAZORD_API_KEY\": \"mzk_live_xxxxxxxx_...\",\n        \"MEGAZORD_URL\": \"https://megazord.app\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"megazord\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ddmp/megazord-mcp@latest\"],\n      \"env\": {\n        \"MEGAZORD_API_KEY\": \"mzk_live_xxxxxxxx_...\",\n        \"MEGAZORD_URL\": \"https://megazord.app\"\n      }\n    }\n  }\n}\n```\n\n### VS Code (GitHub Copilot)\n\n`.vscode/mcp.json` — note que a chave é `servers`, e não `mcpServers`:\n\n```json\n{\n  \"servers\": {\n    \"megazord\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ddmp/megazord-mcp@latest\"],\n      \"env\": {\n        \"MEGAZORD_API_KEY\": \"mzk_live_xxxxxxxx_...\",\n        \"MEGAZORD_URL\": \"https://megazord.app\"\n      }\n    }\n  }\n}\n```\n\n### Gemini CLI\n\n`~/.gemini/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"megazord\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ddmp/megazord-mcp@latest\"],\n      \"env\": {\n        \"MEGAZORD_API_KEY\": \"mzk_live_xxxxxxxx_...\",\n        \"MEGAZORD_URL\": \"https://megazord.app\"\n      }\n    }\n  }\n}\n```\n\n### ChatGPT\n\n**Ainda não suportado.** O ChatGPT só aceita servidores MCP **remotos** (HTTP), e este pacote é um servidor **local** via stdio. Um endpoint Streamable HTTP está previsto para uma fase futura do Megazord.\n\n## Operações destrutivas\n\nTools que apagam dados ou mexem em produção/DNS têm trava dupla no backend:\n\n- a chave precisa ter a permissão de exclusão **e** o sinalizador \"permitir operações destrutivas\";\n- a chamada precisa trazer `\"confirm\": true`. Sem ele, o Megazord responde **428** e o assistente recebe uma mensagem descrevendo o que aconteceria — para ele reapresentar a você antes de prosseguir;\n- operações de produção/DNS exigem ainda um `\"totp_code\"` de 6 dígitos do seu autenticador.\n\n## Diagnóstico\n\n| Sintoma | O que fazer |\n|---|---|\n| `MEGAZORD_API_KEY não foi definida` | A variável não chegou ao processo. Confira o bloco `env` do seu cliente e reinicie-o. |\n| Nenhuma tool aparece | Rode com `MEGAZORD_MCP_DEBUG=1` e leia o stderr. Chave revogada, expirada ou sem permissão devolve lista vazia com o motivo. |\n| `package_outdated` | Rode `npx -y @ddmp/megazord-mcp@latest` (ou reinicie o cliente, que baixa a versão nova). |\n| Timeout em builds/importações | Aumente `MEGAZORD_TIMEOUT_MS`. |\n| Tool sumiu do nada | Suas permissões mudaram no painel. Peça ao assistente para listar as tools de novo. |\n\nOs logs vão **sempre para o stderr** — o stdout é o transporte do protocolo MCP.\n\n## Desenvolvimento\n\n```bash\nnpm install\nnpm test          # vitest, contra um servidor HTTP fake\nnpm run typecheck\nnpm run build     # gera dist/cli.js\n\n# teste manual ponta a ponta\nnode scripts/fake-server.mjs 8787\nMEGAZORD_URL=http://127.0.0.1:8787 MEGAZORD_API_KEY=mzk_test_ok MEGAZORD_MCP_DEBUG=1 node dist/cli.js\n```\n\n## Licença\n\nMIT\n","readmeFilename":"README.md","_rev":"1-53a884b8384bc0379449d1945b445dea"}