@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 +43 -0
- package/README.md +87 -178
- package/dist/core/plugin-bridge-server.js +1 -1
- package/dist/local-plugin-only.js +1 -1
- package/dist/local.js +1 -1
- package/f-mcp-plugin/ui.html +4 -4
- package/package.json +1 -1
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
|
|
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
|
-
|
|
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
|
-
|
|
13
|
+
## Neye ihtiyacım var?
|
|
18
14
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
24
|
+
## Kurulum (5 dakika)
|
|
39
25
|
|
|
40
|
-
|
|
26
|
+
**1.** [Claude Code'u indirin](https://claude.ai/download) (henüz yoksa)
|
|
41
27
|
|
|
42
|
-
**
|
|
28
|
+
**2.** Claude Code'u açın ve şunu yazın:
|
|
43
29
|
|
|
44
|
-
|
|
30
|
+
> *"https://github.com/atezer/FMCP bu repoyu kur"*
|
|
45
31
|
|
|
46
|
-
|
|
32
|
+
Claude gerekli her şeyi (Node.js, build, ayarlar) otomatik yapar. Sizden sadece gerekirse **bilgisayar şifreniz** istenir.
|
|
47
33
|
|
|
48
|
-
|
|
34
|
+
**3.** Claude "kurulum tamamlandı" deyince **Claude Code'u kapatıp tekrar açın**
|
|
49
35
|
|
|
50
|
-
|
|
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
|
-
|
|
38
|
+
**5.** Hazırsınız! Claude'a Figma ile ilgili sorularınızı sorun.
|
|
62
39
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
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
|
-
|
|
44
|
+
---
|
|
70
45
|
|
|
71
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
57
|
+
---
|
|
84
58
|
|
|
85
|
-
|
|
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
|
-
|
|
61
|
+
AI ile Figma arasında **çift yönlü** çalışırsınız:
|
|
97
62
|
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
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
|
-
|
|
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
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
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
|
-
|
|
80
|
+
46 aracın tam listesi: [TOOLS_FULL_LIST.md](docs/TOOLS_FULL_LIST.md)
|
|
116
81
|
|
|
117
|
-
|
|
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
|
-
|
|
84
|
+
## Figma API Token (opsiyonel — ek özellikler)
|
|
125
85
|
|
|
126
|
-
|
|
86
|
+
F-MCP temel özellikleri token olmadan çalışır. Figma API token eklerseniz **ek özellikler** açılır:
|
|
127
87
|
|
|
128
|
-
|
|
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
|
|
131
|
-
1.
|
|
132
|
-
2. Figma'da plugin'i açın
|
|
133
|
-
3.
|
|
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
|
-
|
|
102
|
+
---
|
|
143
103
|
|
|
144
|
-
##
|
|
104
|
+
## Güncelleme
|
|
145
105
|
|
|
146
|
-
|
|
106
|
+
Claude Code'a şunu söyleyin:
|
|
147
107
|
|
|
148
|
-
-
|
|
149
|
-
- **Figma Browser** — tarayıcıda figma.com
|
|
150
|
-
- **FigJam** — whiteboard/diyagram
|
|
108
|
+
> *"F-MCP'yi güncelle"*
|
|
151
109
|
|
|
152
|
-
|
|
110
|
+
Claude gerisini halleder. Sonra Claude'u yeniden başlatın.
|
|
153
111
|
|
|
154
|
-
|
|
112
|
+
Detay: [UPDATE.md](docs/UPDATE.md)
|
|
155
113
|
|
|
156
|
-
|
|
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ı
|
|
168
|
-
|
|
|
169
|
-
|
|
|
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
|
-
|
|
124
|
+
Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
|
|
184
125
|
|
|
185
|
-
|
|
126
|
+
---
|
|
186
127
|
|
|
187
|
-
|
|
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
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
-
|
|
220
|
-
-
|
|
221
|
-
-
|
|
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
|
-
|
|
137
|
+
---
|
|
233
138
|
|
|
234
|
-
|
|
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.
|
|
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.
|
|
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
package/f-mcp-plugin/ui.html
CHANGED
|
@@ -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">
|
|
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
|
|
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
|
|
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 ? '
|
|
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