n8n ile MCP Nasıl Kullanılır?

MCP (Model Context Protocol), yapay zekâ uygulamalarını dış uygulamalara ve veri kaynaklarına bağlayan açık bir standarttır. MCP, n8n'de iki yönde kullanılır. n8n'deki bir ajan dış MCP sunucularının araçlarını kullanabilir. Claude gibi dış uygulamalar da n8n'e MCP ile bağlanabilir.

n8n'de MCP ne işe yarar?

MCP sunucusu, bir uygulamanın araçlarını MCP ile kullanıma açan programdır. MCP istemcisi ise bu sunucuya bağlanıp araçlarını kullanan taraftır. n8n belgelerine göre n8n hem istemci hem sunucu olarak çalışabilir. Node, n8n'de bir workflow içindeki tek adımdır. Workflow ise bir işi otomatik yapan node'ların bütünüdür:

MCP'nin genel çalışma biçimi MCP nedir yazısında anlatılır.

n8n'deki ajana MCP sunucusu nasıl bağlanır?

n8n belgelerine göre n8n, bir ajana doğrudan bağlanabilen MCP sunucularının listesini sunar. Bu listeye AI Agent node'unun Tools Panel'inden ulaşırsın. Adımlar şunlardır:

1. Canvas'taki AI Agent node'unda "Tool +" düğmesine tıklayarak Tools Panel'i aç. Canvas, editörün ortasında node'ların eklenip birbirine bağlandığı alandır.
2. Arama çubuğunda bağlanmak istediğin hizmeti ara ya da "MCP Servers" bölümünü aç.
3. Sunucuyu seç ve istendiğinde hizmetteki hesabınla giriş yap.
4. "Tools to include" ayarında ajanın kullanacağı araçları seç.

Belgelere göre giriş yapıldığında n8n bir MCP credential'ını kendiliğinden oluşturur. Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. İstenen sunucu listede yoksa MCP Client Tool node'una bağlantı adresini ve credential'ı girerek herhangi bir MCP sunucusuna bağlanabilirsin. Ajanın kurulumu n8n'de yapay zekâ ajanı nasıl kurulur yazısında anlatılır.

Örnek: Bir kullanıcı listeden Notion'un MCP sunucusunu ajana bağlar. Ajan, sohbette istenen bir Notion sayfasını okur ve sayfadaki görevleri listeler.

Hazır node mu, MCP sunucusu mu kullanılmalı?

Hazır node, n8n'in bir hizmet için sunduğu yerleşik araç node'udur. Belgelere göre hazır node da MCP sunucusu da ajanın bir hizmete erişmesini sağlar, ama kontrol düzeyleri farklıdır:

Belgelere göre MCP sunucusu ajana daha fazla serbestlik verir. Buna karşılık kontrol azalır. Ayrıca ajan her çağrıda daha fazla bağlam kullanır. Bağlam, dil modelinin bir cevap üretirken dikkate aldığı metnin tamamıdır.

n8n workflow'u MCP aracı olarak nasıl kullanılır?

n8n belgelerine göre MCP Server Trigger node'u, kendisine bağlanan araçları MCP istemcilerine açan bir adres oluşturur. Bir workflow'u istemcilere araç olarak sunmak için onu Custom n8n Workflow Tool node'uyla bu node'a bağlarsın.

Belgelere göre MCP Server Trigger node'unun test ve canlı olmak üzere iki adresi vardır. Canlı adres, workflow yayımlandığında etkinleşir. Bu node, istemcilerden kimlik doğrulama isteyebilir. Desteklenen yöntemler Bearer auth ve Header auth'tur. Bearer auth, Authorization başlığında gönderilen bir erişim jetonuyla çalışır. Header auth ise istek başlığında gönderilen bir ad ve değer çiftiyle çalışır.

Claude, n8n'e MCP ile nasıl bağlanır?

n8n belgelerine göre n8n'in yerleşik MCP sunucusu, Claude Desktop gibi desteklenen istemcilerin n8n'e güvenli biçimde bağlanmasını sağlar. Adımlar şunlardır:

1. n8n'de Settings > Instance-level MCP bölümünü aç.
2. "Enable MCP access" ayarını etkinleştir. Bu ayar için n8n kurulumunun sahibi ya da yöneticisi olmak gerekir.
3. Bağlantı ayrıntılarındaki "Connect" düğmesine tıkla ve OAuth ya da API key yöntemini seç.
4. Sunucu adresini kopyala ve istemcide yeni bir MCP bağlantısı olarak ekle.
5. İstemcinin kullanacağı workflow'da Workflow menüsünden Settings'i aç ve "Available in MCP" ayarını etkinleştir.

OAuth, bir uygulamanın kullanıcının parolasını görmeden onun hesabına erişim izni almasını sağlayan yöntemdir.

Belgelere göre MCP erişimi sadece webhook, form, schedule ya da chat trigger node'u içeren ve yayımlanmış workflow'lar için etkinleştirilebilir. Trigger node, workflow'u belirli bir olayda ya da zamanda başlatan özel node'dur. İstemciler, kullanıcı bir workflow için MCP erişimini etkinleştirmedikçe o workflow'un verisine erişemez, onu çalıştıramaz ve değiştiremez.

Örnek: Bir kullanıcı, Webhook node'uyla başlayan ve yeni müşteriyi bir tabloya kaydeden workflow'unda MCP erişimini etkinleştirir. Claude Desktop'tan bu müşteriyi kaydetmesini istediğinde Claude o workflow'u çalıştırır.

Sonraki adım

n8n'de MCP Server Trigger node'u olan yeni bir workflow aç. Custom n8n Workflow Tool node'uyla araç olarak sunmak istediğin workflow'u bu node'a bağla. Trigger node'un bulunduğu workflow'u yayımla, node'un canlı adresini bir MCP istemcisine ekle ve istemcide aracın göründüğünü kontrol et.