@atezer/figma-mcp-bridge 1.7.13 → 1.7.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -12,6 +12,49 @@ Bu dosya [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) biçimine uygu
12
12
 
13
13
  Bu changelog'a ekleme öncesi sürümlerin tam ayrıntıları için `git log` kullanılabilir.
14
14
 
15
+ ## [1.7.15] - 2026-04-08
16
+
17
+ ### Skill: Anthropic Design Skill Entegrasyonu + Marka Profili + UX Copy
18
+
19
+ Anthropic built-in design skill'leri (accessibility-review, design-handoff, design-critique, design-system-management, ux-writing, frontend-design) ile F-MCP skill'leri satır satır karşılaştırıldı. Eksik tasarım prensipleri, yapısal çerçeveler, estetik yönlendirme ve kişiselleştirme mekanizmaları entegre edildi.
20
+
21
+ **Yeni dosyalar:**
22
+ - **ux-copy-guidance/SKILL.md (YENİ):** UX yazarlık rehberi — 5 temel prensip, 6 copy kalıbı (CTA, hata, boş durum, onay, başarı, yükleme), ses/ton rehberi, marka profili kişiselleştirmesi, çok dilli/i18n kuralları, Figma text node entegrasyonu (19. skill)
23
+ - **BRAND_PROFILE_SCHEMA.md (YENİ):** `.fmcp-brand-profile.json` şema tanımı — tüm skill'lerin kişiselleştirilebilmesi için merkezi yapılandırma (ses/ton, tipografi, estetik yön, copy kuralları, i18n)
24
+
25
+ **Genişletilen skill'ler (10):**
26
+ - **figma-a11y-audit:** WCAG 2.1 AA hızlı referans (12 kriter), yaygın sorunlar listesi (8), test yaklaşımı sırası (5 aşama), Step 5'e WCAG referansı, Step 8'e 3 yeni kontrol (fokus göstergesi, hata ilişkilendirme, UI bileşen kontrastı)
27
+ - **ai-handoff-export:** Handoff prensipleri (4), etkileşim spesifikasyonları, içerik spesifikasyonları, uç durumlar tablosu, erişilebilirlik spesifikasyonları, marka profili entegrasyonu
28
+ - **audit-figma-design-system:** DS eksiksizlik çerçevesi (token kategorileri, bileşen durum kapsamı, pattern katmanı), DS prensipleri, JSON şemasına `dsCompleteness`
29
+ - **figma-screen-analyzer:** İlk İzlenim Analizi (2sn testi), görsel hiyerarşi 4 yeni soru, geri bildirim prensipleri (5), marka profili entegrasyonu
30
+ - **generate-figma-screen:** Tasarım Yönü Belirleme (Step 2.5), tipografi stratejisi, görsel derinlik (Step 5.5), anti-pattern kontrolü, marka profili entegrasyonu
31
+ - **component-documentation:** Durumlar bölümü ve Copy Spec bölümü eklendi (Standard format 8→10 bölüm), marka profili entegrasyonu
32
+ - **implement-design:** Step 7d durum/etkileşim kapsamı kontrolü (6 kontrol), marka profili entegrasyonu
33
+ - **generate-figma-library:** Faz 1'e motion token (1f) ve shadow token (1g), Faz 3'e durum kapsamı kontrolü (3d), marka profili entegrasyonu
34
+ - **design-system-rules:** DS prensipleri (Step 3.5), pattern katmanı kuralları (Step 3.6)
35
+ - **design-drift-detector:** Motion token drift kontrolü (Step 5.5)
36
+
37
+ **Güncellenen referans dosyalar:**
38
+ - **SKILL_INDEX.md:** Kişiselleştirme bölümü, skill sayısı 18→19, persona akışları güncellenmiş, uçtan uca akış güncellenmiş
39
+ - **FUTURE.md:** P3 tüm maddeler [TAMAMLANDI], sürüm referansları güncellenmiş
40
+
41
+ ## [1.7.14] - 2026-04-07
42
+
43
+ ### Kurulum Deneyimi İyileştirmesi
44
+
45
+ Kaynak: `fmcp-feedback.md` — terminal bilgisi olmayan kullanıcının kurulum zorluğu feedback'i.
46
+
47
+ - **`scripts/setup.sh`** eklendi: Node.js kontrolü, build, MCP config otomatik ayarı — tek komutla kurulum
48
+ - **`scripts/setup-npx.sh`** eklendi: NPX ile kurulum — repo indirmeden, config otomatik
49
+ - **`scripts/update.sh`** eklendi: Tek komutla otomatik güncelleme
50
+ - **Plugin UI:** "auto port" → "otomatik bağlantı aktif" mesajı; port input title'ları daha açıklayıcı
51
+ - **README.md** sadeleştirildi: Teknik bilgisi olmayan kullanıcı için net kurulum akışı
52
+ - **ONBOARDING.md** güncellendi: Tek komutluk kurulum referansı
53
+ - **KURULUM.md** güncellendi: Script referansı, sürüm güncelleme
54
+ - **UPDATE.md** güncellendi: Otomatik güncelleme bölümü eklendi
55
+ - **FUTURE.md** güncellendi: Kurulum deneyimi hedefleri (pre-built binary, GUI installer)
56
+ - **TEST_REPORT.md** sürüm güncellendi
57
+
15
58
  ## [1.7.13] - 2026-04-07
