К основному содержанию
плагин

f-mcp-bridge — плагин для Claude Code: Figma без REST-токена

Плагин f-mcp-bridge для Claude Code связывает Claude с Figma через локальный мост для чтения, записи и разбора макетов. Используется для аудита дизайн-системы и генерации экранов.

MIT ★ 10 обновлён 2026-10-15

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install f-mcp-bridge@claude-community
Открыть на GitHub

Что делает f-mcp-bridge

Плагин поднимает мост между Claude и Figma на localhost (порты 5454–5470). Внутри — MCP-инструменты, скиллы и слэш-команды: чтение слоёв, запись изменений, анализ макетов. REST-токен Figma не нужен, потому что данные идут через локальный плагин, а не через облачный API.

Дизайн-система подключается сама: агент сканирует библиотеки, на которые подписан файл, открытые library-файлы и источники существующих instance'ов, а находки складывает в .claude/design-systems/registry.local.md. Если сигналов нет, он один раз спросит ссылку на библиотеку. Для ручного управления есть /add-library, /ds-add <Figma-URL> и /ds-sync <ds-name>.

Claude и Figma должны работать на одной машине. Сессия, которая крутится в облаке — Claude на claude.ai/code или Claude Chat в браузере — до моста не дотянется, и плагин останется в жёлтом состоянии «auto-connect». В Claude Desktop нет субагентов, слэш-команд и авто-подхвата plugin.json, поэтому там инструкции скиллов приходится вставлять в промпт руками. Перед новым чатом полезно прогнать bash scripts/cleanup-ports.sh — скрипт убивает зависшие процессы FMCP, не трогая остальные.

Какие задачи решает

  • вытащить цвета и токены из макета Figma
  • сгенерировать экран логина по своей дизайн-системе
  • проверить макет на соответствие DS и доступность
  • обновить локальный кеш дизайн-системы из Figma
  • отследить изменения компонентов и токенов между версиями файла

Примеры запросов агенту

  • Вытащи цвета и типографику с этого экрана Figma
  • Сделай экран логина по нашей дизайн-системе
  • Проверь этот макет на соответствие DS и доступность

Как установить f-mcp-bridge

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install f-mcp-bridge@claude-community

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о f-mcp-bridge

Как установить f-mcp-bridge в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add anthropics/claude-plugins-community, затем поставьте плагин: /plugin install f-mcp-bridge@claude-community. После установки перезапустите Claude и откройте в Figma Plugins → F-MCP ATezer Bridge.

Что делает f-mcp-bridge?

Соединяет Claude с Figma через локальный мост: читает и меняет макеты, разбирает дизайн-систему, проверяет доступность и генерирует экраны. Работает без REST-токена Figma.

Почему плагин не подключается из облачной сессии?

Мост слушает только localhost, и плагин Figma тоже ходит только туда. Claude и Figma должны быть на одном компьютере — веб-версия и мобильное приложение до моста не достанут.

Исходный текст

SKILL.md · MIT
<p align="center">
  <img src="assets/logo.png" alt="F-MCP Bridge Logo" width="280" />
</p>

# F-MCP (Figma MCP Bridge)

<p align="center">
  <a href="https://www.npmjs.com/package/@atezer/figma-mcp-bridge"><img src="https://img.shields.io/npm/v/@atezer/figma-mcp-bridge?label=npm&color=0A7CFF" alt="npm"></a>
  <a href="https://github.com/atezer/FMCP/releases/tag/v1.9.15"><img src="https://img.shields.io/badge/sürüm-v1.9.15-success" alt="version"></a>
  <img src="https://img.shields.io/badge/araç-63-blue" alt="63 tools">
  <img src="https://img.shields.io/badge/skill-29-blue" alt="29 skills">
  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-güncel-brightgreen" alt="changelog"></a>
</p>

