ClaudeからFigmaが読めない…MCP接続タイムアウトをローカル接続で解消した話

少し前の話ですが・・・

Claude（AIアシスタント）からFigmaのデザインファイルを読み込みながら作業をしていたところ、ある日突然、読み込みのタイムアウトが頻発するようになりました。前日は「たまに失敗する」程度だったのが、当日は終日ほぼ読めない状態に。

厄介だったのは、「全部ダメ」ではなかったことです。認証の確認やページ一覧のような軽い呼び出しは通るのに、デザインの中身を読む呼び出しだけが2回連続で時間切れになる。中途半端に動くぶん、原因の見当がつけにくい状態でした。

■ まずやったこと：障害かどうかの切り分け

最初に確認したのは、Figma公式のステータスページ（status.figma.com）です。結果は全システム正常・障害報告なし。

ここで状況が見えてきました。障害でも認証切れでもないなら、原因は接続の経路にある。

ClaudeとFigmaは「MCP」という仕組み（AIと外部ツールをつなぐ共通の窓口のようなもの）でつながっていて、私の環境ではインターネット経由の「リモートMCP」を使っていました。軽いやり取りは通るのに重い読み取りだけ失敗するのは、この経路がデータ量の多い読み取りで時間切れになっているからだ、と特定できました。

■ 解決策：デスクトップアプリの「ローカルMCP」に切り替える

Figmaのデスクトップアプリには、自分のPCの中で直接やり取りできるMCPサーバーが用意されています。インターネットの向こう側を経由しないので、重い読み取りでも安定します。手順は次の5つです。

1. Figmaデスクトップアプリで、通常のデザインファイルを開く（※Figma Makeの画面だと設定項目が出ません。ブラウザ版も不可）

2. 左上メニュー → 基本設定 →「デスクトップMCPサーバーを有効にする」をオン（Ctrl+Kのアクション検索からも見つかります）

3. ターミナルで接続コマンドを実行（コマンドはFigma公式ガイド「Set up the desktop server」を参照してください）

https://developers.figma.com/docs/figma-mcp-server/local-server-installation/

4. 接続できたことを確認

5. 新しいセッションを開いて読み込むと、今までのタイムアウトが嘘のように一瞬で完了

■ 注意点2つ

・デスクトップMCPは、Figmaデスクトップアプリを起動して対象ファイルを開いた状態で使用

・ローカル経由で使えるのは読み取り系のみ。書き込みはリモート経由のままですが、応答のデータ量が小さいので通りやすい

■ まとめ

今回の学びは「公式ステータスページが正常なら、自分側で対処できるサイン」ということでした。同じところでつまずいた方の参考になればうれしいです。

---

そよかぜの図案室では、デザインから実装までを効率よく丁寧に進めています。制作のご相談もお気軽にどうぞ。

▼ Studioでデザイン重視のHP制作（デザイン×Studio）

https://coconala.com/services/3593996

▼ その他のサービス・制作実績はプロフィールから

https://coconala.com/users/4486068