16
59
 
17
60
  ### Plugin UI: Dark/Light Tema Uyumu ve Font Okunabilirliği
package/README.md CHANGED
@@ -4,233 +4,142 @@
4
4
 
5
5
  # F-MCP (Figma MCP Bridge)
6
6
 
7
- Figma'daki tasarımlarınızı AI araçlarına (Claude, Cursor) bağlayan bir köprü. Figma'da bir plugin açarsınız, AI aracınız bu plugin üzerinden tasarımlarınızı okur, değiştirir ve export eder.
7
+ 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.
8
8
 
9
- **Ne işe yarar?** AI'a "Bu dosyadaki Button bileşenini göster", "Yeni bir frame oluştur", "SVG olarak export et" gibi komutlar verirsiniz — AI Figma'daki tasarımınızla doğrudan çalışır.
10
-
11
- ## Nasıl çalışır?
9
+ Her şey **bilgisayarınızda** kalır. Tasarım verileriniz internete gönderilmez.
12
10
 
13
- ```
14
- Siz (Claude/Cursor) → F-MCP Bridge → Figma Plugin → Figma dosyanız
15
- ```
11
+ ---
16
12
 
17
- Her şey **bilgisayarınızda** kalır. Tasarım verileriniz internete gönderilmez.
13
+ ## Neye ihtiyacım var?
18
14
 
