F-MCP (Figma MCP Bridge)

Son sürüm — v1.9.11 (19 Nisan 2026): Figma Prototype Connections + Animations. 5 yeni araç (figma_create_prototype_connection, figma_get_prototype_connections, figma_set_flow_starting_point, figma_create_interaction, figma_set_scroll_behavior) + figma-prototype-flow skill. AI artık ekranlarınız arasında otomatik navigasyon, animasyon ve flow starting point oluşturabiliyor. Detay: CHANGELOG · Release notes · Skill

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?

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 (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.

Claude Desktop sınırlamaları

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

• Hook'lar (PreToolUse, SessionStart) — çalışmaz
• 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.

Yeni chat öncesi öneri

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

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).

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.

54 aracın tam listesi: 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:

Nasıl eklenir:

1. 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

Sorun mu yaşıyorsunuz?

Daha fazla: 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)
• 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)
• 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 — 54 araç · 26 skill · Mimari · Kurumsal kullanım · Katkı rehberi

Sorun mu var? GitHub Issues