PR

目分量の実装から脱却する。Figma MCP×Antigravityでデザインデータを高い再現性でコード化する実践アプローチ

AI・自動化・開発

「デザイナーから受け取ったFigmaの余白やフォントサイズを、インスペクターで1つずつ確認しながらCSSに書き写す」

Web制作やアプリケーション開発の現場において、デザインから実装へとバトンを渡すフェーズには、常に地道な「転記作業」と「目分量の摩擦」が存在します。どれほど精緻にデザインシステムやスタイルガイドが整備されていても、開発者が手作業で数値を拾い上げる限り、ピクセル単位のズレやスタイルの解釈違いを完全に防ぐのは困難です。

この課題に対し、単にデザインのスクリーンショット画像をAIに見せるだけでなく、Figmaの構造化データ(ノードツリー、Auto Layout、デザイントークン)をAIコンテキストに連携する「Figma MCP(Model Context Protocol)」と「Antigravity」の組み合わせが実務レベルで注目されています。

本記事では、Figma公式MCPを活用してデザインからコードへの変換精度を高める実践フロー、Antigravityにおける接続条件(デスクトップMCP経由・対象プラン利用資格)、構造データと視覚情報(スクリーンショット)のハイブリッド活用、そしてAIの出力を過信しないための「二層防御(人間承認・差分監査)」の要点を整理します。


1. 「スクショ認識」と「Figma MCP連携」の決定的な違い

これまでのマルチモーダルAIを用いたデザイン再現では、主に「画面キャプチャ画像をプロンプトに添付する」という手法が一般的でした。

しかし、画像ベースの認識には実務上いくつかの限界があります。

比較項目 画像キャプチャベース(推測) Figma MCP連携(構造参照)
レイアウト構造 見た目の推定(FlexboxやGridの入れ子が崩れやすい) Auto Layoutの設定値や階層関係を参照しやすい
余白(Padding/Gap) AIによる目分量推測(影や境界でブレが生じやすい) Figma内で定義された実数値(8px, 16px, 24px等)を直接参照
デザイントークン 画像圧縮や色空間でカラーコードが揺らぐリスク 定義されたHex値やセマンティックカラー変数を直接取得
タイポグラフィ 類似フォントの推測適用になりがち 取得可能なスタイル情報(フォント名、ウェイト、行高)を参照できる

※MCPを導入した場合でも、出力されるCSSの解釈やレスポンシブ設計、ブラウザのフォント環境によって最終的な見た目は変化します。「完全一致が自動保証される」わけではなく、「画像推測に比べて正確な数値を参照でき、再現性を大幅に高めやすい」という性質の技術です。

なお、構造化データだけでは視覚的な仕上がり(重ね合わせや微細なテクスチャ感など)を十分に判断できない場合があります。Figma公式のベストプラクティスでも推奨されているように、Figma MCPで取得したレイアウトやスタイル情報に加え、必要に応じて対象フレームのスクリーンショット(get_screenshot等)も併用して参照することで、構造と見た目の両面から実装精度を強固に担保できます。


2. 連携環境の基本構成と「Antigravityの接続条件」

AntigravityとFigmaを接続する共通インターフェースが、オープン標準として普及が進む「MCP(Model Context Protocol)」です。

[ Figma Design Data ]
         │ (Figma Desktop MCP サーバー / 読み取り専用)
         ▼
[ Figma MCP Server ] ── (get_design_context / get_metadata / get_screenshot 等)
         │ (構造化データ + 視覚情報のコンテキスト)
         ▼
[ Antigravity Agent ] ── (指示に基づきプロジェクト構成・既存UIと結合) ──> [ React / Tailwind CSS ]

💡 Antigravityで利用する場合の接続上の注意と利用資格

Figma MCPには「リモートサーバー」と「デスクトップサーバー」の2種類が存在します。Figma公式カタログにおいて、Google Antigravityはデスクトップサーバー経由の「ローカル・読み取り専用」接続として案内されています。

デスクトップMCPサーバーの利用には、対応するFigmaデスクトップアプリに加え、対象プラン(有料プラン)でのDevまたはFull seatが必要です。利用資格や接続可能な最新クライアントは、導入前にFigma公式の最新ドキュメントをご確認ください。

