canicode 0.5.2 → 0.6.1

package/README.md

@@ -10,10 +10,13 @@
   <a href="https://github.com/let-sunny/canicode/actions/workflows/release.yml"><img src="https://github.com/let-sunny/canicode/actions/workflows/release.yml/badge.svg" alt="Release"></a>
   <a href="https://let-sunny.github.io/canicode/"><img src="https://img.shields.io/badge/Try_it-GitHub_Pages-blue" alt="GitHub Pages"></a>
   <a href="https://www.figma.com/community/plugin/1617144221046795292/canicode"><img src="https://img.shields.io/badge/Figma_Plugin-under_review-orange" alt="Figma Plugin"></a>
+  <a href="https://github.com/let-sunny/canicode#mcp-server-claude-code--cursor--claude-desktop"><img src="https://img.shields.io/badge/MCP_Registry-published-green" alt="MCP Registry"></a>
 </p>
 
 <p align="center">Analyze Figma designs. Score how dev-friendly and AI-friendly they are. Get actionable issues before writing code.</p>
 
+<p align="center"><strong><a href="https://github.com/let-sunny/canicode/discussions/new?category=share-your-figma">Share your Figma design</a></strong> to help improve scoring accuracy.</p>
+
 <p align="center"><strong><a href="https://let-sunny.github.io/canicode/">Try it in your browser</a></strong> — no install needed.</p>
 
 <p align="center">
@@ -102,7 +105,7 @@ canicode init --token figd_xxxxxxxxxxxxx
 
 **Claude Code:**
 ```bash
-claude mcp add canicode -e FIGMA_TOKEN=figd_xxxxxxxxxxxxx -- npx -y canicode canicode-mcp
+claude mcp add canicode -e FIGMA_TOKEN=figd_xxxxxxxxxxxxx -- npx -y -p canicode canicode-mcp
 ```
 
 **Cursor** (`~/.cursor/mcp.json`):
@@ -146,9 +149,10 @@ Then ask: *"Analyze this Figma design: https://www.figma.com/design/..."*
 
 | Flag | Source | Token required |
 |------|--------|----------------|
-| (none) | Auto-detect: MCP first, then REST API | For API fallback |
-| `--mcp` | Figma MCP via Claude Code | None |
-| `--api` | Figma REST API | Yes |
+| (none) | Figma REST API | Yes |
+| `--api` | Figma REST API (explicit) | Yes |
+
+For token-free analysis, use the **canicode MCP server** with the official Figma MCP, or the **`/canicode` skill** in Claude Code.
 
 Token priority:
 1. `--token` flag (one-time override)
@@ -299,7 +303,6 @@ Save Figma file data as JSON for offline analysis:
 
 ```bash
 canicode save-fixture https://www.figma.com/design/ABC123/MyDesign
-canicode save-fixture https://www.figma.com/design/ABC123/MyDesign --mcp
 ```
 
 </details>

package/dist/cli/index.js

@@ -1060,137 +1060,6 @@ async function loadFigmaFileFromJson(filePath) {
   const fileKey = basename(filePath, ".json");
   return transformFigmaResponse(fileKey, data);
 }
