Figma MCPサーバーの設定方法とClaude Codeとの連携手順。デザインファイルからコードを生成する実践的なワークフロー。
Figma MCPサーバーの設定方法とClaude Codeとの連携手順。デザインファイルからコードを生成する実践的なワークフロー。
ブログ目次
HubSpot導入、AI活用、CRM整備、業務効率化までをまとめて支援しています。記事で気になったテーマを、そのまま相談ベースで整理できます。
Figma MCPサーバーの設定方法とClaude Codeとの連携手順。デザインファイルからコードを生成する実践的なワークフロー。
本記事は「Claude Code実践ガイド|AI開発の生産性を高める運用設計」シリーズの一部です。
Figma MCPサーバーを使えば、Claude CodeがFigmaのデザインファイルを直接読み取り、プロジェクトの技術スタックに合わせたコードを生成できます。 デザイナーとエンジニアの間にあった「デザイン→コード変換」の手作業を、AIで大幅に効率化する手法を解説します。
FigmaのデザインファイルをClaude Codeが直接読み取り、プロジェクトの技術スタックに合ったコードを自動生成する方法を解説します。デザイナーとエンジニア間の「デザイン→コード変換」を大幅に効率化できます。
対象読者: Figmaでデザインを受け取りコード実装を行うフロントエンドエンジニア、デザイン→実装の効率化を図りたいチーム
Figma MCPサーバーは、Figmaが公式に提供するMCP(Model Context Protocol)対応のサーバーです。Claude CodeのMCP連携機能を通じて、Figmaのデザインデータにアクセスできます。
| ツール | 機能 |
|---|---|
get_design_context |
デザインノードのコード・スクリーンショット・コンテキストヒントを取得 |
get_screenshot |
特定ノードのスクリーンショットを取得 |
get_metadata |
ファイル・ノードのメタデータを取得 |
get_code_connect_map |
Code Connectマッピング情報を取得 |
search_design_system |
デザインシステム内のコンポーネントを検索 |
Claude Codeの設定ファイルにFigma MCPサーバーを追加します。
// .claude/settings.json
{
"mcpServers": {
"figma": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@anthropic/figma-mcp-server"],
"env": {
"FIGMA_ACCESS_TOKEN": "your-figma-token"
}
}
}
}
Figmaの「Settings → Personal Access Tokens」からトークンを生成し、上記の設定に反映します。
claude
> /mcp
# Figmaサーバーの接続状態を確認
デザイナーが完成したデザインのFigma URLをClaude Codeに共有します。
figma.com/design/ABC123/MyProject?node-id=1:234
URLからfileKey(ABC123)とnodeId(1:234)が抽出されます。
Claude Codeがget_design_contextを呼び出し、デザインの構造・スクリーンショット・コードヒントを取得します。
レスポンスには以下が含まれます。
取得したデザイン情報をもとに、Claude Codeがプロジェクトの技術スタック(React、Vue、Next.jsなど)に合わせたコードを生成します。
「このFigmaデザインをNext.js + Tailwind CSSで実装してください。
既存のコンポーネント(src/components/)を優先的に再利用してください。」
Code Connectは、Figmaコンポーネントとコードベースのコンポーネントを紐づける仕組みです。
// figma.connect.ts
import figma from "@figma/code-connect";
import { Button } from "./src/components/Button";
figma.connect(Button, "figma-node-url", {
props: {
label: figma.string("Label"),
variant: figma.enum("Variant", {
Primary: "primary",
Secondary: "secondary"
})
},
example: (props) => <Button variant={props.variant}>{props.label}</Button>
});
Figma MCPの真価は、デザインデータを「画像」としてではなく「構造化された情報」としてClaude Codeに渡せる点にあります。デザイントークン、コンポーネント構造、アノテーションがすべて機械可読な形で取得されるため、プロジェクトの技術スタックに合った精度の高いコード生成が可能になります。
Code Connectが設定されていると、Claude Codeはデザインのコンポーネントを自動的にコードベースの既存コンポーネントにマッピングします。新規にコンポーネントを作るのではなく、プロジェクトにあるものを再利用する設計です。
Figmaで作成されたLP(ランディングページ)のデザインを、Claude Codeで一気にHTML/CSSに変換します。HubSpot CMSのテンプレートとして実装する場合にも有効です。
経営ダッシュボードのFigmaモックアップから、Reactコンポーネントを生成します。チャートライブラリやデータテーブルの既存コンポーネントをCode Connectで紐づけておけば、デザインの意図に忠実な実装が可能です。
search_design_systemツールでデザインシステム内のコンポーネントを検索し、実装時に正しいコンポーネントが使われているかを確認できます。
デザインからコードへの変換は、従来「エンジニアの手作業」に依存していました。Figma MCPとClaude Codeの連携は、この工程を自動化し、デザイナーとエンジニアの連携コストを下げます。
少数精鋭チームでは、デザインと実装を兼務するメンバーも多いでしょう。AIがデザイン→コード変換の8割を処理し、人間が残り2割の微調整に集中する――このワークフローが、スモールチームの開発速度を飛躍的に高めます。AI活用のさらなる事例については、経営データBI支援やコンテンツマーケティング支援のページもご覧ください。
本記事ではClaude CodeとFigmaを連携し、デザインからコード実装までをAIで一気通貫する方法を解説しました。
.claude/settings.jsonに設定することで、Claude CodeがFigmaのデザインデータ(構造・スクリーンショット・デザイントークン)を直接読み取れますClaude Codeの全コマンド一覧はClaude Codeチートシートをご覧ください。AI活用の全体像はAI活用完全ガイドで解説しています。
AI × デザイン実装の効率化についてのご相談は、StartLinkまでお気軽にお問い合わせください。Claude CodeやFigma連携を活用した開発ワークフローの構築を支援しています。
Figma MCPサーバー自体はnpxで実行できるオープンソースツールですが、FigmaのパーソナルアクセストークンとAPIアクセスが必要です。Figmaの無料プランでもAPIアクセスは可能ですが、チームでの共同編集やデザインシステム機能をフル活用する場合はProfessional以上のプランが推奨されます。
Code Connectを設定すると、FigmaのデザインコンポーネントとコードベースのReact/Vueコンポーネントが自動的にマッピングされます。これにより、Claude Codeはデザインを見たときに新規コンポーネントを作るのではなく、プロジェクトにある既存コンポーネントを再利用したコードを生成します。デザインシステムの一貫性を保ちながら実装速度を上げられる点が最大のメリットです。
Figma MCPサーバーが返すデザイン情報はReact + Tailwind CSSベースのコードヒントを含みますが、Claude Code側でプロジェクトの技術スタック(Vue、Next.js、Svelte、HubSpot CMSなど)に合わせて変換できます。プロンプトで技術スタックを明示し、既存コンポーネントの再利用を指示することで、プロジェクトに適したコードが生成されます。
FigmaパーソナルアクセストークンはFigmaアカウントの全ファイルにアクセスできるため、チームで共有せず個人ごとに発行してください。トークンは.claude/settings.jsonに直接書くのではなく、環境変数経由で渡すことが推奨されます。また、デザインデータがClaude APIに送信される点を踏まえ、NDA対象のクライアントデザインを扱う場合は事前に確認を取りましょう。
Code Connectが設定されている場合は、既存コンポーネントを再利用した高品質なコードが生成されます。未設定の場合でも、デザイントークン(カラー・フォント・スペーシング)に基づいた構造化されたコードが出力されますが、プロジェクト固有のコーディング規約や命名規則については、CLAUDE.mdやプロンプトで補足する必要があります。
株式会社StartLinkは、事業推進に関わる「販売促進」「DXによる業務効率化(ERP/CRM/SFA/MAの導入)」などのご相談を受け付けております。 サービスのプランについてのご相談/お見積もり依頼や、ノウハウのお問い合わせについては、無料のお問い合わせページより、お気軽にご連絡くださいませ。
株式会社StartLink 代表取締役。累計150社以上のHubSpotプロジェクト支援実績を持ち、Claude CodeやHubSpotを軸にしたAI活用支援・経営基盤AXのコンサルティング事業を展開。
HubSpotのトップパートナー企業や大手人材グループにて、エンタープライズCRM戦略策定・AI戦略ディレクションを経験した後、StartLinkを創業。現在はCRM×AIエージェントによる経営管理支援を専門とする。