תקציר שבועי של שינויי עיצוב
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.
שרת MCP מאומת: Figma
רשימת הכלים למטה היא לכידה חיה מהשרת הרץ; קריאת כלי מאומתת עדיין ממתינה להרשאות.
התשובה הקצרה
אומת לאחרונה 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]
אימות
השיטה
הרצנו את 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 |
פרמטרים המסומנים ב-* הם חובה.
התקנה
העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.
פתחו את הקובץ ~/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 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/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]
בלי קובץ 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]
בלי טרמינל
אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות. בשונה משרת הקבצים, השרת הזה דורש קודם אסימון של Figma, ולכן זהו שלב שתיים.
01
הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.
02
ב-Figma, פתחו את תפריט החשבון בפינה השמאלית העליונה, בחרו Settings, פתחו את הלשונית Security, גללו אל Personal access tokens ולחצו על Generate new token. תנו לו הרשאת קריאה ל-File content ול-Dev resources. העתיקו אותו מיד: Figma מציגה את האסימון פעם אחת בלבד, ואם תעברו מהעמוד תצטרכו ליצור חדש.
03
חזרה ב-Routines, לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.
04
העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה שמריצים, לא כתובת אינטרנט. השרתים הרשמיים של Figma הם דווקא מסוג הכתובת, והם מכוסים בהמשך העמוד.
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.
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 בסביבה, והפעילו מחדש.
מה רואים
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, ונסו שוב על אותו קובץ.
מה רואים
Invalid fileKey: File key must be alphanumeric
הפתרון
הכלי רוצה רק את המפתח, לא את הכתובת. בכתובת figma.com/design/ABC123.../My-Design מפתח הקובץ הוא המקטע שמיד אחרי /design/, אותיות וספרות בלבד. את זה הדביקו.
מה רואים
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 בתוכניות בתשלום. אם זו לא התוכנית שלכם, השרת המתארח או חבילת הקהילה הזו הם הדרך פנימה.
הפתרון
הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב.
שאלות נפוצות
השם מכסה שני דברים שונים. השרת של 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 הזה.
שניים, והטבלה למעלה היא פלט ה-tools/list החי מילה במילה: get_figma_data, ששולף מתוך קובץ או מתוך צומת בודד את הפריסה, התוכן, החזות ומידע על רכיבים, ו-download_figma_images, ששומר נכסי SVG ו-PNG לתיקיה. התיאור של השני מסתיים בנתיב תיקיה אמיתי מפני שהשרת כותב לתוך תיאור הכלי של עצמו את תיקיית התמונות שאיתה הופעל. אצלנו הוא הציג /tmp/figma-mcp-verify; אצלכם הוא יציג את תיקיית הפרויקט שלכם.
ב-Figma, פתחו את תפריט החשבון בפינה השמאלית העליונה, בחרו Settings, אחר כך את הלשונית Security, גללו אל Personal access tokens ולחצו על Generate new token. התיעוד של Framelink מנחה לתת לו הרשאת קריאה ל-File content ול-Dev resources, ושגיאת ה-403 שלכדנו מונה בדיוק את שתי ההרשאות האלה ראשונות ברשימת הסיבות האפשריות. Figma מצהירה שהאסימון מוצג פעם אחת בלבד, לכן העתיקו אותו לפני שאתם עוזבים את העמוד. כדאי לדעת לפני שמדביקים אותו בכלי כלשהו: Figma מצהירה גם שאסימון גישה אישי מגיע לכל הקבצים והנתונים שלכם, ושאי אפשר להגביל אותו לקבצים מסוימים. [6][7]
עבור השרת הרשמי לשולחן העבודה, כן: מרכז העזרה של Figma קובע שהוא זמין במושב Dev או Full בכל התוכניות בתשלום, ושהשרת המתארח זמין בכל המושבים והתוכניות. לחבילת הקהילה אין מגבלת תוכנית משלה, אבל היא יכולה לקרוא רק את מה שהאסימון שלכם יכול לקרוא, ולכן קובץ שאינכם יכולים לפתוח ב-Figma יישאר בלתי קריא גם דרך MCP. [8]
לא. ב-Routines ממלאים שלושה שדות בהגדרות ולוחצים Test Connection; המדריך למעלה מראה כל לחיצה. Claude Desktop דורש עריכה חד-פעמית של קובץ JSON קטן. רק Claude Code הוא כלי טרמינל מטבעו. אסימון של Figma תצטרכו בכל מסלול שתבחרו. [14][11]
חבילת הקהילה היא שרת stdio פשוט, ולכן כל לקוח MCP שמסוגל להפעיל פקודה מקומית מריץ אותה: Claude Desktop, Claude Code, Cursor ו-Routines כולם יכולים, וההגדרה המדויקת לכל אחד נמצאת למעלה. השרת המתארח של Figma מחמיר יותר: לפי התיעוד שלו רק לקוחות שמופיעים בקטלוג ה-MCP של Figma, כמו VS Code, Cursor ו-Claude Code, רשאים להתחבר. [10][12][13][14]
מקורות
כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.
[1]
Latest version 0.13.2, published 2026-06-18; license MIT; sole maintainer glips.
[2]
[3]
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]
[5]
Source of the npx args shape, and the note that FIGMA_API_KEY may be set in the env field instead.
[6]
How to generate the personal access token, and the required File content and Dev resources read scopes.
[7]
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.
[8]
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.
[9]
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.
[10]
Gives the endpoint https://mcp.figma.com/mcp, the OAuth sign-in, and the restriction to clients in the Figma MCP catalogue.
[11]
The Claude Desktop config file path on macOS, and the Settings, Developer, Edit Config route that opens it.
[12]
The claude mcp add syntax for local stdio servers, including passing environment variables.
[13]
[14]
How Routines runs one-click OAuth connectors and any MCP server.
העמוד הזה מתאר את Figma כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.
מאחורי המדריך הזה
Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הפתקים שלכם נשארים קובצי markdown על ה-Mac שלכם, אין חשבון ענן לשלם, והיא עובדת גם בלי אינטרנט. להורדת Routines