Veri Bilimi Okulu

n8n MCP Server Nedir, Nasıl Kullanılır?
n8n MCP Server Nedir, Nasıl Kullanılır?
Claude'dan n8n'e uzanan MCP bağlantısı: Instance-level erişim, workflow görünürlüğü ve Trigger Node

Loading

MCP (Model Context Protocol), yapay zeka asistanlarının dış araçlar ve servislerle standart bir protokol üzerinden konuşmasını sağlayan açık bir standart. Anthropic tarafından geliştirilen bu protokol sayesinde Claude gibi modeller, yalnızca metin üretmekle kalmayıp gerçek dünya sistemlerine bağlanabiliyor ve onları yönetebiliyor. n8n’in MCP server desteğiyle birlikte bu tablo daha da güçleniyor; artık bir AI asistanı, n8n üzerindeki otomasyon akışlarını doğrudan keşfedebiliyor ve çalıştırabiliyor.

Bildiğiniz üzere n8n uzun süredir otomasyon tarafında güçlü bir araç olarak kullanılıyor. Son dönemde öne çıkan yeniliklerden biri ise n8n’in yerleşik MCP server desteği. Bu özellik sayesinde desteklenen MCP istemcileri n8n instance’ına bağlanabiliyor, belirli workflow’ları bulabiliyor ve yetki verilen sınırlar içinde çalıştırabiliyor. MCP artık sadece çalıştırma değil, discovery + bazı durumlarda interaction/edit yeteneklerine de kayıyor. Konunun kritik tarafı, bu erişimin rastgele değil, yönetilebilir bir çerçevede kurulması.

n8n’de İki Farklı MCP Yaklaşımı

n8n dokümantasyonunda iki ayrı yaklaşım net biçimde ayrılıyor. Birincisi instance-level MCP access. Bu modelde bağlantı instance seviyesinde bir kez açılıyor, kimlik doğrulama merkezi şekilde yönetiliyor ve hangi workflow’ların erişime açılacağı tek bir yerden kontrol ediliyor. İkincisi MCP Server Trigger node yaklaşımı. Burada MCP davranışı tek bir workflow içinde, düğüm bazında tanımlanıyor. Daha dar ve senaryoya özel bir yapı gerekiyorsa Trigger node mantıklı olabilir. Ayrıca belirli execution pattern’ları için daha uygun bir mimari sunar. Ancak birden çok workflow’u ortak bir erişim modeliyle yönetmek istiyorsanız instance-level yaklaşım daha düzenli bir yol sunuyor.

Instance-Level MCP Erişimi Nasıl Açılır?

Instance-level MCP erişimini açmak için n8n içinde Settings menüsündeki Instance-level MCP bölümüne gidip ana erişim ayarını etkinleştirmek gerekiyor. Bu işlem için yönetici düzeyinde yetki gerekiyor. Erişim açıldıktan sonra MCP’ye açılmış workflow listesi, bağlı OAuth istemcileri ve bağlantı ayrıntıları aynı ekranda görülebiliyor. İhtiyaç halinde bu erişimi yine aynı yerden kapatmak mümkün. Self-hosted kurulumlarda daha katı bir tercih yapmak istenirse, MCP modülü ortam değişkeni üzerinden tamamen devre dışı da bırakılabiliyor. N8n dökümanlarında bunun için N8N_DISABLED_MODULES=mcp değişkeni veriliyor; bu durumda MCP endpoint’leri ve ilgili arayüz öğeleri kaldırılıyor.

Kimlik Doğrulama: OAuth2 mi, Access Token mi?

Kimlik doğrulama tarafında iki seçenek var; OAuth2 ve Access Token. OAuth2 modeli daha kontrollü bir kullanım sağlıyor çünkü bağlanan istemciler kayıt altına alınıyor ve gerekirse tek tek erişimleri geri alınabiliyor. Özellikle birden çok istemcinin bağlandığı ortamlarda bu yönetim avantajı önemli. Access Token modeli ise daha hızlı bir kurulum sağlıyor; istemciye sunucu URL’si ve token veriliyor, bağlantı kısa sürede tamamlanıyor. Burada dikkat edilmesi gereken nokta, token’ın ilk üretimde tam haliyle görünmesi ve sonrasında maskelenmesi. Bu nedenle token’ın üretildiği anda güvenli bir yere alınması gerekiyor. Token kaybolursa ya da güvenlik gereği yenilemek istenirse yeni token üretilebiliyor; n8n eski token’ı otomatik olarak geçersiz kılıyor. Ancak token yönetimi (saklama, rotation, iptal) doğru yapılmazsa güvenlik açısından daha riskli bir model diyebiliriz.

