@atezer/figma-mcp-bridge 1.7.0 → 1.7.2

package/CHANGELOG.md

@@ -12,6 +12,50 @@ Bu dosya [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) bicimine uygun
 
 Bu changelog'a ekleme oncesi surumlerin tam ayrintilari icin `git log` kullanilabilir.
 
+## [1.7.2] - 2026-04-04
+
+### Kapsamli Entegrasyon Testi + 11 Skill Guncelleme + Code-Only Props
+
+**Test:**
+- Uctan uca entegrasyon testi: 46 arac, 17 skill, 11 faz
+- 120 token (Primitives + Primitives Dark + Semantic), 6 ekran (3 boyut x 2 tema), 1 component set (5 variant)
+- 10 dosya uretildi: 3 kod (React/Swift/Kotlin), 5 token (CSS/Tailwind/Swift/Kotlin/JSON), 1 handoff
+- WCAG AA erisebilirlik: tum renk ciftleri PASS, tum touch target >= 44px
+
+**Skill duzeltmeleri (9):**
+- `audit/apply-figma-design-system`: figma_take_screenshot → figma_capture_screenshot
+- `ai-handoff-export`: figma_get_component_details → figma_get_component_for_development
+- `implement-design`: componentId → nodeId
+- `figma-screen-analyzer`: DS compliance formulu duzeltildi
+- `ds-impact-analysis`: sayfa limiti 5→20, transitif bagimlilik eklendi
+- `fix-figma-design-system-finding`: 3 remediasyon modu kod ornegi
+- `generate-figma-library`: batch hata yonetimi pattern
+
+**Skill zenginlestirmeleri (20):**
+- Token description + code syntax (Web/Android/iOS) zorunlu adimi
+- Semantic Token = Alias zorunlu kurali
+- Breakpoint / ekran boyut token'lari
+- Dark mode token stratejisi (Pro+ native vs Free workaround)
+- Code-Only Props katmani (Nathan Curtis yaklasimi)
+- Responsive boyut presetleri (3 boyut + dark = 6 ekran zorunlu)
+- MinHeight token binding zorunlu adimi
+- A11y annotation frame (baslik hiyerarsisi, form iliskilendirme, odak sirasi, alt text, dinamik icerik)
+- Erisebilirlik-tasarim tutarlilik kontrolu (7 kural)
+- Code-Only Props spec data cikarma (handoff)
+
+**FUTURE.md eklemeleri:**
+- P0: Figma Make entegrasyonu + canli prototip sureci
+- P0: Figma prototip baglantilari + animasyonlar
+- P1: Figma Dev Mode entegrasyonu
+
+## [1.7.0] - 2026-04-04 (guncelleme)
+
+### Claude Code Destegi ve Test Raporu (YENi)
+
+- **README: Claude Code kurulum bolumu eklendi.** `.mcp.json` dosyasi ile NPX tabanli config. `~/.claude/settings.json`'in MCP icin calismadigina dair uyari notu.
+- **`.mcp.json` guncellendi:** Cursor'a ozel bash script yerine evrensel NPX config (hem Claude Code hem Cursor ile uyumlu).
+- **`docs/TEST_REPORT.md` (YENi):** 46 aracin tamami test edildi (40 PASS, 4 beklenen Figma kisiti, 2 guvenlik nedeniyle SKIP). Free/Pro/Org/Enterprise plan bazli yetenek matrisi. Adim adim test rehberi.
+
 ## [1.7.0] - 2026-04-03
 
 ### Coklu Port + Otomatik AI Araci Tespiti (YENi)

package/README.md

@@ -22,22 +22,32 @@ Her şey **bilgisayarınızda** kalır. Tasarım verileriniz internete gönderil
 - **Figma API token tüketmez\*** — Varsayılan olarak plugin üzerinden çalışır, Figma API kotanızı kullanmaz
 - **Veri güvenliği** — Tasarım verisi sadece kendi bilgisayarınızda kalır (Zero Trust)
 - **Çoklu dosya** — Aynı anda birden fazla Figma/FigJam dosyası ile çalışabilirsiniz