> **Yeni — v1.9.15 DS Change Tracker:** `/track-ds-changes <figma-url>` ile design system dosyalarınızda bileşen, varyant, token ve ikon değişikliklerini takip edin — snapshot karşılaştırması (token + bileşen) ve REST sürüm geçmişi (bileşen/yapı), "eski → yeni" rapor ve onaylı iş taslağı. Zamanlanmış görev olarak da çalışır. Detay: [Release notes](https://github.com/atezer/FMCP/releases/tag/v1.9.15) · [ds-change-tracker SKILL](skills/ds-change-tracker/SKILL.md) · [Kurulum rehberi](docs/DS_CHANGE_TRACKING.md).
>
> **Son sürüm — v1.9.15 (6 Ekim 2026):** DS Change Tracker — DS değişiklik takibi + iş taslağı (63 tool, 29 skill, 132/132 test). Önceki öne çıkanlar: v1.9.14 Contract Extractor ([extract-contract](skills/extract-contract/SKILL.md)), v1.9.13 sıfır-kurulum DS oto-uyumlanma. Detay: [CHANGELOG](CHANGELOG.md) · [Release notes](https://github.com/atezer/FMCP/releases/tag/v1.9.15)

Figma tasarımlarınızı AI'a bağlar. AI'a *"Bu ekrandaki renkleri çıkar"* veya *"Yeni bir login sayfası oluştur"* dersiniz — AI Figma'daki tasarımınızla doğrudan çalışır.

Her şey **bilgisayarınızda** kalır. Tasarım verileriniz internete gönderilmez.

---

## Neye ihtiyacım var?

| Gerekli | Açıklama |
|---------|----------|
| **Figma** | Zaten kullanıyorsanız hazırsınız |
| **Claude Code** | Kurulumu yapacak uygulama — [claude.ai/download](https://claude.ai/download) adresinden indirin |

> **Claude Code nedir?** Bilgisayarınızda çalışan Claude versiyonu. Dosya oluşturabilir, komut çalıştırabilir, kurulum yapabilir. İndirdikten sonra kurulum için sadece bir kez kullanacaksınız.

---

## Kurulum (5 dakika)

**1.** [Claude Code'u indirin](https://claude.ai/download) (henüz yoksa)

**2.** Claude Code'u açın ve şunu yazın:

> *"https://github.com/atezer/FMCP bu repoyu kur"*

Claude gerekli her şeyi (Node.js, build, ayarlar) otomatik yapar. Sizden sadece gerekirse **bilgisayar şifreniz** istenir.

**3.** Claude "kurulum tamamlandı" deyince **Claude Code'u kapatıp tekrar açın**

**4.** Figma'da **Plugins → F-MCP ATezer Bridge** açın → yeşil **"Ready"** görün

**5.** Hazırsınız! Claude'a Figma ile ilgili sorularınızı sorun.

> **Plugin'i ilk kez mi yüklüyorsunuz?** Figma → Plugins → Development → Import plugin from manifest → `f-mcp-plugin/manifest.json`
>
> **Kurumsal kullanım:** Plugin organizasyonda yayınlandıysa import gerekmez — Plugins menüsünden doğrudan çalıştırın.

---

## Kurulumdan sonra hangi Claude'u kullanmalıyım?

Kurulum tek seferlik. Sonrasında **Claude Desktop'ı** açın — tıpkı Claude Chat gibi yazışın, Figma bağlantısı otomatik çalışır.

| Araç | F-MCP çalışır mı? | Not |
|------|-------------------|-----|
| **Claude Desktop** (masaüstü uygulaması) | ✅ | Sohbet arayüzü — günlük kullanım için önerilen |
| **Claude Code** (Mac/PC'de terminal uygulaması) | ✅ | Kod yazma ve geliştirme için |
| **Cursor** | ✅ | Kod editörü — geliştiriciler için |
| **Claude Code** (claude.ai/code web veya mobil) | ❌ | Oturum Anthropic bulutunda çalışır; bilgisayarınızdaki plugin'e erişemez |
| **Claude Chat** (claude.ai web) | ❌ | Web tarayıcısı Figma plugin'ine erişemez |

> **Temel kural:** F-MCP, Claude ile Figma'nın **aynı bilgisayarda** çalışmasını gerektirir. Bridge yalnızca `localhost` (5454–5470) üzerinde dinler ve plugin yalnızca `localhost`'a bağlanır. Bulutta veya başka bir makinede çalışan bir Claude oturumu bu köprüye ulaşamaz; plugin bu durumda sarı **"auto-connect"** durumunda kalır.

### Claude Desktop sınırlamaları

Claude Desktop **Claude Code'dan farklı** çalışır. Şu mekanizmalar **Desktop'ta yoktur**:

- Sub-agent spawn — Task tool mevcut değil
- Slash command'lar (`/ds-sync` vb.) — desteklenmez
- `plugin.json` auto-discovery — yüklenmez
- `.claude/CLAUDE.md` auto-inject yok

Desktop'ta enforcement **beş katmandan** gelir:
1. Plugin response BLOCKING signal'i (`_DESIGN_SYSTEM_VIOLATIONS_BLOCKING`)
2. Runtime audit tool'u `figma_scan_ds_compliance`
3. Screenshot method selection — file/summary/regions/base64 (context koruma)
4. Discovery budget — keşif çağrıları sayılır, 12'den sonra BLOCKING
5. Project Knowledge'a yüklenmiş skill dosyaları

Detaylı rehber ve ilk-prompt örneği: **[install/claude-desktop/HOW-TO-ENFORCE.md](install/claude-desktop/HOW-TO-ENFORCE.md)**.

### Yeni chat öncesi öneri

Plugin bağlantı sorunları veya zombie process temizliği için:

```bash
bash scripts/cleanup-ports.sh
```

5454-5470 aralığındaki eski FMCP process'lerini güvenle öldürür (sadece FMCP adıyla eşleşenler).

---

## Kendi Tasarım Sisteminizi Ekleyin (Bring Your Own DS)

F-MCP **DS-agnostic** çalışır — herhangi bir Figma team library'yi (Material, Apple HIG, Tailwind UI, kurumsal kendi DS'iniz vb.) kullanabilirsiniz.

**🪄 Sıfır kurulum (v3.5+ — önerilen):** Hiçbir şey eklemenize gerek yok. Tasarım sisteminizle ilgili herhangi bir şey isteyin (*"tasarım sistemimle bir login ekranı yap"*, *"DS'ime uygun mu denetle"*) — agent Figma ortamınızdan DS'inizi **otomatik keşfeder**: hedef dosyanın subscribe olduğu library'ler + açık library dosyaları + mevcut instance'ların kaynakları taranır, bulgular `.claude/design-systems/registry.local.md`'ye (gitignore'lu, size özel) kaydedilir ve bir daha sorulmaz. Ancak hiçbir sinyal yoksa agent **bir kez** kütüphane linkinizi sorar ve kalıcılaştırır.

**Elle kontrol isteyenler için komutlar:**

| Komut | Ne zaman? |
|---|---|
| `/add-library` | Yeni bir DS kurarken (ana + mobil + ikon + asset Figma dosyalarını tek seferde ekler, cache oluşturur) |
| `/ds-add <Figma-URL>` | Hızlı ekleme — file-key otomatik parse edilir, varolan DS ile çakışma/fuzzy isim eşleşmesi kontrol edilir |
| `/ds-sync <ds-name>` | Mevcut DS cache'ini Figma'dan güncelle (resume destekli, kısmi sync) |

**Claude Desktop'ta:** Slash command'lar tetiklenmez ([Desktop sınırlamaları](#claude-desktop-sınırlamaları)). Bu komutların içeriğini prompt'a yapıştırın; Claude skill instruction'larını adım adım uygular. Veya doğal dil kullanın: *"Kütüphane ekle"*, *"Ana-DS'yi güncelle"*.

**Gizlilik:** Eklediğiniz DS'in gerçek `file-key`, `variableKey`, `componentKey` değerleri **repo'ya yazılmaz** — hepsi size özel, gitignore'lu yerel dosyalardadır: `.claude/design-systems/registry.local.md` (DS kaydı) ve `.claude/design-systems/<ds-name>/` altındaki yerel dokümanlar. v3.3+ live-first mimaride veriler her istekte Figma'dan canlı okunur; eski `~/.claude/data/fcm-ds/` cache dizini opsiyoneldir ve hiçbir zaman repoya girmez.

**Multi-library DS:** Ana-DS gibi birden fazla Figma dosyasından oluşan DS'ler desteklenir. `/add-library` ile ana + mobil + ikon + asset URL'lerini ayrı ayrı verebilirsiniz; `active-ds.md` Secondary Libraries tablosunda yönetilir.

**Doğrulama:** `/ds-validate <ds-name>` ile cache tutarlılığını denetleyin (v1.9.8+).

---

## Neler yapabilirsiniz?

AI ile Figma arasında **çift yönlü** çalışırsınız:

**Figma'dan AI'a** — tasarımı oku, analiz et:
- *"Bu dosyadaki tüm bileşenleri listele"*
- *"Button bileşeninin özelliklerini göster"*
- *"Bu ekranın screenshot'ını al"*
- *"Design token'larını çıkar"*

**AI'dan Figma'ya** — tasarım oluştur, değiştir:
- *"Yeni bir frame oluştur, 375x812, mobile layout"*
- *"Bu tasarımdan React kodu üret"*
- *"Color token'larını toplu güncelle"*
- *"Tüm ikonları SVG olarak export et"*

**Design-to-code köprüsü (v1.9.8):**
- *"Seçili bileşen için tasarım bağlamını topla — component + token + Code Connect"* → `figma_use intent=design_context`
- *"Bu sayfadaki tüm Code Connect eşlemelerini getir"* → `figma_get_code_connect scanCurrentPage=true`

**Kalite kontrolü:**
- *"Kontrast kontrolü yap (erişilebilirlik)"*
- *"Koddaki token'larla Figma'daki token'ları karşılaştır"*
- *"Responsive: Mobile, Tablet, Web versiyonlarını üret"*

**Prototip otomasyonu (v1.9.9+):**
- *"Figma'daki ekranların prototip bağlantılarını yap"*
- *"Login → Home → Register akışını SLIDE_IN animasyonla kur"*
- *"Button hover state'i SMART_ANIMATE ile ayarla"*
- *"Long content için vertical scroll + sticky header"*

Otomatik navigasyon haritası (TR+EN button text heuristic), 9 trigger / 8 action / 9 transition tipi × 4 yön, ON_KEY_DOWN (keyCodes + device), overlay config, scroll behavior, flow starting point — Figma Prototype panel'inin tüm yetenekleri.

63 aracın tam listesi: [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md)

---

## Figma API Token (opsiyonel — ek özellikler)

F-MCP temel özellikleri token olmadan çalışır. Figma API token eklerseniz **ek özellikler** açılır:

| Token olmadan | Token ile (ek) |
|---------------|---------------|
| Tasarım okuma, bileşen arama | + Yorum okuma/yazma |
| Frame/text oluşturma | + Versiyon geçmişi |
| Variable/token yönetimi | + REST API görsel export |
| SVG/PNG/PDF export | + Dosya bilgisi detayları |

**Nasıl eklenir:**
1. [figma.com/developers](https://www.figma.com/developers) → **Personal Access Tokens** → yeni token oluşturun
2. Figma'da plugin'i açın → **Advanced** → **API Token** alanına yapıştırın
3. Süre seçin (30/60/90 gün) → token otomatik kaydedilir

> Token bilgisayarınızda kalır, internete gönderilmez.

---

## Güncelleme

Claude Code'a şunu söyleyin:

> *"F-MCP'yi güncelle"*

Claude gerisini halleder. Sonra Claude'u yeniden başlatın.

Detay: [UPDATE.md](docs/UPDATE.md)

---

## Sorun mu yaşıyorsunuz?

| Sorun | Çözüm |
|-------|-------|
| Plugin "no server" diyor | Önce AI aracını (Claude Desktop / Cursor / Claude Code) açın, sonra Figma'da plugin'i çalıştırın |
| Plugin sarı "auto-connect :54xx" durumunda kalıyor, yeşil olmuyor | Bilgisayarınızda dinleyen bir bridge yok. Claude'u **claude.ai/code (web/mobil)** üzerinden açtıysanız oturum bulutta çalışır ve plugin'e ulaşamaz — Claude Desktop'ı veya terminalden Claude Code'u kullanın. Doğrulamak için: `lsof -iTCP:5454-5470 -sTCP:LISTEN` boş dönüyorsa bridge çalışmıyor demektir. Hızlı test: Terminal'de `cd <clone-kökü> && node dist/local-plugin-only.js` çalıştırın; plugin birkaç saniyede yeşile dönmeli (bu yalnızca teşhis içindir — günlük kullanımda bridge'i Claude Desktop / Claude Code kendisi başlatır; testten sonra Ctrl+C ile kapatın) |
| Bulut oturumunda / başka makinede `figma-mcp-bridge` "Connection closed" | `.mcp.json` içindeki `args` yolu (`/Users/<kullanıcı>/FCM/dist/local-plugin-only.js`) o makinede yok. Yerel kurulumda yolu kendi clone kökünüze göre düzenleyin; bulut oturumunda ise bu sunucu tasarım gereği çalışmaz (yukarıdaki "Temel kural") |
| Plugin "connecting..." diyor | Bekleyin, otomatik bağlanır |
| Yeni araçlar görünmüyor | AI aracını tamamen kapatıp tekrar açın |
| DevTools console'da WebSocket hataları | v1.9.1+ ile server-side probe ile giderildi. Plugin hâlâ eski kodu cache'liyorsa: Figma → Plugins → Development → Manage plugins in development → Remove → Import plugin from manifest |

Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)

---

## Teknik detaylar

- **Ne yapar** — Claude veya Cursor'dan Figma'ya ekran tasarlar, tasarım sistemini denetler, renk/yazı/boşluk token'larını yönetir, ekranlar arası **prototip bağlantıları ve animasyonlar** kurar (v1.9.9+), tasarımı koda hazırlar
- **Nerelerde çalışır** — Claude Code, Cursor, Claude Desktop, Claude Web ([kurulum rehberleri](install/))
- **Nasıl çalışır** — Her görev için kendi **skill**'i var (kural seti + örnek). Claude Code'da **agent + sub-agent** yapısı var: ana ajan görevi alır, alt-ajanlar izole çalışır — ana sohbet bağlamı yorulmaz. Cursor ve Claude Desktop'ta aynı skill'ler doğrudan yüklenir (sub-agent yok, tek kaynak 4 platformda)
- **3 orkestratör** — DS denetimi, token senkronizasyonu, ekran üretimi için hazır uçtan uca akışlar ([skill dizini](skills/SKILL_INDEX.md))
- **Figma** — Masaüstü ve tarayıcı, birden fazla AI aynı dosyaya aynı anda bağlanabilir
- **Gizlilik** — Veriler bilgisayarınızdan çıkmaz, internet bağlantısı olmadan da kullanılabilir
- **Detay** — [63 araç](docs/TOOLS_FULL_LIST.md) · [29 skill](skills/SKILL_INDEX.md) · [Mimari](docs/ARCHITECTURE.md) · [Kurumsal kullanım](docs/ENTERPRISE.md) · [Katkı rehberi](CONTRIBUTING.md)

---

| | |
|---|---|
| Güncel sürüm | **1.9.15** ([CHANGELOG](CHANGELOG.md) · [Releases](https://github.com/atezer/FMCP/releases/tag/v1.9.15)) — DS Change Tracker (DS değişiklik takibi + iş taslağı) |
| npm | [@atezer/figma-mcp-bridge](https://www.npmjs.com/package/@atezer/figma-mcp-bridge) |
| Lisans | MIT — kişisel ve ticari kullanıma açık. [Figma Console MCP](https://github.com/southleft/figma-console-mcp) (MIT) projesinden türetildi |

**Sorun mu var?** [GitHub Issues](https://github.com/atezer/FMCP/issues)

© atezer · MIT · atezer/FMCP

Похожие плагины

Все плагины по теме «Дизайн» →
bridge-ds noemuch Плагин bridge-ds для Claude Code, который генерирует макеты в Figma на основе реальной дизайн-системы. Извлекает компоненты, токены и стили, пишет валидированные спецификации и собирает готовые сцены. ★ 156звёзд репо design-token-bridge-mcp kenneives MCP-сервер design-token-bridge-mcp преобразует дизайн-токены между Tailwind, CSS, Figma и W3C DTCG, а затем генерирует темы для Material 3 и SwiftUI. Подходит для переноса общей палитры и типографики между вебом и мобильными приложениями. CX Codex +1 ★ 5звёзд репо figma-generate-library официальный openai Скилл figma-generate-library синхронизирует дизайн-систему Figma с кодовой базой: создаёт или обновляет переменные, компоненты, режимы и документацию в заданном порядке. CX Codex +1 3 000установок figma-code-connect-components nexu-io Скилл figma-code-connect-components для Claude Code и других агентов: связывает компоненты Figma с компонентами кода через Code Connect. Обновления дизайн-системы доходят до кодовой базы. CX Codex +1 2 900установок figma-build awdr74100 Скилл figma-build для Claude Code собирает макет в подключённом Figma-файле из кода или описания, переиспользуя компоненты, переменные и стили. Переносит в Figma экраны и UI-компоненты. CX Codex +1 1 600установок om-figma-design-with-ds open-mercato Скилл om-figma-design-with-ds для Claude Code связывает макет нового экрана или аудит Figma с дизайн-системой репозитория. Описывает экран через существующие токены и компоненты. CX Codex +1 984установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой