wizz-method 1.18.2 → 1.18.3

package/README.md

@@ -21,7 +21,7 @@ O ponto de entrada técnico é o `wizz-router`: ele faz a triagem e manda pedido
 | ✍️ `wizz-copy` | Copy, e-mail, headlines | copywriting, email-sequence, humanizer, copy-editing |
 | 🔍 `wizz-seo` | SEO tradicional e de IA | seo-audit, ai-seo, schema-markup, programmatic-seo, site-architecture |
 | 📈 `wizz-growth` | Marketing, CRO, lançamento, preço, churn | marketing-ideas, page-cro, launch-strategy, pricing-strategy, churn-prevention |
-| 📢 `wizz-ads` | Mídia paga | paid-ads, ad-creative, analytics-tracking, MCP meta-ads |
+| 📢 `wizz-ads` | Mídia paga | paid-ads, ad-creative, analytics-tracking |
 | 🧠 `wizz-memoria` | Memória do projeto | cerebro |
 
 Os papéis de dev e produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, Sally, Paige), personalizados em PT-BR pelos overrides em `src/modules/wizz/overrides/`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "1.18.2",
+  "version": "1.18.3",
   "description": "Wizz Method — método de agência orientado por IA em PT-BR (fork independente do BMad Method)",
   "keywords": [
     "agile",

package/skills-registry.yaml

@@ -355,15 +355,6 @@ areas:
         not_when:
           - "Google Ads institucional, campanha de marca, lead gen B2B."
           - "Escrever copy ou criativo: a skill lê número, não produz anúncio."
-    mcps:
-      - id: meta-ads
-        when: "Gestão real de campanha Meta/Facebook/Instagram via API (criar/editar/medir ads)."
-        server:
-          command: npx
-          # Pin de supply chain (2026-08-23): versão fixa; atualizar conscientemente.
-          args: ["-y", "mcp-meta-ads@1.0.0"]
-          env:
-            META_ACCESS_TOKEN: "${META_ACCESS_TOKEN}"
 
   architect:
     agent: wizz-agent-architect

package/src/modules/wizz/README.md

@@ -11,7 +11,7 @@ Personalização do WIZZ para a Wizz: linguagem fácil e resumida, cada agente t
 | `wizz-copy` | ✍️ | Copy, e-mail, headlines | copywriting, email-sequence, humanizer, copy-editing |
 | `wizz-seo` | 🔍 | SEO tradicional e de IA | seo-audit, ai-seo, schema-markup, programmatic-seo, site-architecture |
 | `wizz-growth` | 📈 | Marketing, CRO, lançamento, preço, churn | marketing-ideas, page-cro, launch-strategy, pricing-strategy, churn-prevention |
-| `wizz-ads` | 📢 | Mídia paga | paid-ads, ad-creative, analytics-tracking, MCP meta-ads |
+| `wizz-ads` | 📢 | Mídia paga | paid-ads, ad-creative, analytics-tracking |
 | `wizz-memoria` | 🧠 | Memória do projeto | cerebro |
 
 Os papéis de dev/produto reusam os agentes WIZZ (Mary, John, Winston, Amelia, Sally, Paige), personalizados em PT-BR pelos overrides em `overrides/`.

package/src/modules/wizz/_shared/model-ladder.md

@@ -14,6 +14,8 @@ O modelo da sessão principal é o chefe: orquestra, arbitra conflito entre exec
 
 Como saber quem é o chefe em Claude Code: o system prompt declara o modelo da sessão ("You are powered by the model named ..."). Fable e Mythos ficam acima de Opus.
 
+A mesma lógica vale em toda plataforma, trocando os nomes pelos da tabela abaixo. Em Codex: sessão num modelo acima de gpt-5.6 (ex.: astra) → `wizz-exec-opus` (gpt-5.6, effort high) é o destino padrão do difícil e `wizz-exec-review` roda nele; sessão já em gpt-5.6 → o chefe absorve o degrau Forte. Em OpenCode e Gemini CLI, idem com claude-opus-5 e gemini-3-pro-preview.
+
 ## Tabela de degraus
 
 | Degrau | Subagente | Uso | Claude Code | Codex | OpenCode | Gemini CLI |

package/src/modules/wizz/agents/wizz-ads/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: wizz-ads
-description: Wizz Method Paid Media Agent. Use when you need ad campaigns (Google, Meta, TikTok, LinkedIn), ad creatives, and tracking. Routes to paid-ads, ad-creative and analytics-tracking, and uses the meta-ads MCP for real management on Meta.
+description: Wizz Method Paid Media Agent. Use when you need ad campaigns (Google, Meta, TikTok, LinkedIn), ad creatives, and tracking. Routes to paid-ads, ad-creative and analytics-tracking.
 ---
 
 # Ads — Mídia Paga
 
 ## Visão geral
-Você é o Ads do Wizz. Planeja campanhas, gera variações de criativo e acompanha métricas. Roteia para as skills globais via a ferramenta `Skill` e usa o MCP `meta-ads` quando for gestão real de campanhas Meta.
+Você é o Ads do Wizz. Planeja campanhas, gera variações de criativo e acompanha métricas. Roteia para as skills globais via a ferramenta `Skill`.
 
 ## Na ativação
 1. **Resolver bloco:** rode `python3 {project-root}/_wizz/scripts/resolve_customization.py --skill {skill-root} --key agent`. Se falhar, mescle base → time → pessoal (`{skill-root}/customize.toml`, `{project-root}/_wizz/custom/{skill-name}.toml`, `.user.toml`).
@@ -20,13 +20,10 @@ Você é o Ads do Wizz. Planeja campanhas, gera variações de criativo e acompa
 
 ## Como trabalho (ponte global)
 
-> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`ads`) vive no `skills-registry.yaml`. Resolva primeiro a **fatia leve da sua área**, `{project-root}/_wizz/_config/registry/ads.yaml` (já vem como o bloco `areas.ads` completo); se faltar (install antigo), caia pro monólito na ordem `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml` e ache o bloco `areas.ads` lá dentro. Precisando de algo cross-cutting (utility/mcp_utility/cli_utility/squads), leia `{project-root}/_wizz/_config/registry/_shared.yaml`. Ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`, ex. `meta-ads`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega novidades automático (ex. `arcads` p/ gerar vídeo-ad).
+> **Fonte única (registry) — leia SEMPRE antes dos exemplos abaixo:** a lista real da sua área (`ads`) vive no `skills-registry.yaml`. Resolva primeiro a **fatia leve da sua área**, `{project-root}/_wizz/_config/registry/ads.yaml` (já vem como o bloco `areas.ads` completo); se faltar (install antigo), caia pro monólito na ordem `{project-root}/_wizz/_config/skills-registry.yaml` → `{project-root}/_wizz/skills-registry.yaml` → `{project-root}/skills-registry.yaml` e ache o bloco `areas.ads` lá dentro. Precisando de algo cross-cutting (utility/mcp_utility/cli_utility/squads), leia `{project-root}/_wizz/_config/registry/_shared.yaml`. Ofereça **tudo que casar** com o pedido pelo `when:` — `skills:` (via `Skill`), `clis:` (`check:` → se faltar mostre o `install:`, opt-in, respeite `platform:`) e `mcps:` (`claude mcp add <id>` com o bloco `server`). Os exemplos abaixo são atalho legível; o registry é a verdade e pega novidades automático (ex. `arcads` p/ gerar vídeo-ad).
 - Estratégia de campanha, segmentação, lances, ROAS → `paid-ads`
 - Variações de criativo, headlines, copy de anúncio → `ad-creative`
 - Tracking, conversões, UTMs, pixel → `analytics-tracking`
-- Gestão real de campanha Meta (criar/editar/medir) → MCP `meta-ads`
-
-Nunca exponha o `META_ACCESS_TOKEN` em log ou código.
 
 ## Encerramento
 Termine com `✅ O que fiz` / `➡️ Próximo passo` / `🎯 Comando`.

package/src/modules/wizz/agents/wizz-ads/customize.toml

@@ -21,12 +21,10 @@ activation_steps_append = [
 
 persistent_facts = [
   "Gate de planejamento: pedido de execução com complexidade alta e sem PRD/story/brief correspondente → pergunto 1x se crio o artefato antes (recomendado) ou pulo; nunca 2x na mesma cadeia. Regras completas: ler _shared/planning-gate.md do módulo wizz SÓ quando o gate disparar.",
-  "Nunca exponho o META_ACCESS_TOKEN em log, código ou commit.",
-  "Para gestão real de Meta uso o MCP meta-ads; para estratégia uso a skill paid-ads.",
   "Falo PT-BR fácil. Toda campanha precisa de tracking antes de subir.",
 ]
 
-role = "Planejar e gerenciar mídia paga (estratégia, criativo, tracking) roteando para as skills globais e para o MCP meta-ads."
+role = "Planejar e gerenciar mídia paga (estratégia, criativo, tracking) roteando para as skills globais."
 identity = "Gestor de tráfego orientado a ROAS: testa criativos, corta o que não performa, escala o que funciona."
 communication_style = "Direto e numérico, em PT-BR fácil. Fala em CPA, ROAS e próximos testes."
 
@@ -51,8 +49,3 @@ prompt = "Invoque a skill GLOBAL 'ad-creative' via a ferramenta Skill para gerar
 code = "TR"
 description = "Tracking, conversões, UTMs, pixel"
 prompt = "Invoque a skill GLOBAL 'analytics-tracking' via a ferramenta Skill."
-
-[[agent.menu]]
-code = "ME"
-description = "Gestão real de campanha Meta (criar/editar/medir)"
-prompt = "Use o MCP 'meta-ads' (via ToolSearch para carregar as ferramentas) para gerenciar campanhas reais no Meta. Nunca exponha o token."

package/src/modules/wizz/agents/wizz-maestro/SKILL.md

@@ -75,7 +75,7 @@ O Diretor (`wizz-router`) já fez a triagem e te entregou porque é complexo. Se
 2. **Enriquecimento = o `skills-registry.yaml`**. Para a área escolhida, ele diz O QUE o agente puxa:
    - `areas:` — `agent` (deve casar com o do menu) e `skills:` (cada uma com `id` + `when` curto). Instrua o agente a invocar a(s) skill(s) global(is) cujo `when` casa com o pedido.
    - `utility:` — skills cross-cutting (find-skills, enhance-prompt, wizz-router). Ofereça quando couber.
-   - `mcps:` (por área) e `mcp_utility:` (cross-cutting) — MCP servers que a área usa pra AGIR de verdade (ex: architect→supabase, ads→meta-ads, analyst→exa, util→context7; qa NÃO usa MCP de browser — é agent-browser via CLI). Se o pedido precisa de acesso real à ferramenta e o MCP não está ativo (`claude mcp list`), proponha `claude mcp add <id> -- <command>` usando o bloco `server` do registry (secrets via env/placeholder).
+   - `mcps:` (por área) e `mcp_utility:` (cross-cutting) — MCP servers que a área usa pra AGIR de verdade (ex: architect→supabase, analyst→exa, util→context7; qa NÃO usa MCP de browser — é agent-browser via CLI). Se o pedido precisa de acesso real à ferramenta e o MCP não está ativo (`claude mcp list`), proponha `claude mcp add <id> -- <command>` usando o bloco `server` do registry (secrets via env/placeholder).
    - `clis:` (por área) e `cli_utility:` (cross-cutting) — ferramentas de linha de comando que o agente chama direto (não são skill nem MCP): ex. qa→agent-browser; designer→hyperframes/claude-video/buttercut/voicebox (vídeo); ads→arcads; growth→scrapling; seo→distribb. Quando o `when:` casar com o pedido, ofereça a tool: rode o `check:` pra ver se já está instalada; se não, mostre o `install:` (opt-in, nunca auto-rode sem confirmar). Respeite o campo `platform:` — se presente e não casar com o OS/arch atual, NÃO ofereça (ex.: `buttercut` é `darwin-arm64`, só Apple Silicon). Clone-and-run (buttercut/voicebox/arcads) instala no projeto; avise sobre deps pesadas.
    - `squads:` — painéis consultivos (rodam via `wizz-party-mode`). Quando o pedido pedir validação/estratégia de um `domain`, rode o squad ANTES do agente em `advises` executar.
 

package/src/modules/wizz/module.yaml

@@ -114,7 +114,7 @@ agents:
     title: Mídia Paga
     icon: "📢"
     team: wizz
-    description: "Gerencia anúncios pagos roteando para paid-ads, ad-creative e analytics-tracking (e o MCP meta-ads). Cria variações de criativo e acompanha métricas."
+    description: "Gerencia anúncios pagos roteando para paid-ads, ad-creative e analytics-tracking. Cria variações de criativo e acompanha métricas."
 
   - code: wizz-memoria
     name: Memória

package/src/skills-lib/ad-creative/SKILL.md

@@ -335,7 +335,7 @@ For pulling performance data and managing campaigns, see the [tools registry](..
 | Platform | Pull Performance Data | Manage Campaigns | Guide |
 |----------|:---------------------:|:----------------:|-------|
 | **Google Ads** | `google-ads campaigns list`, `google-ads reports get` | `google-ads campaigns create` | [google-ads.md](../../tools/integrations/google-ads.md) |
-| **Meta Ads** | `meta-ads insights get` | `meta-ads campaigns list` | [meta-ads.md](../../tools/integrations/meta-ads.md) |
+| **Meta Ads** | - | - | - |
 | **LinkedIn Ads** | `linkedin-ads analytics get` | `linkedin-ads campaigns list` | [linkedin-ads.md](../../tools/integrations/linkedin-ads.md) |
 | **TikTok Ads** | `tiktok-ads reports get` | `tiktok-ads campaigns list` | [tiktok-ads.md](../../tools/integrations/tiktok-ads.md) |
 

package/src/skills-lib/paid-ads/SKILL.md

@@ -298,7 +298,7 @@ For implementation, see the [tools registry](../../tools/REGISTRY.md). Key adver
 | Platform | Best For | MCP | Guide |
 |----------|----------|:---:|-------|
 | **Google Ads** | Search intent, high-intent traffic | ✓ | [google-ads.md](../../tools/integrations/google-ads.md) |
-| **Meta Ads** | Demand gen, visual products, B2C | - | [meta-ads.md](../../tools/integrations/meta-ads.md) |
+| **Meta Ads** | Demand gen, visual products, B2C | - | - |
 | **LinkedIn Ads** | B2B, job title targeting | - | [linkedin-ads.md](../../tools/integrations/linkedin-ads.md) |
 | **TikTok Ads** | Younger demographics, video | - | [tiktok-ads.md](../../tools/integrations/tiktok-ads.md) |
 

package/src/skills-lib/wizz-router/references/routing-table-flat.md

@@ -59,8 +59,7 @@ Use esta tabela pra mapear skills/CLIs/MCPs direto **fora de projeto Wizz** (sem
 | Intenção / palavras-chave | Skills a oferecer | Prioridade |
 |---|---|---|
 | Ideias de marketing, estratégia de marketing, posicionamento | `marketing-ideas` + `marketing-psychology` + `product-marketing-context` | 1 |
-| Paid ads, anúncios, Google Ads, Meta Ads, TikTok Ads, mídia paga | `paid-ads` + `ad-creative` + `analytics-tracking` + **MCP meta-ads** | 1 |
-| Gestão de campanha Meta/Facebook/Instagram via API real | **MCP meta-ads** (`mcp-meta-ads`) direto | 1 |
+| Paid ads, anúncios, Google Ads, Meta Ads, TikTok Ads, mídia paga | `paid-ads` + `ad-creative` + `analytics-tracking` | 1 |
 | Pixel/UTM/atribuição erradas, "a venda não bate com o gerenciador", "onde está furando o funil", tráfego orgânico inflado, conferir tracking antes de subir campanha | `tracking-audit` (+ `analytics-tracking` se for SaaS/produto) | 1 |
 | Lançamento de feature, lançamento de produto, go-to-market | `launch-strategy` + `social-content` + `email-sequence` | 1 |
 | Site pronto pra subir, pré-lançamento de SITE, "revisa antes do deploy", checklist de go-live, ou item pontual pré-lançamento (og:image/prévia de link, FAQ com schema, robots.txt, LGPD, alt text) | `site-launch-kit` | 1 |
@@ -97,6 +96,4 @@ Quando nenhuma skill/MCP instalado cobrir o pedido, **classifique o que falta**
 
 **Falta um MCP:** informe → `claude mcp list` → consulte `skills-registry.yaml` (`mcps:`/`mcp_utility:`, com `server` pronto) → proponha `claude mcp add <id> [-e VAR=$VAR] -- <command> [args]`. Secrets sempre via env/placeholder, nunca token real.
 
-MCPs comuns: context7 (docs de libs), supabase (Postgres), meta-ads (Meta), exa (pesquisa). Browser/E2E é sempre via CLI `agent-browser`, nunca via MCP Playwright.
-
-Para paid ads Meta, o MCP `mcp-meta-ads` dá acesso real à API Meta Marketing (campanhas, ad sets, ads, métricas, criativos). Combine com `paid-ads` + `ad-creative` + `analytics-tracking`. O `META_ACCESS_TOKEN` vem de env local: nunca exponha em logs ou código commitado.
+MCPs comuns: context7 (docs de libs), supabase (Postgres), exa (pesquisa). Browser/E2E é sempre via CLI `agent-browser`, nunca via MCP Playwright.

package/tools/installer/core/installer.js

@@ -4,7 +4,7 @@ const { Manifest } = require('./manifest');
 const { OfficialModules } = require('../modules/official-modules');
 const { installSkillsLib } = require('../modules/skills-lib');
 const { writeMcpConfig, renderAddCommand, prepareMcps, partitionAlreadyConfigured } = require('../modules/mcp-config');
-const { promptMissingEnvVars } = require('../modules/env-vars');
+const { promptMissingEnvVars, mcpsWithMissingRequiredEnv } = require('../modules/env-vars');
 const { installClis, renderInstallCommand } = require('../modules/cli-config');
 const { writeDepsCache, readPreviousMcpPins } = require('../modules/deps-cache');
 const { IdeManager } = require('../ide/manager');
@@ -423,7 +423,7 @@ class Installer {
               // is still cheap for an already-installed binary: prepareMcp is
               // detect-first, so only a genuinely missing binary pays for the
               // network-heavy install/post_install steps.
-              const { ready: mcpsReady, failed: mcpsFailed } = await prepareMcps({ mcps: toWrite });
+              let { ready: mcpsReady, failed: mcpsFailed } = await prepareMcps({ mcps: toWrite });
               for (const f of mcpsFailed) {
                 await prompts.log.warn(
                   `MCP ${f.id} não pôde ser preparado (${f.error}). Config NÃO escrita para evitar ENOENT — instale manualmente e adicione depois com \`claude mcp add\`.`,
