שרת MCP מאומת: Figma

שרת ה-MCP של Figma, הרצנו אותו חי על Mac אמיתי.

  • הכלים נספרו2026-08-03macOS 26.3.1
  • חבילהfigma-developer-mcp 0.13.2
  • מדווח על עצמוFigma MCP Server 0.13.2
  • פרוטוקול MCP2025-06-18
  • סביבת ריצהNode v24.18.0

רשימת הכלים למטה היא לכידה חיה מהשרת הרץ; קריאת כלי מאומתת עדיין ממתינה להרשאות.

התשובה הקצרה

אומת לאחרונה 2026-08-03

חיפוש של שרת ה-MCP של Figma מחזיר שני דברים שונים, ולכן העמוד הזה מדייק במה שהוא באמת הריץ. ל-Figma יש שרת רשמי בשתי צורות: אחד שרץ בתוך אפליקציית Figma לשולחן העבודה ומגיש את הכתובת http://127.0.0.1:3845/mcp, ואחד מתארח בכתובת https://mcp.figma.com/mcp שנכנסים אליו עם OAuth. בדקנו את פורט 3845 על ה-Mac הזה, ש-Figma מותקנת עליו, ושום דבר לא האזין שם, ולכן לא יכולנו לספור את הכלים של השרת הרשמי. מה שכן הרצנו הוא figma-developer-mcp, חבילת הקהילה של Framelink, עם 85,758 הורדות ב-npm בשבוע שהסתיים ב-2026-08-01: היא עלתה על גבי stdio, הציגה את עצמה כ-Figma MCP Server 0.13.2, ומנתה את שני הכלים שלה, המודפסים למטה מילה במילה. הקריאה האמיתית היחידה שביצענו החזירה שגיאת 403 מ-Figma, כי הפעלנו אותה עם אסימון דמה ולא עם אסימון אמיתי. גם טקסט השגיאה הזה נמצא בעמוד, וגם מה שנדרש מאסימון תקין. [1][2][3][9][10]

  • כלים

    2, נספרו בריצה חיה

  • אישורי גישה

    נדרש אסימון גישה של Figma [6]

  • ערוץ תקשורת

    stdio, רץ על ה-Mac שלכם

  • מתחזק

    GLips (Framelink), פרויקט קהילה [1][3]

  • הורדות

    86 אלף בשבוע האחרון [2]

  • רישיון

    MIT [4]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את figma-developer-mcp עם npx על גבי stdio, השלמנו את לחיצת היד של MCP, קראנו ל-tools/list וביצענו קריאת כלי אמיתית אחת. טבלת הכלים למטה היא הלכידה הזו, מילה במילה. קריאות מאומתות עדיין ממתינות לאישור גישה שאין ברשותנו: אסימון גישה אישי של Figma עם הרשאת קריאה ל-File content ול-Dev resources. הרצנו את השרת עם אסימון דמה במקום, ולכן הקריאה שלנו ל-get_figma_data חזרה עם שגיאת 403 של Figma המודפסת למטה. זה מוכיח שהשרת עולה, מדבר MCP ומגיע ל-Figma. זה לא מוכיח שהוא מסוגל לקרוא קובץ, ואנחנו לא טוענים זאת. בדקנו גם את השרת הרשמי לשולחן העבודה בכתובת http://127.0.0.1:3845/mcp על ה-Mac הזה, שאפליקציית Figma מותקנת עליו: שום דבר לא האזין שם והחיבור נדחה.

הודעת הפתיחה של השרת

Usage telemetry enabled. Disable: FRAMELINK_TELEMETRY=off or DO_NOT_TRACK=1

קריאת כלי אמיתית אחת

tools/call get_figma_data {"fileKey": "X4zPq7RtLmNvBcDsEfGhJk"}
Error fetching file: Request to Figma API endpoint '/files/X4zPq7RtLmNvBcDsEfGhJk' returned 403 Forbidden.
Response body: {"status":403,"err":"Invalid token"}

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 2 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

כלימה הוא עושה
get_figma_datafileKey*nodeIddepth

Get comprehensive Figma file data including layout, content, visuals, and component information

download_figma_imagesfileKey*nodes*pngScalelocalPath*

Download SVG and PNG images used in a Figma file based on the IDs of image or icon nodes. Images will be saved relative to the server's image directory: /tmp/figma-mcp-verify

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

Claude Desktop

פתחו את הקובץ ‎~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": [
        "-y",
        "figma-developer-mcp",
        "--figma-api-key=YOUR-FIGMA-TOKEN",
        "--image-dir=/Users/yourname/Projects/site",
        "--stdio"
      ]
    }
  }
}

הדביקו את האסימון שלכם במקום YOUR-FIGMA-TOKEN, כוונו את ‎--image-dir אל התיקיה שאליה יירדו התמונות, ואז סגרו ופתחו מחדש את Claude Desktop. ה-README מקבל גם את FIGMA_API_KEY בתוך אובייקט env במקום הדגל. [11][5]

Claude Code

פקודה אחת בטרמינל:

claude mcp add figma -- npx -y figma-developer-mcp --figma-api-key=YOUR-FIGMA-TOKEN --image-dir=/Users/yourname/Projects/site --stdio

כל מה שאחרי המקף הכפול הוא הפקודה המדויקת ש-Claude Code יריץ, וזו הפקודה שאנחנו הרצנו, עם אסימון דמה ותיקיית תמונות זמנית במקום שני הערכים שלמעלה. היסטוריית הפקודות שלכם תשמור את האסימון, לכן אם זה מפריע לכם השתמשו ב-‎-e FIGMA_API_KEY=... במקום. [12]

Cursor

הוסיפו ל-‎~/.cursor/mcp.json עבור כל הפרויקטים, או ל-‎.cursor/mcp.json בתוך פרויקט אחד:

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": [
        "-y",
        "figma-developer-mcp",
        "--figma-api-key=YOUR-FIGMA-TOKEN",
        "--image-dir=/Users/yourname/Projects/site",
        "--stdio"
      ]
    }
  }
}

Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. Framelink מתארים את השרת הזה כשרת לסוכני קוד מבוססי AI כמו Cursor. [13][3]

Routines

בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. העבירו את הטופס ל-Command (stdio) והזינו:

Name        Figma
Command     npx
Arguments   -y figma-developer-mcp --figma-api-key=YOUR-FIGMA-TOKEN --image-dir=/Users/yourname/Projects/site --stdio

הערך בשדה ה-Arguments מתפצל לפי רווחים, לכן השאירו כל דגל כמקשה אחת והשתמשו בנתיב תיקיה בלי רווחים. לחצו קודם על Test Connection: שרת תקין עונה עם מספר הכלים שלו, שניים במקרה הזה. [14]

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Figma בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות. בשונה משרת הקבצים, השרת הזה דורש קודם אסימון של Figma, ולכן זהו שלב שתיים.

  1. 01

    התקינו את Routines

    הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

  2. 02

    צרו אסימון גישה של Figma

    ב-Figma, פתחו את תפריט החשבון בפינה השמאלית העליונה, בחרו Settings, פתחו את הלשונית Security, גללו אל Personal access tokens ולחצו על Generate new token. תנו לו הרשאת קריאה ל-File content ול-Dev resources. העתיקו אותו מיד: Figma מציגה את האסימון פעם אחת בלבד, ואם תעברו מהעמוד תצטרכו ליצור חדש.

  3. 03

    פתחו את הגדרות ה-MCP

    חזרה ב-Routines, לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

  4. 04

    בחרו Command (stdio)‎

    העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה שמריצים, לא כתובת אינטרנט. השרתים הרשמיים של Figma הם דווקא מסוג הכתובת, והם מכוסים בהמשך העמוד.

  5. 05

    מלאו את השדות, ואז בדקו

    Name: Figma. Command: npx. Arguments: ‎-y figma-developer-mcp --figma-api-key=YOUR-FIGMA-TOKEN --image-dir=/Users/yourname/Projects/site --stdio, עם האסימון שלכם מודבק פנימה. השאירו את Environment Variables ריק. לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, שניים עבור השרת הזה. אחר כך לחצו Add Server.

  6. 06

    השתמשו בו

    הכלים עובדים בצ׳אט מיד: הדביקו קישור לקובץ Figma ובקשו את הפריסה. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

