Tasarım sürecinizi yapay zeka ile dönüştürmek mi istiyorsunuz? O halde, MCP (Model Context Protocol) tam bir devrim niteliğinde, Figma tasarımlarının Claude, Windsurf, Cursor, Cline gibi büyük dil modelleri (LLM'ler) ile etkileşimini süper kolay hale getiriyor, daha niceleri! Bu adım adım kılavuzda, Figma MCP'nin ne olduğunu, nasıl çalıştığını ve bu inanılmaz aracı nasıl kullanmaya başlayacağınızı inceleyelim.

Figma-MCP Nedir?
Figma-MCP, LLM'lerin Figma kaynaklarıyla etkileşim kurması için standartlaştırılmış bir bağlam sağlayan, Model Context Protocol'ü uygulayan bir sunucudur. Bu entegrasyon, tasarımcıların ve geliştiricilerin tasarım görevlerini otomatikleştirmek, işbirliğini geliştirmek ve iş akışlarını kolaylaştırmak için yapay zekadan yararlanmasını sağlar.
Figma-MCP Nasıl Çalışır?
MCP Protokolü: Model Context Protocol, LLM'lerin Figma gibi harici uygulamaları anlaması ve onlarla etkileşim kurması için standartlaştırılmış bir yoldur. Bu sistemler arasında bağlam alışverişi için yapılandırılmış bir çerçeve sağlar.
Figma Entegrasyonu: Figma MCP sunucusu, Figma'nın API'sine bağlanarak LLM'lerin dosyalar, bileşenler ve stiller gibi tasarım öğelerine erişmesini ve bunları işlemesini sağlar. Bu entegrasyon, yapay zeka araçlarının tasarım bilgilerini çıkarmasına ve içgörüler oluşturmasına olanak tanıyan okuma işlemlerini destekler.
Yapay Zeka Destekli Tasarım Otomasyonu: Figma-MCP ile, tasarım varyasyonları oluşturma, stilleri güncelleme ve hatta mevcut tasarımlara dayalı yeni bileşenler oluşturma gibi görevleri otomatikleştirebilirsiniz. Bu otomasyon, tasarım iş akışlarında zaman kazandırır ve üretkenliği artırır.
Figma-MCP'yi Nasıl Kullanılır ve Başlangıç
Figma-MCP'yi kullanmak, sunucuyu kurmayı ve onu Cursor gibi yapay zeka araçlarıyla entegre etmeyi içerir. İşte başlamanıza yardımcı olacak ayrıntılı bir kılavuz:
Adım 1: Önkoşullar
- Node.js (v16.0 veya üzeri)
- npm (v7.0 veya üzeri) veya pnpm (v8.0 veya üzeri)
- Figma hesabı: tercihen bir Professional veya Enterprise planı önerilir.
- Figma API erişim belirteci: Okuma izinlerine sahip bir Figma API erişim belirteci gerekir.
Adım 2: Figma API Erişim Belirtecinizi Nasıl Alırsınız
MCP'yi Figma ile entegre etmek için bir API erişim belirteci gerekir. Bu belirteç, MCP'nin Figma hesabınızla etkileşim kurmasını sağlayan güvenli bir anahtar görevi görür. İşte Figma API erişim belirtecinizi oluşturmak ve saklamak için adım adım bir kılavuz:
Figma Hesabına Kaydolun:
- Figma'nın Resmi Web Sitesini Ziyaret Edin: Figma'nın web sitesine gidin.
- Kaydolun: Henüz bir hesabınız yoksa yeni bir hesap oluşturun.
Adım 2: Figma Uygulamasını İndirin:
- İşletim Sisteminizi Seçin: İşletim sisteminizle (Windows, macOS veya Linux) uyumlu Figma masaüstü uygulamasını indirin.
- Uygulamayı Yükleyin: Figma'yı cihazınızda kurmak için kolay kurulum talimatlarını izleyin.
Figma'da Oturum Açın:
- Uygulamayı Açın: Figma masaüstü uygulamasını başlatın.
- Oturum Açın: Oturum açmak için Figma kimlik bilgilerinizi kullanın.
Profil Ayarlarınıza Erişin:
1. Profil Simgesine Tıklayın: Kenar çubuğunda, profil simgenize (genellikle adınız veya avatarınız) tıklayın.

2. Açılır Menüyü Açın: Bir menü görünecektir; Ayarlar'a tıklayın.

Güvenlik Ayarlarına Gidin:
1. Güvenliğe Git: Ayarlar menüsünde, Güvenlik sekmesini bulun ve tıklayın.

2. Kişisel Erişim Belirteçlerini Bulun: Kişisel Erişim Belirteçleri bölümüne gidin.

Yeni Bir Belirteç Oluşturun:
- "Yeni Belirteç Oluştur"a Tıklayın: Bu, yeni bir belirteç oluşturmak için bir istem açacaktır.
- Belirtecinizi Adlandırın: Belirtecinize amacını kolayca belirlemek için
Figma_MCP
gibi açıklayıcı bir ad verin. - Belirteci Oluşturun: Yeni API erişim belirtecinizi oluşturmak için Oluştur'a tıklayın.
Belirtecinizi Güvenli Bir Şekilde Saklayın:
- Belirteci Kopyalayın: Oluşturulduktan sonra, belirteci hemen kopyalayın. Not: Figma bu belirteci yalnızca bir kez gösterecektir, bu nedenle kaydettiğinizden emin olun.
- Güvenli Bir Şekilde Saklayın: Belirteci bir parola yöneticisi veya şifrelenmiş bir dosya gibi güvenli bir konuma yapıştırın.
Figma API Belirtecinizi Kullanmak İçin İpuçları:
Ortam Değişkenleri: Belirtecinizi, komut dosyalarında güvenli erişim için bir ortam değişkeninde saklayın:
export FIGMA_API_TOKEN="your_token_here"
- Sabit Kodlamadan Kaçının: Belirtecinizi asla doğrudan kod tabanınıza sabit kodlamayın.
- Risk Altındaysa İptal Edin: Belirtecinizin tehlikeye girdiğinden şüpheleniyorsanız, Güvenlik ayarlarında hemen iptal edin ve yenisini oluşturun.
Adım 3: Figma-MCP Sunucusunu Yükleyin
NPM ile Hızlı Kurulum: Depoyu yüklemeden NPM kullanarak sunucuyu hızlıca çalıştırın:
npx figma-developer-mcp --figma-api-key=<your-figma-api-key>
Alternatif olarak, benzer sonuçlar için pnpx
, yarn dlx
veya bunx
kullanabilirsiniz.
Yerel Kaynaktan Yükleyin: Depoyu klonlayın:
git clone https://github.com/GLips/Figma-Context-MCP.git
cd Figma-Context-MCP
Bağımlılıkları pnpm install
kullanarak yükleyin.
.env.example
dosyasını .env
dosyasına kopyalayın ve Figma API erişim belirtecinizi doldurun.
Sunucuyu pnpm run dev
ile çalıştırın.
Adım 3: Sunucuyu Yapılandırın
Ortam Değişkenleri: .env
dosyasındaki ortam değişkenlerini kullanarak sunucuyu yapılandırın. FIGMA_API_KEY
'i erişim belirtecinize ayarlayın ve varsayılan 3333'ten farklı bir bağlantı noktası kullanmak istiyorsanız isteğe bağlı olarak PORT
'u ayarlayın.
Komut Satırı Argümanları: Alternatif olarak, --figma-api-key
ve --port
gibi komut satırı argümanlarını kullanın. Bunlar, ortam değişkenlerinden önceliklidir.
Adım 4: Figma-MCP Sunucunuzu Yapay Zeka Araçlarıyla Entegre Etme
Figma-MCP sunucunuz çalışır durumda olduğuna göre, onu Windsurf, Cline ve Claude gibi yapay zeka araçlarına bağlama zamanı. Figma + MCP, yapay zeka destekli birden fazla iş akışını desteklerken, bu eğitim için Cursor IDE ve Cursor Composer kullanacağız. Bu entegrasyon, tasarım-koda iş akışlarını otomatikleştirecek, UI bileşenleri oluşturacak ve daha fazlasını yapmanızı sağlayacaktır. İşte nasıl yapılacağı:
1. Figma-MCP Sunucusunun Çalıştığından Emin Olun: Figma-MCP sunucunuzun etkin ve doğru bağlantı noktasında (örneğin, 3333
numaralı bağlantı noktası) çalıştığından emin olun. Değilse, bunu yapmanın önerilen yolu, daha önce tartışıldığı gibi, şu komutu çalıştırmaktır:
npx figma-developer-mcp --figma-api-key=<your-figma-api-key>
2. MCP Sunucusu Ekle: Cursor'ı başlatın ve Ayarlar menüsüne gidin. Ayarlardaki MCP bölümüne gidin ve Yeni MCP Sunucusu Ekle'ye tıklayın. İstediğiniz herhangi bir adı verin, ardından SSE (Sunucu Tarafından Gönderilen Etkinlikler) seçeneğini belirleyin ve Figma-MCP sunucunuzun URL'sini (örneğin, http://localhost:3333
) yapıştırın.

