n8n'i Claude ve Hermes ile Yönetmek: MCP ile Workflow'larını AI Ajanlarına Devret (2026)

n8n kurdun, workflow'ların çalışıyor. Ama her değişiklik için panele girip düğüm sürüklemek, hata olunca log karıştırmak… bir yerden sonra o işi de yapay zekaya devretmek istiyorsun. Bu rehberde n8n'i iki AI ajanına — Claude'a ve Hermes Agent'a — nasıl bağlayacağını, ikisinin farklı güçlü yanlarını ve ikisini birlikte nasıl kullanacağını anlatıyorum.

Bağlantıyı sağlayan şey MCPiModel Context Protocol, bir AI ajanının dış araçlara bağlanmasını sağlayan standart. Ne olduğunu MCP nedir rehberinde detaylı anlattık; burada doğrudan n8n'e uyguluyorum.

Bu rehber, n8n'in kendi sunucunda (VPS) çalıştığını varsayıyor. Kurulumu yapmadıysan önce n8n kurulum rehberine bak.

Kavram: n8n'e Bağlanmanın İki Farklı Yolu

Claude ile Hermes aynı şeyi yapıyor gibi görünür ama arka planda iki ayrı kapıdan giriyorlar. Bunu bilmek, sorun çıktığında nereye bakacağını bilmeni sağlıyor.

Claude → n8n MCP sunucusu. n8n'in içinde yerleşik bir MCP sunucusu var. Claude (masaüstü uygulaması ya da Claude Code) bu sunucuya HTTP üzerinden bağlanıp workflow'ları arayabilir, tetikleyebilir, test edebilir ve düzenleyebilir. Bu, n8n'in resmi yolu.

Hermes → n8n REST API'si. Hermes'in kataloğunda n8n için hazır, Nous ekibinin gözden geçirdiği bir MCP köprüsü var. Bu köprü n8n'in MCP sunucusuna değil, doğrudan REST API'sine bağlanıyor. Tek komutla kuruluyor.

İkisi de aynı sonuca ulaşıyor: workflow'larını artık elinle değil, konuşarak yönetiyorsun. Fark kurulumda ve araç yüzeyinde.

[mindi_yorum]
💰 Bağlantıların kendisi ek ücret istemiyor; tek değişken maliyet, ajanın içinde kullandığın dil modeli API'si
🟢 Claude düzenleme ve oluşturmada güçlü; Hermes tek komutla kurulup read-only araçlarla güvenli başlıyor
🟡 n8n MCP sunucusu self-host'ta HTTPS + erişilebilir bir domain ister; düz IP üzerinden OAuth güvenilmez
🔵 İkisini de kur: Claude ile düzenle, Hermes ile otomatik izle — iş bölümü aşağıda

Ön Hazırlık: n8n Tarafında MCP'yi Aç

n8n 2.33.0 ve üzeri kullanıyorsan ayarlar tek ekranda toplanıyor. VPS'teki n8n paneline gir:

Adım 1: Sol menüden Settings → Instance-level MCP yolunu aç.

Adım 2: Enable MCP access butonuna tıkla. Bu yetki, owner veya admin hesabı ister.

