Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

MCP entegrasyonları

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-10-09 Sahip: ax-code çalışma zamanı

AX Code dış araçlar, istemler ve kaynaklar için Model Context Protocol sunucularına bağlanabilir. MCP güçlüdür; bu yüzden AX Code MCP yapılandırmasını ve MCP’nin sağladığı içeriği bir güven sınırı olarak ele alır.

Deneysel tarayıcı köprüsü ayrı bir yoldur. Yalıtılmış bir Chrome penceresi açar ve bir sayfanın WebMCP üzerinden kaydettiği araçları çağırabilir. Terminal arayüzünden açın; adımlar ve onay katmanları WebMCP tarayıcı köprüsü belgesindedir.

Güven modeli

Kullanıcı denetimli yapılandırma kaynaklarından gelen MCP girdileri varsayılan olarak güvenilirdir:

genel kullanıcı yapılandırması;
yönetilen yapılandırma;
açık AX_CODE_CONFIG;
satır içi AX_CODE_CONFIG_CONTENT;
yetkili yerel çalışma zamanı yolları üzerinden çalışma zamanı eklemeleri.

Paylaşılan veya ağda keşfedilen kaynaklardan gelen MCP girdileri varsayılan olarak güvenilmez:

proje ax-code.json;
worktree .ax-code yapılandırması;
uzak iyi bilinen yapılandırma.

Güvenilmeyen MCP girdileri needs_trust olarak görünür. AX Code, girdi güvenilene kadar yerel MCP komutları başlatmaz, uzak MCP URL’lerine bağlanmaz, MCP araç şemalarını açmaz, istem/kaynak listelemez veya o girdi için OAuth başlatmaz.

Güven komutları

MCP durumunu listeleyin:

ax-code mcp list

Bir sunucu parmak izine güvenin:

ax-code mcp trust <name>

Güncel sunucu parmak izi için güveni geri alın:

ax-code mcp untrust <name>

Yapılandırılmış bir sunucuyu güncel projenin yapılandırmasından kaldırın:

ax-code mcp remove <name> --force

Genel yapılandırmadan kaldırmak için --global ekleyin. Kaldırma seçilen kapsamda kalır ve sunucu orada yoksa başarısız olur. Onaylamadan önce hedef yolu incelemek için --force atlayın.

Güven deponun dışında saklanır ve güncel proje artı sunucu parmak izine kapsamlanır. Komut, URL, OAuth kipi, üst bilgiler veya açık ortam değerleri gibi önemli MCP yapılandırmasını değiştirmek önceki güveni geçersiz kılar.

Çalışma zamanı izinleri

Güven yalnızca MCP sunucusunun çalışma zamanına katılmasına izin verir. Tekil MCP araç çağrıları yine AX Code izinlerinden geçer.

MCP araç izin anahtarları mevcut <server>_<tool> biçimini korur. AX Code araç bağımsız değişkenlerinden kararlı bir kaynak belirleyebildiğinde daha dar bir desenle sorar; örneğin:

url:https://api.example.com/resource
uri:mcp-resource
path:src/index.ts
repo:owner/name
db:database.table

Bilinmeyen bağımsız değişken biçimleri varsayılan olarak geniş dayanıklı onay sunmadan sorar.

İstemler, kaynaklar ve içerik

MCP istemleri ve kaynakları güvenilmeyen bağlamdır. AX Code MCP istem kullanımını ve MCP kaynak okumalarını izinlerle kapılar, getirilen metni güvenilmeyen MCP içeriği olarak etiketler ve büyük metni model bağlamına girmeden keser.

MCP araç üst verisi ve çıktıları da sınırlıdır:

aşırı büyük şemalar araç açılmadan reddedilir;
uzun açıklamalar tavanlanır;
yerel MCP stderr günlükleri kısaltılır ve belirgin gizli desenler sansürlenir;
modele dönük MCP araç içeriği, kullanıcıya görünen araç çıktısıyla aynı kesilme sonucunu kullanır.

HTML ve web geliştirme için Playwright MCP

Kökte index.html bulunan HTML oyunları, web uygulamaları veya herhangi bir proje üzerinde çalışırken AX Code projeyi bir web projesi olarak algılar ve ajanın tarayıcınızı otonom açmasını engeller. Bunun yerine ajan değişiklikleri raporlar ve sizin yenilemenizi bekler.

Ekran görüntüsüne dayalı doğrulama için Playwright MCP sunucusunu bağlayın:

ax-code mcp list --discover   # auto-suggests playwright in web projects

Veya ax-code.json dosyasına el ile ekleyin:

{
  "mcp": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--cdp-url", "http://localhost:9222"]
    }
  }
}

CDP ekleme kipi

