figmanage 0.1.0 → 0.1.2

package/README.md

@@ -6,27 +6,43 @@ Manages Figma workspaces through AI assistants. 76 tools covering files, project
 
 ## quick start
 
+### PAT only (30 seconds)
+
+Get a token at [figma.com/settings](https://www.figma.com/settings) > Security > Personal access tokens, then:
+
 ```bash
-npx figmanage            # starts MCP server (stdio)
-npx figmanage --http 3333  # starts MCP server (HTTP, for ChatGPT etc.)
+claude mcp add figmanage -s user -e FIGMA_PAT=figd_xxx -- npx -y figmanage
 ```
 
-## setup
+Restart Claude Code. Gives you 30+ tools (comments, reading, export, components, versions, webhooks).
+
+### full setup (2 minutes, all 76 tools)
 
 ```bash
-git clone https://github.com/dannykeane/figmanage.git
-cd figmanage
-npm install
-npm run build
-npm run setup    # extracts Chrome cookie, configures your MCP client
+npx -y figmanage --setup
 ```
 
-The setup script:
-- Reads your Figma session cookie from Chrome (macOS, Linux, Windows)
-- Detects your org ID via Figma's redirect behavior
-- Prompts for a Personal Access Token
-- Stores all credentials in MCP server config (env vars)
-- Auto-detects Claude Code, or prints config for other clients
+Extracts your Chrome cookie, prompts for a PAT, registers with Claude Code automatically. Unlocks all 76 tools including workspace management, permissions, and org admin. Restart Claude Code.
+
+Use `--no-prompt --pat figd_xxx` for non-interactive setup.
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "figmanage": {
+      "command": "npx",
+      "args": ["-y", "figmanage"],
+      "env": {
+        "FIGMA_PAT": "figd_your_token_here"
+      }
+    }
+  }
+}
+```
 
 ## configuration
 
@@ -325,6 +341,8 @@ Tools self-register via `defineTool()` side-effect imports. Each tool declares i
 ## development
 
 ```bash
+git clone https://github.com/dannykeane/figmanage.git
+cd figmanage
 npm install
 npm run build    # compile
 npm run setup    # configure auth + MCP client

package/dist/index.js

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
+// Run setup if --setup flag is present
+if (process.argv.includes('--setup')) {
+    await import('./setup.js');
+    process.exit(0);
+}
 import { createServer } from 'node:http';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

package/dist/setup.js

@@ -283,18 +283,18 @@ function claudeCliAvailable() {
         return false;
     }
 }
-function registerWithClaude(envVars, serverPath) {
+function registerWithClaude(envVars) {
     try {
         execSync('claude mcp remove figmanage -s user 2>/dev/null || true', { encoding: 'utf-8' });
         const envFlags = Object.entries(envVars).map(([k, v]) => `--env ${k}=${v}`).join(' ');
-        execSync(`claude mcp add figmanage --transport stdio -s user ${envFlags} -- node ${serverPath}`, { encoding: 'utf-8' });
+        execSync(`claude mcp add figmanage --transport stdio -s user ${envFlags} -- npx -y figmanage`, { encoding: 'utf-8' });
         return true;
     }
     catch {
         return false;
     }
 }
-function printManualConfig(envVars, serverPath) {
+function printManualConfig(envVars) {
     console.log('\nClaude CLI not found. Configure your MCP client manually.\n');
     console.log('Environment variables:');
     for (const [k, v] of Object.entries(envVars)) {
@@ -304,8 +304,8 @@ function printManualConfig(envVars, serverPath) {
     console.log('\nMCP server config (JSON):');
     const config = {
         figmanage: {
-            command: 'node',
-            args: [serverPath],
+            command: 'npx',
+            args: ['-y', 'figmanage'],
             env: Object.fromEntries(Object.entries(envVars).map(([k, v]) => [k, k === 'FIGMA_AUTH_COOKIE' || k === 'FIGMA_PAT' ? '<paste value>' : v])),
         },
     };
@@ -333,7 +333,7 @@ async function setup() {
     const os = platform();
     // Build env vars to register
     const envVars = {};
-    const serverPath = join(import.meta.dirname, 'index.js');
+    // Registration uses npx -y figmanage (no local path needed)
     if (noPrompt) {
         // Non-interactive mode: skip cookie extraction, require --pat
         if (!patArg) {
@@ -353,16 +353,16 @@ async function setup() {
         // Register with whatever client is available
         if (claudeCliAvailable()) {
             console.log('\nRegistering with Claude...');
-            if (registerWithClaude(envVars, serverPath)) {
+            if (registerWithClaude(envVars)) {
                 console.log('  PAT stored in MCP server config');
                 console.log('  Done. Restart Claude Code to use figmanage.');
             }
             else {
-                printManualConfig(envVars, serverPath);
+                printManualConfig(envVars);
             }
         }
         else {
-            printManualConfig(envVars, serverPath);
+            printManualConfig(envVars);
         }
         return;
     }
@@ -544,18 +544,18 @@ async function setup() {
         console.log('FIGMA_PAT=****** (stored in MCP server config)');
     if (claudeCliAvailable()) {
         console.log('\nRegistering with Claude...');
-        if (registerWithClaude(envVars, serverPath)) {
+        if (registerWithClaude(envVars)) {
             if (pat)
                 console.log('  PAT stored in MCP server config');
             console.log('  Done. Restart Claude Code to use figmanage.');
         }
         else {
             console.log('  Could not register automatically.');
-            printManualConfig(envVars, serverPath);
+            printManualConfig(envVars);
         }
     }
     else {
-        printManualConfig(envVars, serverPath);
+        printManualConfig(envVars);
     }
 }
 setup().catch((err) => {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "figmanage",
-  "version": "0.1.0",
+  "mcpName": "io.github.dannykeane/figmanage",
+  "version": "0.1.2",
   "description": "MCP server for managing your Figma workspace from the terminal.",
   "type": "module",
   "main": "dist/index.js",