Adım 3: Açılan sayfada üç bölüm görürsün: Connection details (MCP durumu ve Connect butonu), Access (MCP'ye açık workflow sayısı) ve Connected clients (bağlı istemciler).

Adım 4: Connection details altındaki Connect butonuna tıkla. Karşına Server URL çıkar — https://senin-domainin/mcp-server/http gibi bir adres. Bunu not et, Claude kurulumunda lazım olacak.

Adım 5: Hangi workflow'ları MCP'ye açacağını seç. MCP, bütün workflow'ları otomatik görmez; her workflow'u tek tek Available in MCP olarak işaretlemen gerekir.

Her workflow işaretlenemez. n8n yalnızca iki şartı birden sağlayanları MCP'ye açmana izin veriyor: workflow yayınlanmış olmalı ve içinde webhook, form, schedule ya da chat trigger düğümlerinden biri bulunmalı. Manuel trigger'lı ya da henüz yayınlanmamış bir workflow listede hiç çıkmaz. Aradığın workflow'u bulamıyorsan kurulumu yanlış yaptığını sanma — büyük ihtimalle bu şartlardan birini karşılamıyor.

Tek istisna search_workflows aracı: o, senin görme yetkin olan bütün workflow'ları listeleyebiliyor, ama yalnızca önizleme döndürüyor — tam içeriğe erişemiyor, çalıştıramıyor, değiştiremiyor.

Dikkat: execute_workflow aracı varsayılan olarak production modda çalışır, yani yayındaki versiyonu tetikler. Yeni bir workflow'u devretmeden önce test ortamında çalıştığından emin ol.

Claude'u Bağla

Claude'u iki şekilde bağlayabilirsin: masaüstü uygulamasıyla (grafiksel, en kolay) veya Claude Code ile (terminalden).

Claude Desktop (masaüstü)

Adım 1: Claude Desktop'ta Settings → Connectors bölümünü aç.

Adım 2: Add custom connector butonuna tıkla.

Adım 3: Şunları gir:

• Name: n8n MCP
• Remote MCP Server URL: n8n'deki Server URL (yukarıdaki Adım 4'teki adres)

Adım 4: Kaydet. Claude seni n8n'e yetkilendirmeye yönlendirir, onayla.

Claude Code (terminal)

OAuth ile bağlamak için:

claude mcp add --transport http n8n https://senin-domainin/mcp-server/http

Sonra Claude Code içinde /mcp yazıp n8n'i seç, OAuth onayını tamamla.

API key ile bağlamak istersen (OAuth istemiyorsan):

claude mcp add --transport http n8n-mcp https://senin-domainin/mcp-server/http --header "Authorization: Bearer N8N_MCP_TOKEN"

N8N_MCP_TOKEN'i n8n'de Settings → Instance-level MCP → Connect a client bölümünden üretirsin.

Dikkat: Claude Desktop'ın eski sürümleri HTTP MCP'yi doğrudan desteklemiyordu; o durumda supergateway köprüsüyle (npx -y supergateway --streamableHttp <url>) stdio'a çevirmen gerekir. Güncel sürümde Add custom connector doğrudan çalışıyor.

Bağlandıktan sonra Claude'a şunları söyleyebilirsin:

• "Hangi workflow'larım var, listele"
• "Şu workflow'u çalıştır ve sonucu özetle"
• "Bu workflow'da hata var, bul ve düzelt"

Claude Code kullanıyorsan: n8n Skills

n8n'in kendi dokümantasyonu, sohbet istemcisi yerine Claude Code gibi bir coding agentⁱkod yazıp çalıştırabilen, terminalde yaşayan AI ajanı kullanmayı öneriyor. Sebebi basit: workflow aslında yapılandırma kodu, bu ajanlar o işte daha iyi.

Ajanın n8n'in kendi kurallarını — ifade sözdizimi, hata yönetimi, alt workflow'lar, kimlik bilgileri — bilmesi için n8n-io/skills deposunda 13 yetenek modülü yayınlanmış. MCP sunucusuyla birlikte çalışıyorlar: ajan yüksek etkili bir çağrı yapmadan önce ilgili modülü okuyor, böylece n8n'i genel bilgisiyle değil güncel kurallarıyla kullanıyor. Kurulum adımları deponun README'sinde duruyor.

Zorunlu değil. Ama Claude'a workflow sadece çalıştırtmayıp yazdıracaksan ileri geri düzeltme sayısını belirgin azaltıyor.

Hermes'i Bağla

Hermes tarafı tek komut:

hermes mcp install n8n

Adım 1: Kurulum sırasında Hermes iki şey sorar:

• N8N_BASE_URL — n8n adresin. VPS'teyse https://senin-domainin (ya da sadece deneme için http://IP:5678).
• N8N_API_KEY — n8n'de Settings → API altından üret.

Adım 2: Kurulumun sonunda Hermes, köprünün açığa çıkardığı araçların listesini gösterir. Varsayılanda 8 read-only araç açık gelir: list_workflows, get_workflow, find_workflows, list_executions, get_execution, recent_failures, export_workflow, health.

Adım 3: Mutasyon yapan araçlar (activate / deactivate, docker container_logs) varsayılanda kapalı. İhtiyacın olursa kurulum sonrası hermes mcp configure n8n ile açarsın.

Adım 4: Yeni bir Hermes oturumu başlat — araçlar ancak o zaman yüklenir.

Dikkat: activate / deactivate canlı n8n'inde gerçek değişiklik yapar. Yanlışlıkla kapattığın bir workflow, otomasyonunun durması demek. Bu araçları yalnızca gerçekten ihtiyacın varsa aç.

Hermes'in gücü sadece "sor, cevap versin" değil. Zamanlanmış iş çalıştırabildiği için n8n'ini otomatik izletebilirsin: her gece recent_failures'a bakan bir cron görevi kur, başarısız workflow varsa sabah raporlasın, yoksa sessiz kalsın.

İkisini Birlikte Kullan: İş Bölümü

Claude ve Hermes aynı işi yapmıyor; birbirini tamamlıyor.

• Claude → düzenle ve kur. Workflow kurmak, var olanı değiştirmek, hata ayıklamak Claude'un güçlü olduğu iş. MCP üzerinden workflow oluşturup düzenleyebiliyor.
• Hermes → izle ve otomatikleştir. Cron ile periyodik denetim, başarısız execution raporu, log takibi. Hermes'i arka planda çalıştırıp n8n'ini 7/24 izlettirebilirsin.

Örnek akış: Hermes gece başarısız bir workflow tespit eder, sabah raporlar → sen Claude'a "şu workflow neden başarısız olmuş, bul ve düzelt" dersin → Claude MCP üzerinden inceler, düzeltir, test eder. Paneli hiç açmadın.

Dikkat Edilecekler

• Least privilege: MCP'ye bütün workflow'ları açma. Yalnızca ajana gerçekten devretmek istediğinleri Available in MCP işaretle. Bu, göründüğünden önemli: erişim istemci başına ayrılmıyor. Bağladığın her istemci — Claude, ChatGPT, Cursor — MCP'ye açtığın workflow'ların hepsini görür. "Şu workflow'u yalnızca Claude görsün" diyemiyorsun. Bir istemciyi tamamen kesmek istersen Connected clients → View all altından erişimini iptal edebilirsin.
• Token güvenliği: API key ve MCP token'ını .env ya da Claude/Hermes config dosyasında tut; repository'ye veya chat'e yazma.
• Production tetikleme: execute_workflow yayındaki versiyonu çalıştırır. İlk denemelerde test ortamı kullan.
• HTTPS şart: n8n'in MCP sunucusu self-host'ta erişilebilir bir HTTPS domain ister. Düz IP üzerinden OAuth güvenilir çalışmaz.

Şimdi Ne Yaparsın

1. n8n'de Settings → Instance-level MCP aç, Enable MCP access ile MCP'yi etkinleştir.
2. Bir-iki workflow'u Available in MCP işaretle (hepsini değil).
3. Claude Desktop veya Claude Code ile bağlan, "workflow'larımı listele" de.
4. hermes mcp install n8n ile Hermes'i bağla, yeni oturum aç.
5. Hermes'e bir cron görevi kur: her sabah recent_failures'a baksın, boşsa sessiz kalsın.

n8n artık paneline tıklayarak yönettiğin bir araç değil; konuşarak ve otomatik olarak yönetilen bir katman.