-
-// src/adapters/figma-mcp-adapter.ts
-var TAG_TYPE_MAP = {
-  canvas: "CANVAS",
-  frame: "FRAME",
-  group: "GROUP",
-  section: "SECTION",
-  component: "COMPONENT",
-  "component-set": "COMPONENT_SET",
-  instance: "INSTANCE",
-  rectangle: "RECTANGLE",
-  "rounded-rectangle": "RECTANGLE",
-  ellipse: "ELLIPSE",
-  vector: "VECTOR",
-  text: "TEXT",
-  line: "LINE",
-  "boolean-operation": "BOOLEAN_OPERATION",
-  star: "STAR",
-  "regular-polygon": "REGULAR_POLYGON",
-  slice: "SLICE",
-  sticky: "STICKY",
-  table: "TABLE",
-  "table-cell": "TABLE_CELL",
-  symbol: "COMPONENT",
-  slot: "FRAME"
-};
-function parseXml(xml) {
-  const nodes = [];
-  const stack = [];
-  const tagRegex = /<(\/?)([\w-]+)([^>]*?)(\/?)>/g;
-  let match;
-  while ((match = tagRegex.exec(xml)) !== null) {
-    const isClosing = match[1] === "/";
-    const tagName = match[2];
-    const attrString = match[3] ?? "";
-    const isSelfClosing = match[4] === "/";
-    if (isClosing) {
-      const finished = stack.pop();
-      if (finished) {
-        const parent = stack[stack.length - 1];
-        if (parent) {
-          parent.children.push(finished);
-        } else {
-          nodes.push(finished);
-        }
-      }
-    } else {
-      const attrs = parseAttributes(attrString);
-      const node = { tag: tagName, attrs, children: [] };
-      if (isSelfClosing) {
-        const parent = stack[stack.length - 1];
-        if (parent) {
-          parent.children.push(node);
-        } else {
-          nodes.push(node);
-        }
-      } else {
-        stack.push(node);
-      }
-    }
-  }
-  while (stack.length > 0) {
-    const finished = stack.pop();
-    const parent = stack[stack.length - 1];
-    if (parent) {
-      parent.children.push(finished);
-    } else {
-      nodes.push(finished);
-    }
-  }
-  return nodes;
-}
-function parseAttributes(attrString) {
-  const attrs = {};
-  const attrRegex = /([\w-]+)="([^"]*)"/g;
-  let match;
-  while ((match = attrRegex.exec(attrString)) !== null) {
-    const key = match[1];
-    const value = match[2];
-    if (key && value !== void 0) {
-      attrs[key] = value;
-    }
-  }
-  return attrs;
-}
-function toAnalysisNode(xmlNode) {
-  const type = TAG_TYPE_MAP[xmlNode.tag] ?? "FRAME";
-  const id = xmlNode.attrs["id"] ?? "0:0";
-  const name = xmlNode.attrs["name"] ?? xmlNode.tag;
-  const hidden = xmlNode.attrs["hidden"] === "true";
-  const x = parseFloat(xmlNode.attrs["x"] ?? "0");
-  const y = parseFloat(xmlNode.attrs["y"] ?? "0");
-  const width = parseFloat(xmlNode.attrs["width"] ?? "0");
-  const height = parseFloat(xmlNode.attrs["height"] ?? "0");
-  const node = {
-    id,
-    name,
-    type,
-    visible: !hidden,
-    absoluteBoundingBox: { x, y, width, height }
-  };
-  if (xmlNode.children.length > 0) {
-    node.children = xmlNode.children.map(toAnalysisNode);
-  }
-  return node;
-}
-function parseMcpMetadataXml(xml, fileKey, fileName) {
-  const parsed = parseXml(xml);
-  const children = parsed.map(toAnalysisNode);
-  let document;
-  if (children.length === 1 && children[0]) {
-    document = children[0];
-  } else {
-    document = {
-      id: "0:0",
-      name: "Document",
-      type: "DOCUMENT",
-      visible: true,
-      children
-    };
-  }
-  return {
-    fileKey,
-    name: fileName ?? fileKey,
-    lastModified: (/* @__PURE__ */ new Date()).toISOString(),
-    version: "mcp",
-    document,
-    components: {},
-    styles: {}
-  };
-}
 var AIREADY_DIR = join(homedir(), ".canicode");
 var CONFIG_PATH = join(AIREADY_DIR, "config.json");
 var REPORTS_DIR = join(AIREADY_DIR, "reports");