Chrome --remote-debugging-port=9222 ile çalışıyorsa AX Code onu otomatik algılar ve CDP ekleme kipinde bağlanır. Ajan yeni bir pencere açmadan veya odağı çalmadan canlı sekmeyi yakalamak için browser_screenshot çağırabilir.

CDP açık Chrome başlatmak için:

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

Başsız geri dönüş

Açık bir Chrome CDP bağlantı noktası yoksa @playwright/mcp başsız bir Chromium örneği başlatır. Ekran görüntüleri TUI içinde satır içi işlenmeye devam eder.

Genel kurulum

@playwright/mcp genel olarak kuruluysa (npm install -g @playwright/mcp), AX Code playwright-mcp ikilisini doğrudan kullanır; npx yoluyla çalıştırmak yerine. İlk kullanımda bu daha hızlıdır.

Güvenlik notu

Playwright MCP sunucusu tarayıcınız üzerinde önemli yetenek kazanır. Proje yapılandırmasından geliyorsa (ax-code.json), ax-code mcp trust playwright ile açıkça güven verene kadar güvenilmez. Genel kullanıcı yapılandırması girdileri ilk onaydan sonra otomatik bağlanır.

Sunucu kipi

Değiştiren MCP HTTP yolları, genel sunucu korumalarına ek olarak sürece yerel bir çalışma zamanı yetkilendirme üst bilgisi ister. Bu, MCP sunucularını ekleme, bağlama, bağlantıyı kesme ve kimlik doğrulama gibi yerel çalışma zamanı denetim eylemlerini korur. Salt okunur MCP durumu GET /mcp üzerinden kullanılabilir kalır.

Figma MCP

Figma masaüstü

Figma masaüstü uygulamasında bir tasarım dosyası açın, Dev Mode’a geçin ve inceleme panelinde masaüstü MCP sunucusunu açın. Uygulamayı açmak tek başına sunucuyu açmaz. Figma masaüstü kurulum yönergelerine bakın.

AX Code yapılandırmanıza bu girdiyi ekleyin:

{
  "mcp": {
    "figma-desktop": {
      "type": "remote",
      "url": "http://127.0.0.1:3845/mcp",
      "allowLoopback": true,
      "oauth": false
    }
  }
}

Bir proje yapılandırması için girdiyi inceleyin ve güven verin:

ax-code mcp trust figma-desktop

type: "remote" HTTP/SSE taşımasını seçer; bu makinedeki HTTP sunucuları dahil. type: "local" stdio kullanan bir alt süreç seçer.

Geri döngü HTTP MCP ilkesi

allowLoopback varsayılan olarak false değerindedir. true yapmak, yapılandırılmış şema, ana bilgisayar adı ve bağlantı noktasıyla yalnızca localhost, 127.0.0.1 veya [::1] üzerinde HTTP(S) izin verir. Gömülü kimlik bilgisi olmayan bir geri döngü URL’si ister. Paylaşılan proje girdileri yine güven ister; seçeneği açmak onsuz daha önce verilmiş güveni geçersiz kılar.

Yönlendirmeler, SSE ileti uç noktaları ve OAuth istekleri aynı kaynakta kalmalıdır. Diğer bağlantı noktaları, herkese açık hedefler, özel ağ adresleri ve bulut üst veri uç noktaları engelli kalır. localhost için DNS yanıtlarının tümü geri döngü adresleri olmalıdır ve her bağlantı için sabitlenir. Dış bir OAuth verenine dayanan yerel hizmetler bu seçenekle desteklenmez. Figma Desktop için oauth: false kullanın.

Bağlantı reddedilirse masaüstü MCP sunucusunun açık olduğunu ve 3845 bağlantı noktasını dinlediğini denetleyin. localhost geçmek veya yalnızca OAuth’u kapatmak geri döngü erişimini açmaz.

Figma uzak OAuth (mcp.figma.com)

Figma’nın barındırılan uç noktası https://mcp.figma.com/mcp değeridir. Figma, MCP Kataloğu içinde onaylı bir istemci ister. İstemci geliştiricileri Figma uzak erişim kayıt gereksinimlerini izlemelidir.

Reddedilen dinamik bir kayıt, olağan bir Figma OAuth uygulaması oluşturmak veya onun istemci kimliği ile gizini vermekle çözülmez. Varsa onaylı bir MCP entegrasyonu için verilmiş kimlik bilgilerini kullanın. AX Code, resmi uç nokta kaydı reddettiğinde Katalog gereksinimini raporlar. Geri döngü erişimi barındırılan sunucu onayı vermez.

Belirteç tabanlı şablon

Yerleşik figma şablonu ayrı figma-developer-mcp paketini FIGMA_API_KEY ile çalıştırır. Figma’nın resmi Desktop ve barındırılan MCP sunucularından ayrıdır.