תקציר שבועי של שינויי עיצוב

פרומפט

Every Monday at 9:00, read my Figma design file, list the frames and components that changed since last week with a one-line note on each, and save the summary as design-changes.md in my Documents folder.

מסמך מסירה מעיצוב לפיתוח

פרומפט

Every Friday at 16:00, read the Ready for dev page of my Figma file and write a short implementation brief for each frame on it: layout, spacing, colours and text styles, saved as handoff.md.

בדיקת ייצוא אייקונים

פרומפט

Every Tuesday at 10:00, look at the Icons page of my Figma file, download any icon that is not already in my project assets folder, and tell me which ones you added.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

מפעילים אותו בלי אסימון ושום דבר לא קורה

מה רואים

Either FIGMA_API_KEY or FIGMA_OAUTH_TOKEN is required (via CLI argument or .env file)

הפתרון

השרת מדפיס את השורה הזו ולא מדבר MCP בכלל, ולכן הלקוח שלכם ממתין ללחיצת יד שלא תגיע: אצלנו הוא חרג מהזמן אחרי 45 שניות. הוסיפו ‎--figma-api-key=YOUR-FIGMA-TOKEN לארגומנטים, או הגדירו את FIGMA_API_KEY בסביבה, והפעילו מחדש.

כל קריאה חוזרת עם 403 Invalid token

מה רואים

Error fetching file: Request to Figma API endpoint '/files/X4zPq7RtLmNvBcDsEfGhJk' returned 403 Forbidden.
Response body: {"status":403,"err":"Invalid token"}

Depending on the specific error message above, the issue may be one of the following:
- The access token is missing required scopes (File content: Read, Dev resources: Read)

הפתרון

זו השגיאה שגרמנו לה בכוונה: הרצנו את השרת עם אסימון דמה, ולכן Figma דחתה אותו. השרת ממשיך ומונה חמש סיבות אפשריות, ורק הראשונה מצוטטת למעלה; ארבע הנותרות הן אסימון שבוטל, הוקלד לא נכון או פג תוקפו (במקרה של OAuth), חשבון שאין לו גישה לקובץ המסוים הזה, הגדרות שיתוף שחוסמות העתקה וייצוא, ופרוקסי, חומת אש או VPN שעצרו את הבקשה לפני שהגיעה ל-Figma. צרו אסימון חדש עם שתי הרשאות הקריאה שהסיבה המצוטטת מונה, File content ו-Dev resources, ונסו שוב על אותו קובץ.

הדבקתם את כתובת ה-URL המלאה של Figma כמפתח הקובץ

מה רואים

Invalid fileKey: File key must be alphanumeric

הפתרון

הכלי רוצה רק את המפתח, לא את הכתובת. בכתובת figma.com/design/ABC123.../My-Design מפתח הקובץ הוא המקטע שמיד אחרי ‎/design/‎, אותיות וספרות בלבד. את זה הדביקו.

השרת הרשמי של Figma בפורט 3845 מסרב להתחבר

מה רואים

curl: (7) Failed to connect to 127.0.0.1 port 3845 after 0 ms: Couldn't connect to server

הפתרון