-- **Çoklu AI aracı** — Claude ve Cursor aynı anda kullanılabilir (farklı portlarda)
+- **Çoklu AI aracı** — Claude, Cursor ve Claude Code aynı anda (otomatik port tarama, elle değiştirmeye gerek yok)
 - **SVG/PNG export** — Vektörel veya bitmap, toplu export (1-50 node)
 - **REST API desteği** — İsteğe bağlı token ile yorum okuma, versiyon geçmişi, görsel export
 - **Figma Desktop + Tarayıcı** — Her ikisinde de çalışır
 
 > \* **REST API isteğe bağlıdır.** Temel araçlar (okuma, yazma, export, variable) token olmadan plugin üzerinden çalışır. Yorum okuma, versiyon geçmişi gibi ek özellikler için Figma API token'ı ekleyebilirsiniz — plugin'deki Advanced panelinden girin, kalan API limitinizi plugin üzerinde takip edin.
 
-## Hızlı başlangıç (3 adım)
+## Hızlı başlangıç
 
-### 1. Node.js kurun
+> 💡 **En kolay yol:** AI aracınıza (Claude, Cursor) şunu söyleyin:
+> *"https://github.com/atezer/FMCP — gerekli kurulumları yap ve Figma'ya bağlan"*
+> AI bu sayfayı okur, kurulumu yapar, sizi bağlar. Aşağıdaki adımlar elle yapmak isteyenler için.
 