19
- ## Öne çıkan özellikler
20
-
21
- - **46 araç** tasarım okuma, bileşen oluşturma, variable yönetimi, export ve daha fazlası ([tam liste](docs/TOOLS_FULL_LIST.md))
22
- - **17 skill** token pipeline, ekran üretimi, erişilebilirlik denetimi, geliştirici handoff, kod üretimi ([test raporu](docs/TEST_REPORT.md))
23
- - **Token gerekmez** — Temel araçlar Figma API token'ı olmadan plugin üzerinden çalışır. REST API (yorum, versiyon geçmişi) için isteğe bağlı token eklenebilir.
24
- - **Verileriniz sizde kalır** — Tasarım verisi bilgisayarınızdan çıkmaz. Figma bulutuna veya üçüncü taraflara veri gönderilmez.
25
- - **Çoklu dosya + çoklu AI aracı** — Claude, Cursor ve Claude Code aynı anda, birden fazla Figma/FigJam dosyasıyla çalışır (otomatik port tarama)
26
- - **Responsive + Dark Mode** — Ekranları 3 boyutta (Mobile/Tablet/Web) ve 2 temada (Light/Dark) üretir
27
- - **Erişilebilirlik** — WCAG AA kontrast kontrolü, touch target doğrulama, başlık hiyerarşisi, odak sırası notları
28
- - **Kod üretimi** — Figma tasarımından React, SwiftUI ve Jetpack Compose kodu üretir
29
- - **SVG/PNG/PDF export** — Vektörel veya bitmap, toplu export (1-50 node)
30
- - **Figma Desktop + Tarayıcı** — Her ikisinde de çalışır
15
+ | Gerekli | Açıklama |
16
+ |---------|----------|
17
+ | **Figma** | Zaten kullanıyorsanız hazırsınız |
18
+ | **Claude Code** | Kurulumu yapacak uygulama [claude.ai/download](https://claude.ai/download) adresinden indirin |
31
19
 
32
- ## Hızlı başlangıç
20
+ > **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.
33
21
 
34
- > 💡 **En kolay yol:** AI aracınıza (Claude, Cursor) şunu söyleyin:
35
- > *"@atezer/figma-mcp-bridge paketini kur ve Figma'ya bağlan"*
36
- > AI config'i ayarlar, bağlantıyı kurar. Aşağıdaki adımlar elle yapmak isteyenler için.
22
+ ---
37
23
 
38
- ### 1. Node.js kurun (bir kerelik)
24
+ ## Kurulum (5 dakika)
39
25
 
40
- F-MCP Bridge'in çalışması için bilgisayarınızda Node.js olması gerekiyor. Zaten kuruluysa bu adımı atlayın.
26
+ **1.** [Claude Code'u indirin](https://claude.ai/download) (henüz yoksa)
41
27
 
42
- **Kurulu mu kontrol edin:** Terminal açıp `node -v` yazın. Versiyon görüyorsanız kurulu demektir.
28
+ **2.** Claude Code'u açın ve şunu yazın:
43
29
 
44
- **Kurulu değilse:** [nodejs.org](https://nodejs.org) **LTS** butonuna tıklayın → indirin → kurun. Sadece "İleri"ye tıklayarak kurulum tamamlanır.
30
+ > *"https://github.com/atezer/FMCP bu repoyu kur"*
45
31
 
46
- ### 2. AI aracınıza config ekleyin
32
+ Claude gerekli her şeyi (Node.js, build, ayarlar) otomatik yapar. Sizden sadece gerekirse **bilgisayar şifreniz** istenir.
47
33
 
48
- Aşağıdaki JSON'u AI aracınızın config dosyasına ekleyin:
34
+ **3.** Claude "kurulum tamamlandı" deyince **Claude Code'u kapatıp tekrar açın**
49
35
 
50
- ```json
51
- {
52
- "mcpServers": {
53
- "figma-mcp-bridge": {
54
- "command": "npx",
55
- "args": ["-y", "@atezer/figma-mcp-bridge@latest", "figma-mcp-bridge-plugin"]
56
- }
57
- }
58
- }
59
- ```
36
+ **4.** Figma'da **Plugins → F-MCP ATezer Bridge** açın → yeşil **"Ready"** görün
60
37
 
61
- Config dosyasının konumu AI aracınıza göre değişir:
38
+ **5.** Hazırsınız! Claude'a Figma ile ilgili sorularınızı sorun.
62
39
 
63
- | AI Aracı | Config Dosyası |
64
- |----------|---------------|
65
- | **Cursor** | `.cursor/mcp.json` (proje klasörü) |
66
- | **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) |
67
- | **Claude Code** | `.mcp.json` (proje klasörü) |
40
+ > **Plugin'i ilk kez mi yüklüyorsunuz?** Figma → Plugins → Development → Import plugin from manifest → `f-mcp-plugin/manifest.json`
41
+ >
42
+ > **Kurumsal kullanım:** Plugin organizasyonda yayınlandıysa import gerekmez — Plugins menüsünden doğrudan çalıştırın.
68
43
 
69
- ### 3. Figma'da plugin'i açın
44
+ ---
70
45
 
71
- 1. **Cursor veya Claude Desktop'ı yeniden başlatın** (config'i okuması için)
72
- 2. **Figma'yı açın** → herhangi bir dosyayı açın
73
- 3. **Plugins** menüsünden **F-MCP ATezer Bridge** seçin
74
- 4. Plugin'de yeşil **"Ready"** yazısını görene kadar bekleyin
75
- 5. AI aracınızdan Figma'ya komut verebilirsiniz!
46
+ ## Kurulumdan sonra hangi Claude'u kullanmalıyım?
76
47
 
77
- > **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.
78
- >
79
- > **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.
48
+ Kurulum tek seferlik. Sonrasında **Claude Desktop'ı** açın tıpkı Claude Chat gibi yazışın, Figma bağlantısı otomatik çalışır.
80
49
 
81
- ## 46 araçla neler yapabilirsiniz?
50
+ | Araç | F-MCP çalışır mı? | Not |
51
+ |------|-------------------|-----|
52
+ | **Claude Desktop** (masaüstü uygulaması) | ✅ | Sohbet arayüzü — günlük kullanım için önerilen |
53
+ | **Claude Code** (terminal uygulaması) | ✅ | Kod yazma ve geliştirme için |
54
+ | **Cursor** | ✅ | Kod editörü — geliştirciler için |
55
+ | **Claude Chat** (claude.ai web) | ❌ | Web tarayıcısı Figma plugin'ine erişemez |
82
56
 
83
- ### Tasarımcılar için
57
+ ---
84
58
 
85
- | Ne yapabilirsiniz | Araçlar |
86
- |-------------------|---------|
87
- | Dosya yapısını görme | `figma_get_file_data`, `figma_get_design_context` |
88
- | Bileşen bulma ve inceleme | `figma_search_components`, `figma_get_component` |
89
- | Screenshot alma | `figma_capture_screenshot` |
90
- | SVG/PNG export | `figma_export_nodes` (toplu, vektörel) |
91
- | Yeni tasarım elemanı oluşturma | `figma_create_frame`, `figma_create_text`, `figma_create_rectangle`, `figma_create_group` |
92
- | Variable ve token yönetimi | `figma_get_variables`, `figma_create_variable`, `figma_update_variable` |
93
- | Design system özeti | `figma_get_design_system_summary`, `figma_get_token_browser` |
94
- | Takım kütüphanesi arama | `figma_search_assets` |
59
+ ## Neler yapabilirsiniz?
95
60
 
96
- ### Geliştiriciler için
61
+ AI ile Figma arasında **çift yönlü** çalışırsınız:
97
62
 
98
- | Ne yapabilirsiniz | Araçlar |
99
- |-------------------|---------|
100
- | Bileşen detayı + görsel | `figma_get_component_for_development`, `figma_get_component_image` |
101
- | Token ve stil çıkarma | `figma_get_variables`, `figma_get_styles` |
102
- | Instance oluşturma | `figma_instantiate_component`, `figma_set_instance_properties` |
103
- | Kod çalıştırma | `figma_execute` (Figma Plugin API ile doğrudan JS) |
104
- | Konsol izleme | `figma_get_console_logs`, `figma_watch_console` |
63
+ **Figma'dan AI'a** tasarımı oku, analiz et:
64
+ - *"Bu dosyadaki tüm bileşenleri listele"*
65
+ - *"Button bileşeninin özelliklerini göster"*
66
+ - *"Bu ekranın screenshot'ını al"*
67
+ - *"Design token'larını çıkar"*
105
68
 
106
- ### DesignOps için
69
+ **AI'dan Figma'ya** — tasarım oluştur, değiştir:
70
+ - *"Yeni bir frame oluştur, 375x812, mobile layout"*
71
+ - *"Bu tasarımdan React kodu üret"*
72
+ - *"Color token'larını toplu güncelle"*
73
+ - *"Tüm ikonları SVG olarak export et"*
107
74
 
108
- | Ne yapabilirsiniz | Araçlar |
109
- |-------------------|---------|
110
- | Design-code uyumu kontrolü | `figma_check_design_parity` |
111
- | Toplu token oluşturma | `figma_setup_design_tokens`, `figma_batch_create_variables` |
112
- | Variable CRUD (oluştur/güncelle/sil) | Tam variable yönetim seti (12 araç) |
113
- | Bileşen variant yönetimi | `figma_arrange_component_set`, `figma_set_description` |
75
+ **Kalite kontrolü:**
76
+ - *"Kontrast kontrolü yap (erişilebilirlik)"*
77
+ - *"Koddaki token'larla Figma'daki token'ları karşılaştır"*
78
+ - *"Responsive: Mobile, Tablet, Web versiyonlarını üret"*
114
79
 
115
- ### REST API (isteğe bağlı, token gerektirir)
80
+ 46 aracın tam listesi: [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md)
116
81
 
117
- | Ne yapabilirsiniz | Araçlar |
118
- |-------------------|---------|
119
- | Token girişi | `figma_set_rest_token` (plugin UI'dan veya AI aracından) |
120
- | API çağrısı | `figma_rest_api` (yorumlar, versiyonlar, görsel export) |
121
- | Limit takibi | `figma_get_rest_token_status` |
122
- | Bağlantı durumu | `figma_plugin_diagnostics` |
82
+ ---
123
83
 
124
- Tam araç listesi: [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md) | Detaylı referans: [TOOLS.md](docs/TOOLS.md)
84
+ ## Figma API Token (opsiyonel ek özellikler)
125
85
 
126
- ## Claude + Cursor aynı anda kullanma (v1.7.0+)
86
+ F-MCP temel özellikleri token olmadan çalışır. Figma API token eklerseniz **ek özellikler** açılır:
127
87
 
128
- Plugin tüm portları (5454-5470) **otomatik tarar** ve bulunan bridge'lere sessizce bağlanır. Elle port değiştirmenize gerek yok.
88
+ | Token olmadan | Token ile (ek) |
89
+ |---------------|---------------|
90
+ | Tasarım okuma, bileşen arama | + Yorum okuma/yazma |
91
+ | Frame/text oluşturma | + Versiyon geçmişi |
92
+ | Variable/token yönetimi | + REST API görsel export |
93
+ | SVG/PNG/PDF export | + Dosya bilgisi detayları |
129
94
 
130
- **Nasıl çalışır:**
131
- 1. Claude Desktop, Cursor veya Claude Code'u açın her biri kendi portunda bridge başlatır
132
- 2. Figma'da plugin'i açın otomatik olarak tüm bridge'leri bulur ve bağlanır
133
- 3. Plugin'de **(i)** ikonuna tıklayın bağlı araçları görün
134
- 4. **◀ ▶** ok tuşlarıyla araçlar arasında geçiş yapın
95
+ **Nasıl eklenir:**
96
+ 1. [figma.com/developers](https://www.figma.com/developers) **Personal Access Tokens** yeni token oluşturun
97
+ 2. Figma'da plugin'i açın **Advanced** **API Token** alanına yapıştırın
98
+ 3. Süre seçin (30/60/90 gün) token otomatik kaydedilir
135
99
 
136
- ```
137
- ● 5454 (Claude) ← aktif
138
- ○ 5455 (Cursor)
139
- ○ 5457 (Claude Code)
140
- ```
100
+ > Token bilgisayarınızda kalır, internete gönderilmez.
141
101
 
142
- AI aracı adı otomatik tespit edilir — config'e bir şey eklemenize gerek yok.
102
+ ---
143
103
 
144
- ## Çoklu dosya desteği
104
+ ## Güncelleme
145
105
 
146
- Aynı anda birden fazla Figma/FigJam dosyasında plugin'i açabilirsiniz:
106
+ Claude Code'a şunu söyleyin:
147
107
 
148
- - **Figma Desktop** — tasarım dosyası
149
- - **Figma Browser** — tarayıcıda figma.com
150
- - **FigJam** — whiteboard/diyagram
108
+ > *"F-MCP'yi güncelle"*
151
109
 
152
- Hangi linki verirseniz, AI o dosyaya yönlendirilir. `figma_list_connected_files` ile bağlı dosyaları görebilirsiniz.
110
+ Claude gerisini halleder. Sonra Claude'u yeniden başlatın.
153
111
 
154
- ## Plugin durum göstergeleri
112
+ Detay: [UPDATE.md](docs/UPDATE.md)
155
113
 
156
- | Plugin'de ne görüyorsunuz | Anlamı |
157
- |---------------------------|--------|
158
- | `ready (:5454)` | Bağlantı kuruldu, kullanmaya hazır |
159
- | `connecting...` | Bağlanmaya çalışıyor |
160
- | `no server` | AI aracı çalışmıyor veya port uyuşmuyor |
161
- | `wrong server` | Farklı bir sunucuya bağlandı |
114
+ ---
162
115
 
163
116
  ## Sorun mu yaşıyorsunuz?
164
117
 
165
118
  | Sorun | Çözüm |
166
119
  |-------|-------|
167
- | Plugin "no server" diyor | AI aracınızı (Claude/Cursor) yeniden başlatın |
168
- | Port çakışması | `figma_set_port` ile farklı porta geçin veya `lsof -i :5454` ile portu kontrol edin |
169
- | "Server disconnected" | Config'deki node yolunu kontrol edin: `which node` ile tam yolu bulun |
170
- | Plugin'de 0 bağlantı | Plugin'deki port ile AI aracının portu aynı olmalı |
171
-
172
- Detaylı sorun giderme: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
173
-
174
- ## Sürüm bilgisi
175
-
176
- | Bilgi | Kaynak |
177
- |-------|--------|
178
- | Güncel sürüm | **1.7.13** ([package.json](package.json)) |
179
- | Değişiklik geçmişi | [CHANGELOG.md](CHANGELOG.md) |
180
- | GitHub sürümleri | [Releases](https://github.com/atezer/FMCP/releases) |
181
- | npm paketi | [@atezer/figma-mcp-bridge](https://www.npmjs.com/package/@atezer/figma-mcp-bridge) |
120
+ | Plugin "no server" diyor | AI aracınızı yeniden başlatın |
121
+ | Plugin "connecting..." diyor | Bekleyin, otomatik bağlanır |
122
+ | Yeni araçlar görünmüyor | AI aracını tamamen kapatıp tekrar açın |
182
123
 
183
- **Güncelleme:** NPX ile `@latest` kullanıyorsanız otomatik güncellenir. Repo ile kurduysanız: `git pull` → `npm run build:local` → AI aracını yeniden başlatın.
124
+ Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
184
125
 
185
- ## Dokümanlar
126
+ ---
186
127
 
187
- | Doküman | Açıklama |
188
- |---------|----------|
189
- | [ONBOARDING.md](docs/ONBOARDING.md) | Adım adım kurulum rehberi |
190
- | [WINDOWS-INSTALLATION.md](docs/WINDOWS-INSTALLATION.md) | Windows kurulumu |
191
- | [SETUP.md](docs/SETUP.md) | Detaylı kurulum (Local / Remote) |
192
- | [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md) | **46 araç tam listesi** |
193
- | [TOOLS.md](docs/TOOLS.md) | Araçların detaylı açıklamaları |
194
- | [REST_API_GUIDE.md](docs/REST_API_GUIDE.md) | REST API kullanım rehberi |
195
- | [CONTRIBUTING.md](CONTRIBUTING.md) | Projeye katkıda bulunma rehberi |
196
- | [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) | Sorun giderme |
197
- | [UPDATE.md](docs/UPDATE.md) | Güncelleme rehberi (NPX / Clone / Claude Code) |
198
- | [MULTI_INSTANCE.md](docs/MULTI_INSTANCE.md) | Çoklu kullanıcı ve port yönetimi |
199
- | [ENTERPRISE.md](docs/ENTERPRISE.md) | Kurumsal özellikler (audit log, air-gap) |
200
- | [ARCHITECTURE.md](docs/ARCHITECTURE.md) | Teknik mimari |
201
- | [USE_CASES.md](docs/USE_CASES.md) | Örnek kullanım senaryoları |
202
- | [SECURITY_AUDIT.md](docs/SECURITY_AUDIT.md) | Güvenlik denetimi |
203
- | [TEST_REPORT.md](docs/TEST_REPORT.md) | Kapsamli entegrasyon testi: 46 arac, 17 skill, 120 token, 6 ekran |
204
-
205
- ## Güvenlik ve gizlilik
206
-
207
- - Tasarım verileri bilgisayarınızdan **çıkmaz** — tüm iletişim localhost üzerinden
208
- - REST API token'ı bellekte tutulur, diske **yazılmaz**
209
- - İnternetsiz (air-gap) ortamlarda çalışır
210
- - Detay: [PRIVACY.md](PRIVACY.md)
211
-
212
- ## Kurumsal kullanım (Tüm şirkette tek seferde)
213
-
214
- Plugin'i herkesin tek tek yüklemesi gerekmez. Figma Organization hesabınız varsa plugin'i **private plugin** olarak yayınlayabilirsiniz:
128
+ ## Teknik detaylar
215
129
 
216
- **Publish plugin** **Publish to** **Organizasyon adınız (Private)** seçin.
217
-
218
- Yayınladıktan sonra:
219
- - Tüm ekip üyeleri **Plugins** menüsünden tek tıkla erişir
220
- - Kimsenin "manifest import" yapmasına gerek kalmaz
221
- - Plugin güncellemelerini merkezden yönetirsiniz
222
- - Review süreci yok (private plugin) — yayınladıktan hemen sonra kullanılabilir
223
-
224
- **Gereksinimler:**
225
- - Figma **Organization** veya **Enterprise** planı
226
- - Yayınlama: Figma → Plugins → Publish → **Publish to** kısmında organizasyonunuzu seçin
227
-
228
- > Her kullanıcının kendi bilgisayarında sadece AI aracı config'ini (Claude/Cursor) ayarlaması yeterli. Plugin zaten şirketin Figma'sında hazır olur.
229
-
230
- Kurumsal özellikler (audit log, air-gap, org plugin detayı): [ENTERPRISE.md](docs/ENTERPRISE.md)
130
+ - **46 araç** tasarım okuma, bileşen oluşturma, variable yönetimi, export ([tam liste](docs/TOOLS_FULL_LIST.md))
131
+ - **17 skill** — token pipeline, ekran üretimi, erişilebilirlik denetimi, kod üretimi ([test raporu](docs/TEST_REPORT.md))
132
+ - **Çoklu dosya + çoklu AI aracı** — Claude, Cursor ve Claude Code aynı anda çalışır
133
+ - **Figma Desktop + Tarayıcı** Her ikisinde de çalışır
134
+ - **Gizlilik** Veriler bilgisayarınızdan çıkmaz, internetsiz (air-gap) ortamlarda çalışır
135
+ - [Mimari](docs/ARCHITECTURE.md) · [Kurumsal kullanım](docs/ENTERPRISE.md) · [Katkı rehberi](CONTRIBUTING.md)
231
136
 
232
- ## Lisans
137
+ ---
233
138
 
234
- MIT kişisel ve ticari kullanıma açık. Detay: [LICENSE](LICENSE)
139
+ | | |
140
+ |---|---|
141
+ | Güncel sürüm | **1.7.14** ([CHANGELOG](CHANGELOG.md) · [Releases](https://github.com/atezer/FMCP/releases)) |
142
+ | npm | [@atezer/figma-mcp-bridge](https://www.npmjs.com/package/@atezer/figma-mcp-bridge) |
143
+ | Lisans | MIT — kişisel ve ticari kullanıma açık |
235
144
 
236
145
  **Sorun mu var?** [GitHub Issues](https://github.com/atezer/FMCP/issues)
@@ -326,7 +326,7 @@ export class PluginBridgeServer {
326
326
  logger.info({ clientId, fileKey: incomingFileKey, fileName: incomingFileName }, "Plugin bridge: client registered (fileKey=%s, fileName=%s)", incomingFileKey, incomingFileName);
327
327
  ws.send(JSON.stringify({
328
328
  type: "welcome",
329
- bridgeVersion: "1.7.13",
329
+ bridgeVersion: "1.7.14",
330
330
  port: this.port,
331
331
  clientId,
332
332
  multiClient: true,
@@ -89,7 +89,7 @@ export async function main() {
89
89
  bridge.start();
90
90
  const server = new McpServer({
91
91
  name: "F-MCP ATezer Bridge (Plugin-only)",
92
- version: "1.7.13",
92
+ version: "1.7.14",
93
93
  });
94
94
  // ---- figma_list_connected_files (multi-client discovery) ----
95
95
  server.registerTool("figma_list_connected_files", {
package/dist/local.js CHANGED
@@ -48,7 +48,7 @@ class LocalFigmaMCP {
48
48
  this.variablesCache = new Map();
49
49
  this.server = new McpServer({
50
50
  name: "F-MCP ATezer (Local)",
51
- version: "1.7.13",
51
+ version: "1.7.14",
52
52
  });
53
53
  }
54
54
  /**
@@ -346,16 +346,16 @@
346
346
  </div>
347
347
  <div class="advanced-wrap">
348
348
  <button id="advanced-toggle" class="advanced-toggle" type="button">Advanced</button>
349
- <span id="advanced-state" class="advanced-state">auto port</span>
349
+ <span id="advanced-state" class="advanced-state">otomatik bağlantı aktif</span>
350
350
  </div>
351
351
  <div id="advanced-panel" class="advanced-panel">
352
352
  <div class="bridge-host" title="Host: localhost (aynı makine) veya IP adresi (uzak makine). Browser Figma'da da çalışır.">
353
353
  <label for="mcp-host">Host</label>
354
354
  <input type="text" id="mcp-host" value="localhost" placeholder="localhost" aria-label="MCP bridge host (localhost veya IP)" />
355
355
  </div>
356
- <div class="bridge-port" title="Port elle belirtilmezse bridge'in dinlediği porta otomatik bağlanır (5454-5470 aralığı).">
356
+ <div class="bridge-port" title="Port otomatik bulunur (5454-5470). Elle değiştirmeniz gerekmez — sadece sorun yaşarsanız kullanın.">
357
357
  <label for="mcp-port">Port</label>
358
- <input type="number" id="mcp-port" min="5454" max="5470" value="5454" aria-label="MCP bridge port (auto fallback 5454-5470)" title="Elle değiştirirseniz tek porta kilitlenir; Otomatik tara veya Advanced'ı kapatın." />
358
+ <input type="number" id="mcp-port" min="5454" max="5470" value="5454" aria-label="MCP bridge port (auto fallback 5454-5470)" title="Normalde değiştirmeniz gerekmez. Elle değiştirirseniz otomatik tarama durur Advanced'ı kapatarak sıfırlayabilirsiniz." />
359
359
  </div>
360
360
  <div id="port-switcher" style="display:flex;align-items:center;gap:4px;margin-top:4px;">
361
361
  <button type="button" id="port-prev" onclick="switchActivePort(-1)" style="font-size:12px;padding:1px 5px;background:var(--fmcp-bg-subtle);border:1px solid var(--fmcp-border-light);border-radius:3px;color:var(--fmcp-text-secondary);cursor:pointer;">◀</button>
@@ -1091,7 +1091,7 @@
1091
1091
  panel.classList.toggle('is-open', !!open);
1092
1092
  }
1093
1093
  if (state) {
1094
- state.textContent = open ? 'manual controls' : 'auto port';
1094
+ state.textContent = open ? 'manuel kontrol' : 'otomatik bağlantı aktif';
1095
1095
  }
1096
1096
  try { localStorage.setItem(MCP_ADVANCED_OPEN_KEY, open ? '1' : '0'); } catch (e) {}
1097
1097
  if (open) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atezer/figma-mcp-bridge",
3
- "version": "1.7.13",
3
+ "version": "1.7.15",
4
4
  "description": "F-MCP ATezer: MCP server and Figma plugin bridge for Claude/Cursor. No REST token required.",
5
5
  "type": "module",
6
6
  "main": "dist/local.js",