なお、Figma側の接続が読み取り専用であっても、取得したデザイン情報をもとにローカルの開発プロジェクト内でファイルを生成・編集することは、エージェント(Antigravity)側の権限と設定に応じて可能です(Figmaキャンバス自体を直接書き換える機能とは区別して運用します)。

実務における留意点:巨大なノード構造によるコンテキスト圧迫

Figmaのデザインデータは、階層が深くなったりアイコンなどのベクターデータ(複雑なSVGパス座標)が多く含まれると、取得されるコンテキスト量が跳ね上がります。

無加工のまま巨大なノードデータをLLMに渡すと、トークン消費が増えるだけでなく、入力情報が多すぎてAIが主要なレイアウト構造を見落とす「コンテキスト腐敗(Context Rot)」の原因にもなり得ます。

そのため、実務では以下の運用配慮が推奨されます。

  1. 特定フレームの絞り込み: ファイル全体の広範な探索を避け、実装対象となるフレームやコンポーネントのノードリンクを渡す
  2. ベクターの分離: アイコン等の複雑な描画データは無理にコード生成させず、lucide-react 等の既存アイコンライブラリへのマッピングを指示する
  3. 必要な情報の選択: Auto Layout、余白、タイポグラフィ、カラートークンなど、実装に必要な情報に焦点を絞る

3. 「Figma Dev Mode / Code Connect」と「AIエージェント」の役割の違い

Figma公式には、コードスニペットを表示する「Dev Mode」や、既存のリポジトリコードとデザインコンポーネントを紐付けて再利用を支援する「Code Connect」が存在します。これらとAntigravityのような自律エージェントの決定的な違いは、「コード片の確認・紐付け支援ツール」か「リポジトリでの実装プロセスを担うエージェントか」にあります。

領域・機能 Figma Dev Mode / Code Connect Antigravity + Figma MCP
利用形態 インスペクター画面でのコードスニペット確認・コンポーネント紐付け プロンプト指示によるファイルの生成・コード配置
既存コードとの適合 Code Connectによる事前の手動マッピングで既存コンポーネントの再利用を強力に支援 プロジェクト内の既存UIコンポーネントを参照した組み立てが可能(要指示)
型定義・ロジック結合 静的なCSS/マークアップ提示が中心 TypeScriptのProps定義や状態変数のスケルトンを補完
検証プロセス ブラウザ目視確認 指示に基づきリンターやTypeScriptのコンパイル検査を実行

※エージェントによるファイル生成やテスト実行は、作業ディレクトリの権限や与えるプロンプトの具体性に依存します。単にMCPを繋ぐだけで自動化されるわけではなく、適切な指示と開発環境の整備が前提となります。


4. 実践:デザインURLからコンポーネントを出力する手順

Figma MCPを活用してコンポーネントを実装する基本的な流れは以下の通りです。

ステップ1:対象フレームのURLを取得する

ファイル全体のURLでも解釈可能な場合がありますが、実装したい特定のフレームやコンポーネントを選択した状態のリンクを渡すことで、AIが意図した範囲を正確に把握しやすくなります。

  1. Figma上で実装対象のフレームを選択
  2. 右クリック ➔ 「Copy link」(または上部共有ボタン ➔ 「Copy link」)を選択
  3. URLに特定ノードを示すパラメータ(?node-id=...)が含まれていることを確認
# 推奨:対象フレームに絞り込んだリンク(意図が明確に伝わりやすい)
figma.com/design/[FILE_KEY]/[TITLE]?node-id=102-345

# ファイル全体のリンク(ファイル規模が大きい場合は絞り込みを推奨)
figma.com/design/[FILE_KEY]/[TITLE]

ステップ2:既存デザインシステムと結合させるプロンプト

AIにゼロから独自のHTMLタグを組ませると、プロジェクト共通のボタンやカードコンポーネントと重複した孤立コードが生まれやすくなります。プロジェクト内のUIライブラリやデザイントークン設定、そして「構造と見た目の事前照合」をプロンプトで明示します。