Windsurf, Cline ve Claude Desktop gibi diğer araçlar, sunucuyu başlatmak için bir yapılandırma dosyası kullanır. Bu nedenle, yapılandırma dosyanıza aşağıdakileri ekleyerek figma-developer-server
'ı da yapılandırabilirsiniz:
{
"mcpServers": {
"figma-developer-mcp": {
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--stdio"],
"env": {
"FIGMA_API_KEY": "<your-figma-api-key>"
}
}
}
}
3. Bağlantıyı Doğrulayın: Sunucunun adının yanında, başarılı bir bağlantıyı gösteren yeşil bir nokta görünecektir. Kırmızı bir nokta, bağlantının başarılı olmadığı anlamına gelir ve yapılandırmalara bakmanız veya sunucunun çalışıp çalışmadığını doğrulamanız gerekir.

4. Figma'da Bir Tasarım Seçin: Figma'yı açın ve Figma projenize gidin ve üzerinde çalışmak istediğiniz tasarımı seçin. Gerekirse, uyumlu bir tasarım oluşturmak için tel çerçevelerinizin bileşenlerini veya bölümlerini gruplandırın.

5. Bağlantıyı Kopyalayın: üzerinde çalışmak istediğiniz tasarımın bağlantısını kopyalamak için: Seçili tasarıma sağ tıklayın > Kopyala/Yapıştır Farklı'yı seçin > ardından Seçime Bağlantıyı Kopyala seçeneğini belirleyin. Bu bağlantı, Cursor'da tasarıma başvurmak için kullanılacaktır.

