Figma MCP

Figma MCP

Figma REST API MCP サーバーです。ファイル内の最上位フレームを一覧表示するツールと、1 つのフレームのレンダリング済み PNG、そのノード JSON、画像塗りつぶしマップをローカルの出力ディレクトリに取得するツールの、2 つのツールを提供します。

インストール

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：最新の GitHub リリースから figma-mcp.mcpb をダウンロードして開きます。

セットアップ

1. figma.com のアカウント設定で、file_content:read スコープを持つ個人用アクセストークンを作成します。
2. Figma ファイルの URL からファイルキーを確認します。/design/ または /file/ の後に続く部分です。たとえば、https://www.figma.com/design/AbC123xyz/My-file の場合は AbC123xyz です。どちらのツールでも、これを file_key として指定します。
3. FIGMA_TOKEN が設定されていなくてもサーバーは起動してツールを一覧表示しますが、トークンが設定されるまでは呼び出しがすべて FIGMA_NOT_CONFIGURED で失敗します。
4. ファイルを書き込むツールは fetch_frame のみです（そのため読み取り専用としてマークされていません）。設定された出力ルートの下のディレクトリ（デフォルトは ./figma-output）に frame.png、node.json、fills.json を書き込みます。もう一方のツールは完全な読み取り専用です。

ツール（2）

ツール	機能
list_frames	Figma ファイル内のすべての最上位 FRAME ノードを一覧表示し、必要に応じてフィルタリングします。ページ名、名前、ノード ID の正確なデータ、寸法、ファイルメタデータも返します
fetch_frame	Figma フレームを 1 つ取得し、トランザクション処理で frame.png、node.json、正規化された画像塗りつぶしマップを出力ルートの下のディレクトリに書き込みます

設定

変数	必須	用途
FIGMA_TOKEN	はい	file_content:read を持つ Figma 個人用アクセストークン
FIGMA_API_BASE_URL	いいえ	Figma REST API のベース URL を上書きします（デフォルトは https://api.figma.com/v1）
FIGMA_REQUEST_TIMEOUT_MS	いいえ	リクエストごとのタイムアウト（ミリ秒、デフォルトは 60000）
FIGMA_MAX_JSON_BYTES	いいえ	Figma JSON レスポンスの上限サイズ（バイト、デフォルトは 104857600）
FIGMA_MAX_FRAME_BYTES	いいえ	ダウンロードするフレーム PNG の上限サイズ（バイト、デフォルトは 104857600）
FIGMA_OUTPUT_ROOT	いいえ	すべての fetch_frame 出力ディレクトリがその下に収まるディレクトリ（デフォルトは ./figma-output。初回使用時に作成されます）
FIGMA_ALLOW_HTTP_FOR_TESTS	いいえ	テストスイート専用：1 を指定すると、ループバック API ベース URL で平文 HTTP が許可されます。通常の使用では絶対に設定しないでください

返信形式

各ツールは、status（succeeded、partial、no_op）、summary、target、result、proof、warnings、recovery を含むプレーンな JSON を返します。失敗すると、<code>: <message> <hint> 形式のプレーンなエラー文字列をスローします。

制限事項

fetch_frame は Figma の画像 API 経由でレンダリングするため、非常に大きなフレームや極端なスケール値は、設定された JSON またはフレームのバイト数上限を超えることがあります。その場合は scale を下げるか、フレームを分割してください。fills.json の URL は一時的なもので、14 日以内に期限切れになります。

検証

各リリースでは、パッケージのバージョン、.mcpb の sha256、本番用コミットの派生元を CHANGELOG.md に記載しています。CI では、プッシュのたびにテストと、パッケージ化された tarball のクリーンインストールを実行します。

プライバシーポリシー

このサーバーは、ユーザー自身の認証情報を使って、ユーザーのマシン上でローカルに実行されます。個人データを収集せず、テレメトリーも含まず、明示的に取得したフレームバンドル以外のデータを永続的に保存せず、ラップするベンダー API のみと通信します。Scalably を含む第三者がユーザーのデータを受け取ることはありません。お問い合わせ先：[email protected]。正式版：https://scalably.io/connector-privacy.html

ライセンス

MIT。Copyright Scalably.