【プロンプト指示の例】
以下のFigmaフレームを参照し、React (TypeScript) + Tailwind CSS のコンポーネントを作成してください。

対象URL: figma.com/design/[FILE_KEY]/[TITLE]?node-id=102-345

【実装要件】
1. 実装前の照合:対象フレームの構造情報(Auto Layoutやトークン)を取得し、必要に応じてスクリーンショットとも照合してレイアウト意図を把握すること
2. ゼロからdivやボタンを自作せず、既存の「@/components/ui/button」「@/components/ui/card」を活用すること
3. カラーコードはインラインHexを避け、プロジェクト既存のデザイントークン定義(tailwind.config.js の bg-primary やCSS変数等)にマッピングすること
4. Auto Layoutの設定に基づき、適切なflex/gridクラスを構成すること
5. コンポーネント名は「UserProfileCard」とし、Props型定義を明記すること
6. 実装完了後、package.jsonに定義されている検証スクリプト(npm run lint や tsc 等)を実行してエラーがないか検証すること

ステップ3:利用可能なMCPツールによる情報取得と検証

指示を受けたエージェントは、Figma MCPのツール(選択範囲の詳細を取得する get_design_context や、構造概要を取得する get_metadata、スタイル変数定義の get_variable_defs、視覚確認用の get_screenshot 等)を実行してノードツリーやトークン情報を取得します。その情報をもとにファイルを生成し、指示された検証コマンドを実行してエラーを解消していきます。

※コード生成と静的検証が完了した後も、開発サーバー上で実際にブラウザ表示を行い、レスポンシブな崩れやフォントの適用状態を目視確認するステップを必ず設けてください。


5. AI過信を防ぐ「二層防御(運用ガードレール)」の規律

Figma MCPは非常に有用なインターフェースですが、MCPそのものがコードの品質やアクセシビリティを保証してくれるわけではありません。実務で破綻を防ぐためには、「AIの下準備(80%)+ 人間の監査・承認(20%)」という二層防御の規律が不可欠です。

① Auto Layoutが組まれていないデザインの限界

Figma側でAuto Layout(自動整列)が設定されておらず、絶対座標(Absolute)で要素が配置されている場合、MCP経由であっても「絶対配置に依存した崩れやすいコード」が出力されやすくなります。デザイン側のレイアウト規律がそのままコードの品質に影響します。

② セマンティックタグとアクセシビリティの監査

Figmaのノード情報は基本的に描画ツリー(Frame, Rectangle, Text)です。それが <button> なのか <a> なのか、適切な見出し順(<h2>, <h3>)やARIA属性が設定されているかは、人間がコードレビューで監査して補正する必要があります。

③ Git差分確認(git diff)とコミット承認の必須化

AIが生成したファイルは、自動でコミットやデプロイを行わせず、必ず人間が git diff で変更差分を確認し、テストが通過したことを確認してからマージする運用を徹底してください。


6. まとめ:手動の転記をなくし、本質的な設計に集中する

Figma公式MCPとAntigravityの連携は、「デザインの見た目を適当に真似させる」ためのツールではありません。「デザインの構造化データを正確に参照し、実装の手戻りを減らすためのパイプライン」です。

  1. インスペクターで数値を1つずつ転記する作業から解放される
  2. Auto Layoutとデザイントークンを参照した再現性の高い骨組みを素早く得る
  3. 人間はアクセシビリティ、状態管理、テスト、差分レビューという本質的な品質向上に専念する

ツールの特性と限界(二層防御の必要性)を正しく理解して運用することで、フロントエンド実装における「デザインと実装の間の壁」を着実に低減できます。

☕ 思考を研ぎ澄ます合間に「普通のコーヒー」を焼いています

036 Factoryの本業は、ご注文をいただいてから生豆を一粒ずつ手作業で選別(ハンドピック)して焙煎する、小さな自家焙煎珈琲工房です。

AIの実装やプログラミング、執筆で加熱した頭をふっとリセットする、雑味のない「毎日飲める普通のコーヒー」を少量ずつ丁寧に焼いています。作業や思考の合間のひと休みに、ぜひ一度うちの工房を覗いてみてください。

タイトルとURLをコピーしました