זה מה שקיבלנו על Mac ש-Figma מותקנת עליו: שום דבר לא האזין שם. השרת לשולחן העבודה קיים רק כל עוד אפליקציית Figma פתוחה והשרת מופעל בתוכה, במצב Dev Mode, בקטע MCP server של לוח ה-inspect, דרך Enable desktop MCP server. בנוסף Figma מגבילה אותו למושב Dev או Full בתוכניות בתשלום. אם זו לא התוכנית שלכם, השרת המתארח או חבילת הקהילה הזו הם הדרך פנימה.

לקוח ה-MCP לא מצליח להפעיל את השרת בכלל

הפתרון

הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב.

שאלות נפוצות

שאלות שאנשים שואלים.

מה זה שרת ה-MCP של Figma?

השם מכסה שני דברים שונים. השרת של Figma עצמה מגיע בתוך אפליקציית Figma לשולחן העבודה, רץ בכתובת http://127.0.0.1:3845/mcp כל עוד האפליקציה פתוחה, ודורש מושב Dev או Full בתוכנית בתשלום; ל-Figma יש גם גרסה מתארחת בכתובת https://mcp.figma.com/mcp מאחורי כניסת OAuth, שלפי מרכז העזרה שלה זמינה בכל המושבים והתוכניות. בנפרד, figma-developer-mcp של Framelink היא חבילת קהילה שאתם מריצים בעצמכם עם npx ועם אסימון גישה של Figma. זו החבילה שהעמוד הזה הריץ. [9][10][8][1]

מה בדיוק אימתתם?

את figma-developer-mcp, ורק עד נקודה מסוימת. היא עלתה, השלימה את לחיצת היד של MCP ומנתה את שני הכלים שלה, ומשם הגיעה הטבלה למעלה. אחר כך ביצענו קריאה אמיתית אחת עם אסימון דמה ו-Figma השיבה 403 Invalid token, שמודפסת במלואה למעלה. אין ברשותנו אסימון גישה אישי של Figma, ולכן שום קריאה מאומתת לא הצליחה כאן ואנחנו לא טוענים שכן. לגבי השרת הרשמי לשולחן העבודה יש לנו רק תוצאה שלילית: פורט 3845 דחה את החיבור על ה-Mac הזה.

אילו כלים כלולים ב-figma-developer-mcp?

שניים, והטבלה למעלה היא פלט ה-tools/list החי מילה במילה: get_figma_data, ששולף מתוך קובץ או מתוך צומת בודד את הפריסה, התוכן, החזות ומידע על רכיבים, ו-download_figma_images, ששומר נכסי SVG ו-PNG לתיקיה. התיאור של השני מסתיים בנתיב תיקיה אמיתי מפני שהשרת כותב לתוך תיאור הכלי של עצמו את תיקיית התמונות שאיתה הופעל. אצלנו הוא הציג ‎/tmp/figma-mcp-verify; אצלכם הוא יציג את תיקיית הפרויקט שלכם.

איך משיגים אסימון גישה של Figma?

ב-Figma, פתחו את תפריט החשבון בפינה השמאלית העליונה, בחרו Settings, אחר כך את הלשונית Security, גללו אל Personal access tokens ולחצו על Generate new token. התיעוד של Framelink מנחה לתת לו הרשאת קריאה ל-File content ול-Dev resources, ושגיאת ה-403 שלכדנו מונה בדיוק את שתי ההרשאות האלה ראשונות ברשימת הסיבות האפשריות. Figma מצהירה שהאסימון מוצג פעם אחת בלבד, לכן העתיקו אותו לפני שאתם עוזבים את העמוד. כדאי לדעת לפני שמדביקים אותו בכלי כלשהו: Figma מצהירה גם שאסימון גישה אישי מגיע לכל הקבצים והנתונים שלכם, ושאי אפשר להגביל אותו לקבצים מסוימים. [6][7]

צריך תוכנית בתשלום של Figma?