Workflow Görünürlüğü ve Erişim Kontrolü

Erişim kontrolünün en önemli kısmı workflow görünürlüğü. MCP erişimini açmış olmak, tüm workflow’ları otomatik olarak dışarıya açmıyor. Varsayılan davranış kapalı; her workflow için ayrıca erişim izni verilmesi gerekiyor. Bu izin n8n sürümüne göre Instance-level MCP sayfasından, workflow editörü içinden ya da workflow listesindeki kart menüsünden verilebiliyor. Pratikte bu yaklaşım ciddi bir güvenlik katmanı sağlıyor çünkü yalnızca gerçekten ihtiyaç duyulan akışlar erişilebilir hale geliyor. Ek olarak, workflow’un MCP tarafından kullanılabilir olması için yayımlanmış (published) olması gerekir.

Instance-level modelde erişim istemci bazında ayrı ayrı daraltılmıyor; kontrol workflow seti üzerinden sağlanıyor. MCP’ye açılmış workflow seti, bağlı istemciler tarafından aynı kapsamda görülebiliyor. Bu yüzden erişime açılan workflow seçiminde dikkatli olmak gerekiyor. Bir başka kritik ayrıntı execute_workflow davranışı. Bu araç varsayılan olarak workflow’un yayımlanmış, yani production sürümünü çalıştırıyor. Gerektiğinde manual execution modu ile güncel ama yayımlanmamış sürümün çalıştırılması da mümkün. Test ve canlı ortam ayrımını gözetmek için bu farkın iyi anlaşılması şart.

Workflow Açıklamalarını Atlamayın

Workflow açıklamaları da çoğu zaman gözden kaçıyor ama MCP tarafında doğrudan etkili. n8n, erişime açılmış workflow’ları istemcilere sunarken isim ve açıklama bilgilerini referans alıyor. Açıklama ne kadar netse, doğru workflow’un bulunması ve yanlış çağrıların azalması o kadar kolay oluyor. Özellikle bir instance içinde benzer isimli çok sayıda akış varsa, kısa ama amaç odaklı açıklamalar operasyonel kaliteyi ciddi biçimde artırıyor.

Bağlantı örnekleri tarafında resmi doküman farklı istemciler için yol gösteriyor. Claude Desktop, Claude Code, Codex CLI ve Google ADK gibi istemciler için hem OAuth2 hem token tabanlı kurulum örnekleri yer alıyor. Kurulum yaparken temel mantık değişmiyor: doğru n8n URL’si, doğru doğrulama yöntemi ve erişime açık workflow seti. Sorun yaşandığında da ilk kontrol edilmesi gereken noktalar açık: n8n instance’ının dış erişime uygun olması, MCP’nin gerçekten etkin olması, ilgili workflow’un MCP’ye açılmış olması ve istemcideki doğrulama bilgilerinin doğru girilmesi.

Özet

Özetle n8n MCP server, n8n’i yalnızca arka planda çalışan bir otomasyon motoru olmaktan çıkarıp dış istemcilerle kontrollü biçimde konuşabilen bir katmana dönüştürüyor. Güçlü tarafı esneklik, kritik tarafı ise yönetişim. Erişimi instance seviyesinde açıp hangi workflow’un görünür olacağını tek tek belirlemek, token ve istemci yönetimini düzenli yürütmek ve production-manual ayrımını doğru kullanmak, sağlıklı bir kurulumun temelini oluşturuyor. Resmi dokümanda anlatılan model bu çerçeveyi net şekilde veriyor: merkezi aç, seçici paylaş, erişimi takip et, gerektiğinde geri al.

Kaynak: https://docs.n8n.io/advanced-ai/mcp/accessing-n8n-mcp-server/

0

Bir yanıt yazın

Password Requirements:

  • At least 8 characters
  • At least 1 lowercase letter
  • At least 1 uppercase letter
  • At least 1 numerical number
  • At least 1 special character