@@ -451,10 +451,27 @@ class Installer {
                   mcps: mcpsReady,
                 });
                 const envInteractive = !config.skipPrompts && !!process.stdin.isTTY;
-                await promptMissingEnvVars(mcpsForEnvVars, {
+                const envResult = await promptMissingEnvVars(mcpsForEnvVars, {
                   projectDir: paths.projectRoot,
                   interactive: envInteractive,
                 });
+
+                // A required (no-default) var that stayed unresolved means
+                // the server would be written with a permanently-broken
+                // literal `${VAR}` — never write it (E1: never fail the
+                // install, just drop that server and tell the user how to
+                // retry).
+                const missingEnv = mcpsWithMissingRequiredEnv(mcpsReady, envResult.skipped);
+                if (missingEnv.length > 0) {
+                  const missingIds = new Set(missingEnv.map((m) => m.id));
+                  mcpsReady = mcpsReady.filter((m) => !missingIds.has(m.id));
+                  for (const m of missingEnv) {
+                    await prompts.log.warn(
+                      `MCP ${m.id} não gravado: faltou ${m.missing.join(', ')}. Rode o installer de novo quando tiver a chave, ou adicione com \`claude mcp add\`.`,
+                    );
+                  }
+                  addResult('MCP servers', 'warn', `não gravados por falta de env var: ${missingEnv.map((m) => m.id).join(', ')}`);
+                }
               } catch (error) {
                 await prompts.log.warn(`Falha ao configurar env vars dos MCPs: ${error.message}`);
                 addResult('MCP env vars', 'warn', error.message);

package/tools/installer/modules/env-vars.js

@@ -589,9 +589,50 @@ async function promptMissingEnvVars(mcps, opts = {}) {
   };
 }
 
+/**
+ * Find which of `mcps` have at least one REQUIRED (`hasDefault: false`) env
+ * placeholder that stayed unresolved, per the `skipped` list returned by
+ * `promptMissingEnvVars`/`resolveEnvVars`. A var WITH a default
+ * (`hasDefault: true`) is fine even when skipped — the Claude Code runtime
+ * resolves `${VAR:-default}` itself — so only `hasDefault: false` entries
+ * count here.
+ *
+ * Writing a server whose required placeholder never resolved to anywhere
+ * (not `process.env`, not `.env`, not the global store, not typed
+ * interactively) would embed a literal, permanently-broken `${VAR}` into
+ * `.mcp.json`: the server sits in the config but can never actually start.
+ * Callers use this to drop such a server from the write instead. Pure: no
+ * I/O.
+ *
+ * @param {Array<{id: string}>} mcps - Resolved MCP entries to check
+ * @param {Array<{name: string, mcpIds: string[], hasDefault: boolean}>} [skipped]
+ *   - The `skipped` array from `promptMissingEnvVars`/`resolveEnvVars`
+ * @returns {Array<{id: string, missing: string[]}>} One entry per affected
+ *   MCP id, with the names of its unresolved required vars (in encounter order)
+ */
+function mcpsWithMissingRequiredEnv(mcps, skipped) {
+  const missingByMcpId = new Map();
+  for (const entry of skipped || []) {
+    if (!entry || entry.hasDefault) continue;
+    for (const id of entry.mcpIds || []) {
+      if (!missingByMcpId.has(id)) missingByMcpId.set(id, []);
+      missingByMcpId.get(id).push(entry.name);
+    }
+  }
+
+  const result = [];
+  for (const mcp of mcps || []) {
+    if (mcp && mcp.id && missingByMcpId.has(mcp.id)) {
+      result.push({ id: mcp.id, missing: missingByMcpId.get(mcp.id) });
+    }
+  }
+  return result;
+}
+
 module.exports = {
   extractEnvPlaceholders,
   resolveEnvVars,
+  mcpsWithMissingRequiredEnv,
   persistEnvValues,
   persistProjectEnv,
   persistGlobalEnv,

package/tools/installer/modules/mcp-config.js

@@ -326,25 +326,101 @@ async function partitionAlreadyConfigured({ projectDir, mcps }) {
   return { toPrepare, alreadyConfigured };
 }
 
+/**
+ * Resolve the set of MCP ids covered by an installed Claude Code plugin
+ * (`~/.claude/plugins/installed_plugins.json`). A plugin key in that file's
+ * `plugins` map is `<name>@<marketplace>` (e.g.
+ * `supabase@claude-plugins-official`); the plugin covers catalog MCP id
+ * `<name>`. If the plugin ships its own `.mcp.json`
+ * (`<installPath>/.mcp.json`, `installPath` from the plugin's install
+ * record) with an `mcpServers` block, every key in that block is ALSO
+ * covered (e.g. the `vercel` plugin ships a server named `vercel`).
+ *
+ * Read failures at the top level (missing/malformed
+ * `installed_plugins.json`) fall back to "nothing covered", same spirit as
+ * the `~/.claude.json` handling in `partitionGloballyConfigured`. A failure
+ * reading ONE plugin's own `.mcp.json` (missing `installPath`, missing
+ * file, malformed JSON) only skips that plugin's extra ids — the plugin's
+ * own name stays covered, since that didn't require reading anything past
+ * the already-parsed top-level file.
+ *
+ * @param {string} [installedPluginsPath] - Override of
+ *   `~/.claude/plugins/installed_plugins.json` (tests)
+ * @returns {Promise<Set<string>>}
+ */
+async function resolvePluginCoveredIds(installedPluginsPath) {
+  const file = installedPluginsPath || path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+  const ids = new Set();
+
+  if (!(await fs.pathExists(file))) return ids;
+
+  let data;
+  try {
+    data = JSON.parse(await fs.readFile(file, 'utf8'));
+  } catch {
+    return ids;
+  }
+
+  const plugins = data && typeof data === 'object' && data.plugins && typeof data.plugins === 'object' ? data.plugins : null;
+  if (!plugins) return ids;
+
+  for (const [key, entries] of Object.entries(plugins)) {
+    const name = String(key).split('@')[0];
+    if (name) ids.add(name);
+
+    if (!Array.isArray(entries)) continue;
+    for (const entry of entries) {
+      const installPath = entry && entry.installPath;
+      if (!installPath || typeof installPath !== 'string') continue;
+
+      const mcpJsonPath = path.join(installPath, '.mcp.json');
+      try {
+        if (!(await fs.pathExists(mcpJsonPath))) continue;
+        const mcpConfig = JSON.parse(await fs.readFile(mcpJsonPath, 'utf8'));
+        const servers =
+          mcpConfig && typeof mcpConfig === 'object' && mcpConfig.mcpServers && !Array.isArray(mcpConfig.mcpServers)
+            ? mcpConfig.mcpServers
+            : null;
+        if (servers) {
+          for (const serverKey of Object.keys(servers)) ids.add(serverKey);
+        }
+      } catch {
+        // Malformed/unreadable plugin .mcp.json: skip its extra ids, the
+        // plugin's own name (added above) stays covered.
+      }
+    }
+  }
+
+  return ids;
+}
+
 /**
  * Split resolved MCP entries into those still worth offering/installing in
- * the project and those the user already configured GLOBALLY (user scope, the
- * `mcpServers` key of `~/.claude.json`). A server configured there is live in
- * every project already — usually with the real key embedded — so writing the
- * registry's `${VAR}`-placeholder copy into the project `.mcp.json` would at
- * best duplicate it and at worst shadow a working global config with a broken
- * placeholder one, then prompt the user for a key they already provided.
+ * the project and those the user already has covered elsewhere: configured
+ * GLOBALLY (user scope, the `mcpServers` key of `~/.claude.json`), or
+ * covered by an installed Claude Code PLUGIN
+ * (`~/.claude/plugins/installed_plugins.json`, see
+ * `resolvePluginCoveredIds`). Either way, the server is already live —
+ * usually with the real key embedded — so writing the registry's
+ * `${VAR}`-placeholder copy into the project `.mcp.json` would at best
+ * duplicate it and at worst shadow a working config with a broken
+ * placeholder one, then prompt the user for a key they already have.
  *
- * Read failures (missing/malformed `~/.claude.json`) fall back to "nothing is
- * global", the safe default: worst case the user sees the old behavior.
+ * Read failures (missing/malformed `~/.claude.json` or
+ * `installed_plugins.json`) fall back to "nothing is global"/"nothing is
+ * plugin-covered", the safe default: worst case the user sees the old
+ * behavior. An id present in BOTH sources is reported once, in
+ * `globallyConfigured` only (never duplicated into `pluginCovered`).
  *
  * @param {Object} args
  * @param {Array<{id: string}>} args.mcps - Resolved MCP entries to partition
  * @param {string} [args.claudeJsonPath] - Override of `~/.claude.json` (tests)
- * @returns {Promise<{toInstall: Array<Object>, globallyConfigured: string[]}>}
+ * @param {string} [args.installedPluginsPath] - Override of
+ *   `~/.claude/plugins/installed_plugins.json` (tests)
+ * @returns {Promise<{toInstall: Array<Object>, globallyConfigured: string[], pluginCovered: string[]}>}
  */
-async function partitionGloballyConfigured({ mcps, claudeJsonPath }) {
-  if (!mcps || mcps.length === 0) return { toInstall: [], globallyConfigured: [] };
+async function partitionGloballyConfigured({ mcps, claudeJsonPath, installedPluginsPath }) {
+  if (!mcps || mcps.length === 0) return { toInstall: [], globallyConfigured: [], pluginCovered: [] };
 
   const file = claudeJsonPath || path.join(os.homedir(), '.claude.json');
   let globalIds = new Set();
@@ -359,13 +435,21 @@ async function partitionGloballyConfigured({ mcps, claudeJsonPath }) {
     }
   }
 
+  const pluginIds = await resolvePluginCoveredIds(installedPluginsPath);
+
   const toInstall = [];
   const globallyConfigured = [];
+  const pluginCovered = [];
   for (const mcp of mcps) {
-    if (mcp && mcp.id && globalIds.has(mcp.id)) globallyConfigured.push(mcp.id);
-    else toInstall.push(mcp);
+    if (mcp && mcp.id && globalIds.has(mcp.id)) {
+      globallyConfigured.push(mcp.id);
+    } else if (mcp && mcp.id && pluginIds.has(mcp.id)) {
+      pluginCovered.push(mcp.id);
+    } else {
+      toInstall.push(mcp);
+    }
   }
-  return { toInstall, globallyConfigured };
+  return { toInstall, globallyConfigured, pluginCovered };
 }
 
 /**

package/tools/installer/ui.js

@@ -629,9 +629,14 @@ class UI {
     // duplicate config and re-prompt for a key that already works. Filter it
     // out of every path below (multiselect, --mcps, --yes) with an info line
     // so nothing disappears silently.
-    const { toInstall, globallyConfigured } = await partitionGloballyConfigured({ mcps: resolved });
+    const { toInstall, globallyConfigured, pluginCovered } = await partitionGloballyConfigured({ mcps: resolved });
     if (globallyConfigured.length > 0) {
       await prompts.log.info(`MCPs já configurados no seu Claude global (~/.claude.json), pulados: ${globallyConfigured.join(', ')}`);
+    }
+    if (pluginCovered.length > 0) {
+      await prompts.log.info(`MCPs já cobertos por plugin do Claude Code (user scope), pulados: ${pluginCovered.join(', ')}`);
+    }
+    if (globallyConfigured.length > 0 || pluginCovered.length > 0) {
       resolved = toInstall;
       if (resolved.length === 0) return { toWrite: [], toRecommend: [] };
     }