-[nodejs.org](https://nodejs.org) adresinden LTS sürümünü indirip kurun.
+### 1. Node.js kurun (bir kerelik)
+
+F-MCP Bridge'in çalışması için bilgisayarınızda Node.js olması gerekiyor. Zaten kuruluysa bu adımı atlayın.
+
+**Kurulu mu kontrol edin:** Terminal açıp `node -v` yazın. Versiyon görüyorsanız kurulu demektir.
+
+**Kurulu değilse:** [nodejs.org](https://nodejs.org) → **LTS** butonuna tıklayın → indirin → kurun. Sadece "İleri"ye tıklayarak kurulum tamamlanır.
 
 ### 2. AI aracınıza config ekleyin
 
-**Cursor** — Proje kökünde `.cursor/mcp.json` dosyası oluşturun:
+Aşağıdaki JSON bloğunu AI aracınızın config dosyasına ekleyin. Bu, AI aracına "Figma ile nasıl konuşacağını" öğretir.
+
+**Cursor** — Proje klasörünüzde `.cursor/mcp.json` dosyası oluşturun (yoksa yeni dosya açın):
 
 ```json
 {
@@ -50,7 +60,7 @@ Her şey **bilgisayarınızda** kalır. Tasarım verileriniz internete gönderil
 }
 ```
 
-**Claude Desktop** — Config dosyasını açın (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):
+**Claude Desktop** — Settings → Developer → Edit Config tıklayın (veya macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` açın):
 
 ```json
 {
@@ -63,14 +73,32 @@ Her şey **bilgisayarınızda** kalır. Tasarım verileriniz internete gönderil
 }
 ```
 
+**Claude Code** — Proje klasörünüzde `.mcp.json` dosyası oluşturun (yoksa yeni dosya açın):
+
+```json
+{
+  "mcpServers": {
+    "figma-mcp-bridge": {
+      "command": "npx",
+      "args": ["-y", "@atezer/figma-mcp-bridge@latest", "figma-mcp-bridge-plugin"]
+    }
+  }
+}
+```
+
+> **Claude Code kullanıcıları için önemli:** Config dosyası `.mcp.json` olmalıdır (proje kökünde). `~/.claude/settings.json` dosyası MCP sunucuları için **çalışmaz** — o dosya sadece izinler (permissions) içindir.
+
 ### 3. Figma'da plugin'i açın
 
-1. Cursor veya Claude Desktop'ı yeniden başlatın
-2. Figma'yı açın → **Plugins** → **F-MCP ATezer Bridge**
-3. Plugin'de **"ready (:5454)"** yazısını görene kadar bekleyin
-4. Artık AI aracınız Figma'ya bağlı!
+1. **Cursor veya Claude Desktop'ı yeniden başlatın** (config'i okuması için)
+2. **Figma'yı açın** → herhangi bir dosyayı açın
+3. **Plugins** menüsünden **F-MCP ATezer Bridge** seçin
+4. Plugin'de yeşil **"Ready"** yazısını görene kadar bekleyin
+5. AI aracınızdan Figma'ya komut verebilirsiniz!
 
 > **Plugin'i ilk kez mi yüklüyorsunuz?** Figma → Plugins → Development → Import plugin from manifest → Bu repodaki `f-mcp-plugin/manifest.json` dosyasını seçin.
+>
+> **Kurumsal kullanım:** Plugin'i organizasyonunuzda private plugin olarak yayınlarsanız herkes Plugins menüsünden tek tıkla erişir — tek tek yüklemeye gerek kalmaz.
 
 ## 46 araçla neler yapabilirsiniz?
 
@@ -117,19 +145,23 @@ Her şey **bilgisayarınızda** kalır. Tasarım verileriniz internete gönderil
 
 Tam araç listesi: [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md) | Detaylı referans: [TOOLS.md](docs/TOOLS.md)
 
-## Claude + Cursor aynı anda kullanma
-
-Her iki araç da varsayılan 5454 portunu kullanır. İlk açılan portu alır, ikincisi için:
+## Claude + Cursor aynı anda kullanma (v1.7.0+)
 
-1. AI aracına "port 5456 kullan" deyin → `figma_set_port(5456)` çalışır
-2. Figma plugin'de portu **5456** yapın
-3. Her iki araç aynı anda bağımsız çalışır
+Plugin tüm portları (5454-5470) **otomatik tarar** ve bulunan bridge'lere sessizce bağlanır. Elle port değiştirmenize gerek yok.
 
-Ya da config'te önceden farklı port belirleyin:
+**Nasıl çalışır:**
+1. Claude Desktop, Cursor veya Claude Code'u açın — her biri kendi portunda bridge başlatır
+2. Figma'da plugin'i açın — otomatik olarak tüm bridge'leri bulur ve bağlanır
+3. Plugin'de **(i)** ikonuna tıklayın — bağlı araçları görün
+4. **◀ ▶** ok tuşlarıyla araçlar arasında geçiş yapın
 
-```json
-"env": { "FIGMA_PLUGIN_BRIDGE_PORT": "5455" }
 ```
+● 5454 (Claude) ← aktif
+○ 5455 (Cursor)
+○ 5457 (Claude Code)
+```
+
+AI aracı adı otomatik tespit edilir — config'e bir şey eklemenize gerek yok.
 
 ## Çoklu dosya desteği
 
@@ -165,7 +197,7 @@ Detaylı sorun giderme: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
 
 | Bilgi | Kaynak |
 |-------|--------|
-| Güncel sürüm | **1.7.0** ([package.json](package.json)) |
+| Güncel sürüm | **1.7.2** ([package.json](package.json)) |
 | Değişiklik geçmişi | [CHANGELOG.md](CHANGELOG.md) |
 | GitHub sürümleri | [Releases](https://github.com/atezer/FMCP/releases) |
 | npm paketi | [@atezer/figma-mcp-bridge](https://www.npmjs.com/package/@atezer/figma-mcp-bridge) |
@@ -189,6 +221,7 @@ Detaylı sorun giderme: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
 | [ARCHITECTURE.md](docs/ARCHITECTURE.md) | Teknik mimari |
 | [USE_CASES.md](docs/USE_CASES.md) | Örnek kullanım senaryoları |
 | [SECURITY_AUDIT.md](docs/SECURITY_AUDIT.md) | Güvenlik denetimi |
+| [TEST_REPORT.md](docs/TEST_REPORT.md) | Kapsamli entegrasyon testi: 46 arac, 17 skill, 120 token, 6 ekran |
 
 ## Güvenlik ve gizlilik
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atezer/figma-mcp-bridge",
-	"version": "1.7.0",
+	"version": "1.7.2",
 	"description": "F-MCP ATezer: MCP server and Figma plugin bridge for Claude/Cursor. No REST token required.",
 	"type": "module",
 	"main": "dist/local.js",