@@ -1257,7 +1126,7 @@ function isFigmaUrl(input) {
 function isJsonFile(input) {
   return input.endsWith(".json");
 }
-async function loadFile(input, token, mode = "auto") {
+async function loadFile(input, token) {
   if (isJsonFile(input)) {
     const filePath = resolve(input);
     if (!existsSync(filePath)) {
@@ -1267,31 +1136,13 @@ async function loadFile(input, token, mode = "auto") {
     return { file: await loadFigmaFileFromJson(filePath) };
   }
   if (isFigmaUrl(input)) {
-    const { fileKey, nodeId, fileName } = parseFigmaUrl(input);
-    if (mode === "mcp") {
-      return loadFromMcp(fileKey, nodeId, fileName);
-    }
-    if (mode === "api") {
-      return loadFromApi(fileKey, nodeId, token);
-    }
-    try {
-      console.log("Auto-detecting data source... trying MCP first.");
-      return await loadFromMcp(fileKey, nodeId, fileName);
-    } catch (mcpError) {
-      const mcpMsg = mcpError instanceof Error ? mcpError.message : String(mcpError);
-      console.log(`MCP unavailable (${mcpMsg}). Falling back to REST API.`);
-      return loadFromApi(fileKey, nodeId, token);
-    }
+    const { fileKey, nodeId } = parseFigmaUrl(input);
+    return loadFromApi(fileKey, nodeId, token);
   }
   throw new Error(
     `Invalid input: ${input}. Provide a Figma URL or JSON file path.`
   );
 }
-async function loadFromMcp(fileKey, nodeId, fileName) {
-  console.log(`Loading via MCP: ${fileKey} (node: ${nodeId ?? "root"})`);
-  const file = await loadViaMcp(fileKey, nodeId ?? "0:1", fileName);
-  return { file, nodeId };
-}
 async function loadFromApi(fileKey, nodeId, token) {
   console.log(`Fetching from Figma REST API: ${fileKey}`);
   if (nodeId) {
@@ -1310,20 +1161,6 @@ async function loadFromApi(fileKey, nodeId, token) {
     nodeId
   };
 }
-async function loadViaMcp(fileKey, nodeId, fileName) {
-  const { execSync } = await import('child_process');
-  const result = execSync(
-    `claude --print "Use the mcp__figma__get_metadata tool with fileKey=\\"${fileKey}\\" and nodeId=\\"${nodeId.replace(/-/g, ":")}\\" \u2014 return ONLY the raw XML output, nothing else."`,
-    { encoding: "utf-8", timeout: 12e4 }
-  );
-  const xmlStart = result.indexOf("<");
-  const xmlEnd = result.lastIndexOf(">");
-  if (xmlStart === -1 || xmlEnd === -1) {
-    throw new Error("MCP did not return valid XML metadata");
-  }
-  const xml = result.slice(xmlStart, xmlEnd + 1);
-  return parseMcpMetadataXml(xml, fileKey, fileName);
-}
 
 // src/core/scoring.ts
 var SEVERITY_DENSITY_WEIGHT = {
@@ -2923,7 +2760,7 @@ function printDocsSetup() {
 CANICODE SETUP GUIDE
 
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
- 1. CLI
+ 1. CLI (REST API)
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 
   Install:
@@ -2937,11 +2774,6 @@ CANICODE SETUP GUIDE
     canicode analyze "https://www.figma.com/design/ABC123/MyDesign?node-id=1-234"
     (opens report in browser automatically, use --no-open to disable)
 
-  Data source flags:
-    --api     REST API (uses saved token)
-    --mcp     Figma MCP bridge (Claude Code only, no token needed)
-    (none)    Auto: try MCP first, fallback to API
-
   Options:
     --preset strict|relaxed|dev-friendly|ai-ready
     --config ./my-config.json
@@ -2952,54 +2784,25 @@ CANICODE SETUP GUIDE
     ~/.canicode/reports/report-YYYY-MM-DD-HH-mm-<filekey>.html
 
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
- 2. MCP SERVER (Claude Code integration)
+ 2. CLAUDE CODE SKILL (Figma MCP, no token needed)
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 
-  Route A \u2014 Figma MCP relay (no token needed):
-
-    Install (once):
-      claude mcp add figma -- npx -y @anthropic-ai/claude-code-mcp-figma
-      claude mcp add --transport stdio canicode npx canicode-mcp
-
-    Flow:
-      Claude Code
-        -> Figma MCP get_metadata(fileKey, nodeId) -> XML node tree
-        -> canicode MCP analyze(designData: XML) -> analysis result
+  Requires the official Figma MCP server at project level.
 
-  Route B \u2014 REST API direct (token needed):
-
-    Install (once):
-      claude mcp add --transport stdio canicode npx canicode-mcp
-      canicode init --token figd_xxxxxxxxxxxxx
-
-    Flow:
-      Claude Code
-        -> canicode MCP analyze(input: URL) -> internal REST API fetch -> result
-
-  Use (both routes \u2014 just ask Claude Code):
-    "Analyze this Figma design: https://www.figma.com/design/..."
-
-  Route A vs B:
-    A: No token, 2 MCP servers, Claude orchestrates 2 calls
-    B: Token needed, 1 MCP server, canicode fetches directly
-
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
- 3. CLAUDE SKILLS (lightweight)
-\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-
-  Install:
-    cp -r path/to/canicode/.claude/skills/canicode .claude/skills/
-
-  Setup (for REST API):
-    npx canicode init --token figd_xxxxxxxxxxxxx
+  Setup (once):
+    claude mcp add -s project -t http figma https://mcp.figma.com/mcp
 
   Use (in Claude Code):
-    /canicode analyze "https://www.figma.com/design/..."
+    /canicode https://www.figma.com/design/ABC123/MyDesign?node-id=1-234
 
-  Runs CLI under the hood \u2014 all flags work (--mcp, --api, --preset, etc.)
+  Flow:
+    Claude Code
+      -> Figma MCP get_metadata(fileKey, nodeId) -> XML node tree
+      -> Convert to fixture JSON
+      -> canicode analyze fixture.json -> report
 
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
- TOKEN PRIORITY (all methods)
+ TOKEN PRIORITY (CLI mode)
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 
   1. --token flag (one-time override)
@@ -3011,9 +2814,11 @@ CANICODE SETUP GUIDE
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 
   CI/CD, automation        -> CLI + FIGMA_TOKEN env var
-  Claude Code, interactive -> MCP Server (Route A)
-  No token, Claude Code    -> MCP Server (Route A)
-  Quick trial              -> Skills
+  Claude Code (full)       -> canicode MCP + Figma MCP (no token needed)
+  Claude Code (light)      -> /canicode skill + Figma MCP (no token needed)
+  In Figma                 -> Figma Plugin
+  Browser                  -> Web App (GitHub Pages)
+  Quick trial, offline     -> CLI + JSON fixtures
 `.trimStart());
 }
 function printDocsRules() {
@@ -3055,7 +2860,7 @@ EXAMPLE
         "maxHeight": 48,
         "nameContains": "icon"
       },
-      "message": ""{name}" is an icon but not a component",
+      "message": "\\"{name}\\" is an icon but not a component",
       "why": "Icons should be reusable components.",
       "impact": "Developers hardcode icons.",
       "fix": "Convert to component and publish to library."
@@ -4414,16 +4219,13 @@ function countNodes2(node) {
   }
   return count;
 }
-cli.command("analyze <input>", "Analyze a Figma file or JSON fixture").option("--preset <preset>", "Analysis preset (relaxed | dev-friendly | ai-ready | strict)").option("--output <path>", "HTML report output path").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").option("--mcp", "Load via Figma MCP (no FIGMA_TOKEN needed)").option("--api", "Load via Figma REST API (requires FIGMA_TOKEN)").option("--screenshot", "Include screenshot comparison in report (requires ANTHROPIC_API_KEY)").option("--custom-rules <path>", "Path to custom rules JSON file").option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--no-open", "Don't open report in browser after analysis").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign --mcp").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign --api --token YOUR_TOKEN").example("  canicode analyze ./fixtures/design.json --output report.html").example("  canicode analyze ./fixtures/design.json --custom-rules ./my-rules.json").example("  canicode analyze ./fixtures/design.json --config ./my-config.json").action(async (input, options) => {
+cli.command("analyze <input>", "Analyze a Figma file or JSON fixture").option("--preset <preset>", "Analysis preset (relaxed | dev-friendly | ai-ready | strict)").option("--output <path>", "HTML report output path").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").option("--api", "Load via Figma REST API (requires FIGMA_TOKEN)").option("--screenshot", "Include screenshot comparison in report (requires ANTHROPIC_API_KEY)").option("--custom-rules <path>", "Path to custom rules JSON file").option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--no-open", "Don't open report in browser after analysis").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign --api --token YOUR_TOKEN").example("  canicode analyze ./fixtures/design.json --output report.html").example("  canicode analyze ./fixtures/design.json --custom-rules ./my-rules.json").example("  canicode analyze ./fixtures/design.json --config ./my-config.json").action(async (input, options) => {
   const analysisStart = Date.now();
   trackEvent(EVENTS.ANALYSIS_STARTED, { source: isJsonFile(input) ? "fixture" : "figma" });
   try {
-    if (options.mcp && options.api) {
-      throw new Error("Cannot use --mcp and --api together. Choose one.");
-    }
-    if (!options.mcp && !options.token && !getFigmaToken() && !isJsonFile(input)) {
+    if (!options.token && !getFigmaToken() && !isJsonFile(input)) {
       throw new Error(
-        "canicode is not configured. Run 'canicode init --token YOUR_TOKEN' first.\nOr use --mcp flag for Figma MCP mode (no token needed)."
+        "canicode is not configured. Run 'canicode init --token YOUR_TOKEN' first."
       );
     }
     if (options.screenshot) {
@@ -4435,8 +4237,7 @@ cli.command("analyze <input>", "Analyze a Figma file or JSON fixture").option("-
       }
       console.log("Screenshot comparison mode enabled (coming soon).\n");
     }
-    const mode = options.mcp ? "mcp" : options.api ? "api" : "auto";
-    const { file, nodeId } = await loadFile(input, options.token, mode);
+    const { file, nodeId } = await loadFile(input, options.token);
     const totalNodes = countNodes2(file.document);
     let effectiveNodeId = nodeId;
     if (!effectiveNodeId && totalNodes > MAX_NODES_WITHOUT_SCOPE) {
@@ -4718,17 +4519,13 @@ cli.command(
 cli.command(
   "save-fixture <input>",
   "Save Figma file data as a JSON fixture for offline analysis"
-).option("--output <path>", "Output JSON path (default: fixtures/<filekey>.json)").option("--mcp", "Load via Figma MCP (no FIGMA_TOKEN needed)").option("--api", "Load via Figma REST API (requires FIGMA_TOKEN)").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").example("  canicode save-fixture https://www.figma.com/design/ABC123/MyDesign --mcp").example("  canicode save-fixture https://www.figma.com/design/ABC123/MyDesign --api --token YOUR_TOKEN").action(async (input, options) => {
+).option("--output <path>", "Output JSON path (default: fixtures/<filekey>.json)").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").example("  canicode save-fixture https://www.figma.com/design/ABC123/MyDesign").example("  canicode save-fixture https://www.figma.com/design/ABC123/MyDesign --token YOUR_TOKEN").action(async (input, options) => {
   try {
-    if (options.mcp && options.api) {
-      throw new Error("Cannot use --mcp and --api together. Choose one.");
-    }
     if (isFigmaUrl(input) && !parseFigmaUrl(input).nodeId) {
       console.warn("\nWarning: No node-id specified. Saving entire file as fixture.");
       console.warn("Tip: Add ?node-id=XXX to save a specific section.\n");
     }
-    const mode = options.mcp ? "mcp" : options.api ? "api" : "auto";
-    const { file } = await loadFile(input, options.token, mode);
+    const { file } = await loadFile(input, options.token);
     const outputPath = resolve(
       options.output ?? `fixtures/${file.fileKey}.json`
     );
@@ -4759,19 +4556,17 @@ cli.command("init", "Set up canicode (Figma token or MCP)").option("--token <tok
       return;
     }
     if (options.mcp) {
-      console.log(`MCP SETUP
+      console.log(`FIGMA MCP SETUP (for Claude Code)
 `);
-      console.log(`1. Install Figma MCP in Claude Code:`);
-      console.log(`   claude mcp add figma -- npx -y @anthropic-ai/claude-code-mcp-figma
+      console.log(`1. Register the official Figma MCP server at project level:`);
+      console.log(`   claude mcp add -s project -t http figma https://mcp.figma.com/mcp
 `);
-      console.log(`2. Add canicode MCP server:`);
-      console.log(`   claude mcp add --transport stdio canicode npx canicode-mcp
+      console.log(`   This creates .mcp.json in your project root.
 `);
-      console.log(`3. Set Figma token (for MCP server's REST API fallback):`);
-      console.log(`   canicode init --token YOUR_TOKEN
+      console.log(`2. Use the /canicode skill in Claude Code:`);
+      console.log(`   /canicode https://www.figma.com/design/.../MyDesign?node-id=1-234
 `);
-      console.log(`4. Use in Claude Code:`);
-      console.log(`   "Analyze this Figma design: https://www.figma.com/design/..."`);
+      console.log(`   The skill calls Figma MCP directly \u2014 no FIGMA_TOKEN needed.`);
       return;
     }
     console.log(`CANICODE SETUP
@@ -4784,7 +4579,7 @@ cli.command("init", "Set up canicode (Figma token or MCP)").option("--token <tok
 `);
     console.log(`Option 2: Figma MCP (recommended for Claude Code)`);
     console.log(`  canicode init --mcp`);
-    console.log(`  No token needed for CLI \u2014 uses Claude Code's Figma MCP bridge
+    console.log(`  Uses the /canicode skill in Claude Code with official Figma MCP
 `);
     console.log(`After setup:`);
     console.log(`  canicode analyze "https://www.figma.com/design/..."`);
@@ -4895,9 +4690,8 @@ cli.help((sections) => {
     {
       title: "\nData source",
       body: [
-        `  --mcp                   Load via Figma MCP (no token needed)`,
         `  --api                   Load via Figma REST API (needs FIGMA_TOKEN)`,
-        `  (default)               Auto-detect: try MCP first, then API`
+        `  --token <token>         Figma API token (or use FIGMA_TOKEN env var)`
       ].join("\n")
     },
     {
@@ -4910,7 +4704,6 @@ cli.help((sections) => {
     {
       title: "\nExamples",
       body: [
-        `  $ canicode analyze "https://www.figma.com/design/..." --mcp`,
         `  $ canicode analyze "https://www.figma.com/design/..." --api`,
         `  $ canicode analyze "https://www.figma.com/design/..." --preset strict`,
         `  $ canicode analyze "https://www.figma.com/design/..." --config ./my-config.json`
@@ -4920,7 +4713,7 @@ cli.help((sections) => {
       title: "\nInstallation",
       body: [
         `  CLI:     npm install -g canicode`,
-        `  MCP:     claude mcp add --transport stdio canicode npx canicode-mcp`,
+        `  MCP:     claude mcp add canicode -- npx -y -p canicode canicode-mcp`,
         `  Skills:  github.com/let-sunny/canicode`
       ].join("\n")
     }