6. Cursor Composer ile Kullanın: imleçle belirli bir tasarımla çalışmak için, Composer'ı açın ve Agent Modunu etkinleştirin.
Ardından, kopyalanan Figma bağlantısını Cursor Composer'a yapıştırın. Artık Cursor'dan şu gibi görevleri gerçekleştirmesini isteyebilirsiniz:
- Kod Oluştur: “Bu Figma tasarımını React'te uygulayın.”
- Bileşenler Oluştur: “Bu tasarımı yeniden kullanılabilir UI bileşenlerine dönüştürün.”
- Düzeni Optimize Edin: “Bu düzen için iyileştirmeler önerin.”
Figma-MCP'yi Kullanmak İçin Ek İpuçları
MCP Inspector: MCP sunucusundan gelen yanıtları incelemek isterseniz, yeni bir terminalde pnpm inspect
komutunu çalıştırın. Bu komut, MCP Inspector Web UI'sini başlatır ve mevcut araçları görüntülemenize, araç çağrılarını tetiklemenize ve yanıtları incelemenize olanak tanır.
get_file: Bir Figma dosyası hakkında bilgi getirir. Parametreler arasında fileKey
ve isteğe bağlı olarak depth
bulunur.
get_node: Bir Figma dosyasındaki belirli bir düğüm hakkında bilgi getirir. Parametreler arasında fileKey
ve nodeId
bulunur.
Bu adımları izleyerek, Figma MCP'yi yapay zeka araçlarıyla etkili bir şekilde entegre edebilir, tasarım iş akışınızı otomatik görevler ve doğru tasarım uygulamalarıyla geliştirebilirsiniz.
Figma MCP'nin Özellikleri
MCP Uyumluluğu: Sunucu, çeşitli LLM uygulamalarıyla uyumluluk sağlayan Model Context Protocol'ü izler.
Türe Duyarlı Uygulama: TypeScript kullanılarak oluşturulmuş olup, sağlam ve bakımı kolay bir kod tabanı sağlar.
Özel URI Şeması: Tasarım varlıklarını yönetmeyi kolaylaştıran, Figma kaynaklarına erişmek için özel bir URI şemasını destekler.
Hata İşleme ve Doğrulama: Güvenilir çalışma sağlamak için sağlam hata işleme ve istek doğrulaması içerir.
Toplu İşlemler: Tasarım öğelerinin verimli bir şekilde işlenmesi için toplu işlemleri destekler.
Sonuç
Figma MCP, tasarımcılar ve geliştiriciler için kolaylaştırılmış bir iş akışı sunarak tasarım ve yapay zeka arasındaki boşluğu dolduran güçlü bir araçtır. Figma'yı büyük dil modelleriyle entegre ederek, tasarım sürecinizde yeni üretkenlik ve yaratıcılık seviyelerinin kilidini açabilirsiniz. İster görevleri otomatikleştirmek, ister işbirliğini geliştirmek veya sadece tasarımda yapay zekanın potansiyelini keşfetmek istiyor olun, Figma MCP başarılı olmak için ihtiyacınız olan temeli sağlar.
Figma MCP sunucunuzu, tasarım-koda iş akışları için Cursor gibi yapay zeka araçlarına nasıl bağlayacağınızı öğrenin. Adım adım kılavuz.
Figma MCP sunucusu ile tanrısal düzeyde yaratıcılığı ve tasarımı serbest bırakın ve tasarım-koda iş akışları için Cursor gibi yapay zeka araçlarına nasıl entegre edeceğinizi öğrenin.