English Français العربية

Figma MCP

السجل الرسمي الوسائط والتصميم

Figma MCP: list frames in a file and fetch one frame's JSON and image safely. 2 tools.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @scalably-io/figma-mcp
Claude Code 
claude mcp add figma-mcp -e 'FIGMA_TOKEN=<your figma_token>' -e 'FIGMA_API_BASE_URL=<FIGMA_API_BASE_URL>' -e 'FIGMA_REQUEST_TIMEOUT_MS=<FIGMA_REQUEST_TIMEOUT_MS>' -e 'FIGMA_MAX_JSON_BYTES=<FIGMA_MAX_JSON_BYTES>' -e 'FIGMA_MAX_FRAME_BYTES=<FIGMA_MAX_FRAME_BYTES>' -e 'FIGMA_OUTPUT_ROOT=<FIGMA_OUTPUT_ROOT>' -e 'FIGMA_ALLOW_HTTP_FOR_TESTS=<FIGMA_ALLOW_HTTP_FOR_TESTS>' -- npx -y @scalably-io/figma-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "figma-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@scalably-io/figma-mcp@1.0.1"
            ],
            "env": {
                "FIGMA_TOKEN": "<your figma_token>",
                "FIGMA_API_BASE_URL": "<FIGMA_API_BASE_URL>",
                "FIGMA_REQUEST_TIMEOUT_MS": "<FIGMA_REQUEST_TIMEOUT_MS>",
                "FIGMA_MAX_JSON_BYTES": "<FIGMA_MAX_JSON_BYTES>",
                "FIGMA_MAX_FRAME_BYTES": "<FIGMA_MAX_FRAME_BYTES>",
                "FIGMA_OUTPUT_ROOT": "<FIGMA_OUTPUT_ROOT>",
                "FIGMA_ALLOW_HTTP_FOR_TESTS": "<FIGMA_ALLOW_HTTP_FOR_TESTS>"
            }
        }
    }
}

متغيرات البيئة

  • FIGMA_TOKEN إلزامي سري Figma personal access token with file_content:read
  • FIGMA_API_BASE_URL Figma REST API base URL, default https://api.figma.com/v1
  • FIGMA_REQUEST_TIMEOUT_MS Per-request timeout in milliseconds, default 60000
  • FIGMA_MAX_JSON_BYTES Upper bound on a Figma JSON response in bytes, default 104857600
  • FIGMA_MAX_FRAME_BYTES Upper bound on a downloaded frame PNG in bytes, default 104857600
  • FIGMA_OUTPUT_ROOT Directory that all fetch_frame output directories must stay below, default ./figma-output
  • FIGMA_ALLOW_HTTP_FOR_TESTS Test suite only: set to 1 to allow a plain-HTTP loopback API base. Never set it in normal use
MCPB package https://github.com/scalably-io/figma-mcp/releases/download/v1.0.1/figma-mcp.mcpb

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Figma MCP
  2. Install
  3. Setup
  4. Tools (2)
  5. Configuration
  6. Reply shape
  7. Limits
  8. Verify
  9. Privacy Policy
  10. License

Figma MCP

Figma REST API MCP server. 2 tools list the top-level frames in a file and fetch one frame's rendered PNG plus its node JSON and image-fill map into a local output directory.

Install

Claude Code:

claude mcp add figma -e FIGMA_TOKEN=your-token -- npx -y @scalably-io/figma-mcp

Codex:

codex mcp add figma --env FIGMA_TOKEN=your-token -- npx -y @scalably-io/figma-mcp

Claude Desktop: download figma-mcp.mcpb from the latest GitHub release and open it.

Setup

  1. Create a personal access token at figma.com under account settings, with file_content:read scope.
  2. Find the file key in any Figma file URL: it is the segment after /design/ or /file/, for example https://www.figma.com/design/AbC123xyz/My-file gives AbC123xyz. Both tools take it as file_key.
  3. If FIGMA_TOKEN is not set the server still starts and lists its tools; every call then fails with FIGMA_NOT_CONFIGURED until the token is provided.
  4. fetch_frame is the only tool that writes files (so it is not marked read-only); it writes frame.png, node.json, and fills.json into a directory below the configured output root (default ./figma-output). The other tool is fully read-only.

Tools (2)

ToolWhat it does
list_framesList and optionally filter all top-level FRAME nodes in a Figma file, with exact page/name/node-id data, dimensions, and file metadata
fetch_frameFetch one Figma frame and transactionally write frame.png, node.json, and a normalized image-fill map into a directory below the output root

Configuration

VariableRequiredPurpose
FIGMA_TOKENyesFigma personal access token with file_content:read
FIGMA_API_BASE_URLnoOverride the Figma REST API base URL (default https://api.figma.com/v1)
FIGMA_REQUEST_TIMEOUT_MSnoPer-request timeout in milliseconds (default 60000)
FIGMA_MAX_JSON_BYTESnoUpper bound on a Figma JSON response, in bytes (default 104857600)
FIGMA_MAX_FRAME_BYTESnoUpper bound on a downloaded frame PNG, in bytes (default 104857600)
FIGMA_OUTPUT_ROOTnoDirectory that every fetch_frame output directory must stay below (default ./figma-output, created on first use)
FIGMA_ALLOW_HTTP_FOR_TESTSnoTest suite only: 1 allows a plain-HTTP loopback API base. Never set it in normal use

Reply shape

Every tool returns plain JSON with status (succeeded, partial, no_op), summary, target, result, proof, warnings, recovery. Failures throw a plain error string: <code>: <message> <hint>.

Limits

fetch_frame renders through Figma's image API, so very large frames or extreme scale values can exceed the configured JSON or frame byte limits; lower scale or split the frame if that happens. fills.json URLs are temporary and expire within 14 days.

Verify

Each release lists the package version, the .mcpb sha256 and the production commit it was derived from in CHANGELOG.md. CI runs the tests and a clean install of the packed tarball on every push.

Privacy Policy

This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently beyond the frame bundles you explicitly fetch, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: hello@scalably.io. Canonical copy: https://scalably.io/connector-privacy.html

License

MIT. Copyright Scalably.

الأسئلة الشائعة

ما هو Figma MCP؟

Figma MCP: list frames in a file and fetch one frame's JSON and image safely. 2 tools.

كيف أثبّت Figma MCP؟

يعمل على جهازك. في Claude Code: claude mcp add figma-mcp -e 'FIGMA_TOKEN=<your figma_token>' -e 'FIGMA_API_BASE_URL=<FIGMA_API_BASE_URL>' -e 'FIGMA_REQUEST_TIMEOUT_MS=<FIGMA_REQUEST_TIMEOUT_MS>' -e 'FIGMA_MAX_JSON_BYTES=<FIGMA_MAX_JSON_BYTES>' -e 'FIGMA_MAX_FRAME_BYTES=<FIGMA_MAX_FRAME_BYTES>' -e 'FIGMA_OUTPUT_ROOT=<FIGMA_OUTPUT_ROOT>' -e 'FIGMA_ALLOW_HTTP_FOR_TESTS=<FIGMA_ALLOW_HTTP_FOR_TESTS>' -- npx -y @scalably-io/figma-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Figma MCP إلى مفتاح API؟

نعم. يتطلب FIGMA_TOKEN، وتضبطها في إعداداته.

هل Figma MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Figma MCP؟

ينشره scalably-io. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.