bflabs-mcp 1.0.2 → 1.0.4

package/bin/bflabs-mcp.js

@@ -5,22 +5,41 @@ import { provision, TOOLS } from "../lib/installer.js";
 import { writeMcpConfig } from "../lib/config-writer.js";
 import { writeSkill } from "../lib/skill-writer.js";
 
-console.log();
-console.log(chalk.bold.cyan("  ╔══════════════════════════════════════╗"));
-console.log(chalk.bold.cyan("  ║            BF MCP  v1.0.0            ║"));
-console.log(chalk.bold.cyan("  ╚══════════════════════════════════════╝"));
-console.log();
+const VERSION = "1.0.3";
+const MCP_SERVER_NAME = "bflabs-ads-manager";
 
-try {
-  const tool = await select({
-    message: "Which tool do you want to install?",
-    choices: TOOLS,
-  });
+function printBanner() {
+  console.log();
+  console.log(chalk.bold.cyan("  ╔══════════════════════════════════════╗"));
+  console.log(chalk.bold.cyan(`  ║          BF MCP  v${VERSION}           ║`));
+  console.log(chalk.bold.cyan("  ╚══════════════════════════════════════╝"));
+  console.log();
+}
+
+async function install() {
+  printBanner();
 
-  const email = await input({
-    message: "Enter your email:",
-    validate: (v) => v.includes("@") || "Enter a valid email",
-  });
+  let tool;
+  try {
+    tool = await select({
+      message: "Which tool do you want to install?",
+      choices: TOOLS,
+    });
+  } catch (err) {
+    if (err.name === "ExitPromptError") { console.log(chalk.dim("\n  Cancelled.")); process.exit(0); }
+    throw err;
+  }
+
+  let email;
+  try {
+    email = await input({
+      message: "Enter your email:",
+      validate: (v) => v.includes("@") || "Enter a valid email",
+    });
+  } catch (err) {
+    if (err.name === "ExitPromptError") { console.log(chalk.dim("\n  Cancelled.")); process.exit(0); }
+    throw err;
+  }
 
   process.stdout.write(chalk.dim("  ◌ Authenticating..."));
 
@@ -33,26 +52,71 @@ try {
     process.exit(1);
   }
 
-  // Write MCP config
-  const serverName = `bflabs-${tool}`;
-  const written = writeMcpConfig(serverName, data.mcp_url, data.api_key);
+  // Always use single server name regardless of tool
+  const written = writeMcpConfig(MCP_SERVER_NAME, data.mcp_url, data.api_key);
   console.log(chalk.green("  ✓ MCP configured") + chalk.dim(` → ${written[0] || "~/.claude"}`));
 
-  // Write skill
   const skillPath = writeSkill(tool);
   console.log(chalk.green("  ✓ Skill installed") + chalk.dim(` → ${skillPath}`));
 
   console.log();
   console.log(chalk.bold("  Done! Restart Claude to activate."));
   console.log();
-  console.log(
-    chalk.dim("  MCP:   ") +
-    chalk.cyan(serverName) +
-    chalk.dim(" → ") +
-    chalk.underline(data.mcp_url)
-  );
+  console.log(chalk.dim("  MCP:   ") + chalk.cyan(MCP_SERVER_NAME) + chalk.dim(" → ") + chalk.underline(data.mcp_url));
   console.log(chalk.dim("  User:  ") + data.user_name + chalk.dim(` (${data.role})`));
+  if (data.scope && data.scope !== "full") {
+    console.log(chalk.dim("  Scope: ") + chalk.yellow(data.scope));
+  }
   console.log();
+}
+
+async function update() {
+  printBanner();
+  console.log(chalk.dim("  Refreshing your API key and permissions...\n"));
+
+  let email;
+  try {
+    email = await input({
+      message: "Enter your email:",
+      validate: (v) => v.includes("@") || "Enter a valid email",
+    });
+  } catch (err) {
+    if (err.name === "ExitPromptError") { console.log(chalk.dim("\n  Cancelled.")); process.exit(0); }
+    throw err;
+  }
+
+  process.stdout.write(chalk.dim("  ◌ Refreshing credentials..."));
+
+  let data;
+  try {
+    data = await provision(email, "ads-manager");
+    process.stdout.write("\r" + chalk.green("  ✓ Credentials refreshed") + "           \n");
+  } catch (err) {
+    process.stdout.write("\r" + chalk.red("  ✗ " + err.message) + "\n");
+    process.exit(1);
+  }
+
+  const written = writeMcpConfig(MCP_SERVER_NAME, data.mcp_url, data.api_key);
+  console.log(chalk.green("  ✓ MCP config updated") + chalk.dim(` → ${written[0] || "~/.claude"}`));
+
+  console.log();
+  console.log(chalk.bold("  Updated! Restart Claude to apply new permissions."));
+  console.log();
+  console.log(chalk.dim("  User:  ") + data.user_name + chalk.dim(` (${data.role})`));
+  if (data.scope && data.scope !== "full") {
+    console.log(chalk.dim("  Scope: ") + chalk.yellow(data.scope));
+  }
+  console.log();
+}
+
+const cmd = process.argv[2];
+
+try {
+  if (cmd === "update") {
+    await update();
+  } else {
+    await install();
+  }
 } catch (err) {
   if (err.name === "ExitPromptError") {
     console.log(chalk.dim("\n  Cancelled."));

package/lib/config-writer.js

@@ -37,6 +37,9 @@ export function writeMcpConfig(serverName, mcpUrl, apiKey) {
 
       if (!config.mcpServers) config.mcpServers = {};
 
+      // Remove legacy separate catalog-manager entry if present
+      delete config.mcpServers["bflabs-catalog-manager"];
+
       config.mcpServers[serverName] = {
         type: "http",
         url: mcpUrl,
@@ -61,6 +64,7 @@ export function writeMcpConfig(serverName, mcpUrl, apiKey) {
       config = JSON.parse(fs.readFileSync(claudeCodeMcp, "utf-8"));
     }
     if (!config.mcpServers) config.mcpServers = {};
+    delete config.mcpServers["bflabs-catalog-manager"];
     config.mcpServers[serverName] = {
       type: "http",
       url: mcpUrl,

package/lib/skill-writer.js

@@ -49,7 +49,7 @@ name: catalog-manager
 description: Gerencia catálogos de produtos Meta (Commerce Manager) via MCP. Use quando o usuário pedir para criar produtos, variantes, conjuntos de produtos (Product Sets) ou executar criação em massa.
 license: proprietary
 metadata:
-  version: 1.0.0
+  version: 1.0.1
   author: BF Labs
   tags:
     - meta-catalog
@@ -64,22 +64,31 @@ metadata:
 
 Operação de catálogos de produtos Meta via Commerce Manager.
 
-## Fluxo principal
+## Fluxo principal (escala BF Labs)
+
+1 produto base → N variantes (mesmo \`item_group_id\`) → 1 Product Set automático
 
-1 produto → 4 variantes idênticas → 1 Product Set automático
+As variantes aparecem agrupadas no Commerce Manager como um único item com múltiplas cópias.
 
 ## Quando usar
 
 - Criar produto novo no catálogo de um cliente
-- Criar variantes idênticas (fluxo de escala)
+- Criar variantes idênticas (fluxo de escala) com \`catalog_bulk_create_product\`
 - Criar Product Set automaticamente
 - Listar e atualizar produtos existentes
 
+## Comportamento importante
+
+- \`additional_image_urls\`: lista de URLs de imagens extras — enviada automaticamente como JSON string para a API Meta
+- \`item_group_id\`: no bulk create, todas as variantes recebem o \`retailer_id_base\` como \`item_group_id\`, agrupando-as como variantes do mesmo produto no Commerce Manager
+- Campos \`None\` são removidos automaticamente antes do envio
+
 ## Começar
 
 \`\`\`
 context_get_client("nome-do-cliente")  → business_id
 catalog_list(business_id)              → catalog_id
+catalog_bulk_create_product(catalog_id, name, retailer_id_base, ...)
 \`\`\`
 `,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bflabs-mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "BF MCP — instala o MCP server e skill do ads-manager e catalog-manager em Claude Desktop/Code",
   "bin": {
     "bflabs-mcp": "./bin/bflabs-mcp.js"