עבור השרת הרשמי לשולחן העבודה, כן: מרכז העזרה של Figma קובע שהוא זמין במושב Dev או Full בכל התוכניות בתשלום, ושהשרת המתארח זמין בכל המושבים והתוכניות. לחבילת הקהילה אין מגבלת תוכנית משלה, אבל היא יכולה לקרוא רק את מה שהאסימון שלכם יכול לקרוא, ולכן קובץ שאינכם יכולים לפתוח ב-Figma יישאר בלתי קריא גם דרך MCP. [8]

צריך טרמינל כדי להגדיר אותו?

לא. ב-Routines ממלאים שלושה שדות בהגדרות ולוחצים Test Connection; המדריך למעלה מראה כל לחיצה. Claude Desktop דורש עריכה חד-פעמית של קובץ JSON קטן. רק Claude Code הוא כלי טרמינל מטבעו. אסימון של Figma תצטרכו בכל מסלול שתבחרו. [14][11]

אילו אפליקציות יכולות להשתמש בשרת ה-MCP של Figma?

חבילת הקהילה היא שרת stdio פשוט, ולכן כל לקוח MCP שמסוגל להפעיל פקודה מקומית מריץ אותה: Claude Desktop, Claude Code, Cursor ו-Routines כולם יכולים, וההגדרה המדויקת לכל אחד נמצאת למעלה. השרת המתארח של Figma מחמיר יותר: לפי התיעוד שלו רק לקוחות שמופיעים בקטלוג ה-MCP של Figma, כמו VS Code, Cursor ו-Claude Code, רשאים להתחבר. [10][12][13][14]

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

  1. [1]

    npm registry: figma-developer-mcpנקרא בתאריך 2026-08-03

    Latest version 0.13.2, published 2026-06-18; license MIT; sole maintainer glips.

  2. [2]

    npm downloads API: last weekנקרא בתאריך 2026-08-03

    85,758 downloads for the week ending 2026-08-01.

  3. [3]

    GitHub: GLips/Figma-Context-MCPנקרא בתאריך 2026-08-03

    15,568 stars and a push dated 2026-07-03 at access time, per the GitHub API. Described as an MCP server for AI coding agents like Cursor.

  4. [4]

    Figma-Context-MCP LICENSE fileנקרא בתאריך 2026-08-03

    MIT License, Copyright (c) 2025 Graham Lipsman.

  5. [5]

    Figma-Context-MCP READMEנקרא בתאריך 2026-08-03

    Source of the npx args shape, and the note that FIGMA_API_KEY may be set in the env field instead.

  6. [7]

    Figma Learn: Manage personal access tokensנקרא בתאריך 2026-08-03

    The Settings, Security, Generate new token path; that the token displays only once; and that a personal access token reaches all your files and cannot be restricted.

  7. [8]

    Figma Learn: Guide to the Figma MCP serverנקרא בתאריך 2026-08-03

    States the remote server is available on all seats and plans, and the desktop server on a Dev or Full seat for all paid plans.

  8. [9]

    Figma Developer Docs: set up the desktop serverנקרא בתאריך 2026-08-03

    Gives the address http://127.0.0.1:3845/mcp, the Dev Mode inspect-panel toggle, and that it works only via the Figma desktop app.

  9. [10]

    Figma Developer Docs: set up the remote serverנקרא בתאריך 2026-08-03

    Gives the endpoint https://mcp.figma.com/mcp, the OAuth sign-in, and the restriction to clients in the Figma MCP catalogue.

  10. [11]

    modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

    The Claude Desktop config file path on macOS, and the Settings, Developer, Edit Config route that opens it.

  11. [12]

    Claude Code docs: MCPנקרא בתאריך 2026-08-03

    The claude mcp add syntax for local stdio servers, including passing environment variables.

  12. [13]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape and file locations.

  13. [14]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את Figma כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.

מאחורי המדריך הזה

Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הפתקים שלכם נשארים קובצי markdown על ה-Mac שלכם, אין חשבון ענן לשלם, והיא עובדת גם בלי אינטרנט. להורדת Routines