Pernahkah Anda berharap bisa cukup memberi tahu AI untuk membangun alur kerja otomatisasi dan melihatnya siap di n8n? Bagaimana jika asisten AI Anda bisa langsung membuat, memperbarui, dan mengeksekusi alur kerja n8n tanpa perlu menyalin JSON atau menyeret node secara manual? Selamat datang di n8n-MCP with Claude Code, sistem yang mengubah bahasa alami menjadi otomatisasi alur kerja yang nyata dan dapat diimplementasikan.
Apa Itu n8n-MCP dan Mengapa Anda Harus Peduli?
n8n-MCP adalah server Model Context Protocol yang mengekspos alur kerja n8n Anda sebagai alat yang dapat dieksekusi untuk asisten AI seperti Claude Code. Daripada menjalankan alur kerja secara manual melalui UI n8n atau REST API, Anda menjelaskan apa yang Anda inginkan dalam bahasa alami, dan Claude Code akan memanggil alur kerja yang tepat, meneruskan parameter, dan mengembalikan hasilnya.
Pergeseran ini halus tetapi besar. Asisten pengkodean AI tradisional menghasilkan kode. Dengan n8n-MCP, mereka mengeksekusi alur kerja. Alur kerja pencarian web Anda menjadi alat. Pipeline pengayaan data Anda menjadi alat. Alur notifikasi Slack Anda menjadi alat. Claude Code menjadi agen yang mengatur sistem nyata, bukan hanya pembuat kode.
Bagi pengembang yang membangun alat internal atau mengotomatisasi penelitian, ini berarti Anda dapat:
- Mengkueri API langsung tanpa menulis panggilan `fetch`
- Memicu pipeline data dari editor Anda
- Memvalidasi data eksternal sebelum melakukan `commit` kode
- Membangun agen kustom yang disesuaikan dengan `stack` Anda
Protokolnya sederhana: n8n-MCP menerjemahkan panggilan alat Claude Code menjadi permintaan HTTP ke node `webhook` n8n Anda, lalu mengatur respons kembali ke Claude. Anda mendapatkan kekuatan penuh dari 400+ integrasi n8n di dalam alur kerja CLI Anda.
Ingin platform All-in-One yang terintegrasi agar Tim Pengembang Anda dapat bekerja sama dengan produktivitas maksimum?
Apidog memenuhi semua permintaan Anda, dan menggantikan Postman dengan harga yang jauh lebih terjangkau!
Langkah 1: Instal n8n dan Buat Alur Kerja Pencarian Web
Pertama, Anda memerlukan instance n8n yang berjalan. Untuk pengembangan lokal, Docker adalah yang tercepat.
# Buat direktori untuk data n8n
mkdir ~/n8n-data && cd ~/n8n-data
# Mulai n8n dengan Docker
docker run -d --name n8n \
-p 5678:5678 \
-v $(pwd):/home/node/.n8n \
--restart unless-stopped \
docker.n8n.io/n8nio/n8n
Buka http://localhost:5678 dan selesaikan penyiapan. Buat akun admin.
Bangun Alur Kerja Pencarian Web
- Klik New Workflow (Alur Kerja Baru)
- Tambahkan node Webhook (pemicu)
- Metode HTTP:
POST - Jalur:
web-search - Mode Respons:
When Last Node Finishes(Saat Node Terakhir Selesai)
3. Tambahkan node HTTP Request (Permintaan HTTP)
- URL:
https://duckduckgo.com/html/?q={{ $json.query }} - Metode:
GET
4. Tambahkan node HTML Extract (Ekstrak HTML)
- Properti Data:
data - Nilai Ekstraksi:
- Kunci:
results - Pemilih CSS:
.result__a - Nilai Kembali:
Text(Teks)
5. Tambahkan node Set (Atur) untuk memformat keluaran
- Nilai yang Akan Diatur:
results:{{ $json.results }}
6. Hubungkan webhook → HTTP → HTML Extract → Set
7. Aktifkan alur kerja (tombol di kanan atas)
Uji secara manual:
curl -X POST http://localhost:5678/webhook/web-search \
-H "Content-Type: application/json" \
-d '{"query":"trending AI topics 2026"}'
Anda akan melihat array JSON dari hasil pencarian. Alur kerja ini sekarang siap untuk eksposur MCP.
Langkah 2: Instal dan Konfigurasi n8n-MCP
Server n8n MCP menjembatani n8n dan Claude Code. Instal secara global atau di direktori proyek.
# Kloning repositori n8n-MCP
git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
# Instal dependensi
npm install
# Bangun proyek
npm run build
Konfigurasi Variabel Lingkungan
Buat file .env di direktori n8n-MCP:
# .env
N8N_API_URL=http://localhost:5678
N8N_API_KEY=n8n_api_key_here
Dapatkan kunci API n8n Anda dari Settings → API (Pengaturan → API) di UI n8n. Jika Anda tidak melihat bagian kunci API, Anda mungkin perlu mengaktifkannya melalui variabel lingkungan saat memulai n8n:
# Hentikan dan mulai ulang n8n dengan API diaktifkan
docker stop n8n
docker rm n8n
docker run -d --name n8n \
-p 5678:5678 \
-v $(pwd):/home/node/.n8n \
-e N8N_BASIC_AUTH_ACTIVE=true \
-e N8N_BASIC_AUTH_USER=admin \
-e N8N_BASIC_AUTH_PASSWORD=yourpassword \
--restart unless-stopped \
docker.n8n.io/n8nio/n8n
Sekarang hasilkan kunci API di UI.
Mulai Server MCP
# Mulai server MCP
npm start
Secara default, ini berjalan di http://localhost:3001. Anda akan melihat:
n8n MCP Server running on http://localhost:3001
Available tools: [ 'web-search' ]
Server secara otomatis menemukan alur kerja dengan jalur `webhook` dan mengeksposnya sebagai alat.
Langkah 3: Konfigurasi Claude Code untuk Menggunakan n8n-MCP
Claude Code menggunakan file konfigurasi untuk menemukan alat MCP. Buat atau edit konfigurasi Claude Code Anda.
# Temukan direktori konfigurasi Claude Code
# macOS: ~/Library/Application Support/Claude Code
# Linux: ~/.config/Claude Code
# Windows: %APPDATA%/Claude Code
cd ~/Library/Application\ Support/Claude Code
Buat file bernama mcp.json:
{
"mcpServers": {
"n8n": {
"command": "node",
"args": ["/path/to/n8n-mcp/dist/index.js"],
"env": {
"N8N_API_URL": "http://localhost:5678",
"N8N_API_KEY": "your_n8n_api_key"
}
}
}
}
Penting: Gunakan jalur absolut untuk args. Jalur relatif akan gagal saat Claude Code membuat proses.
Verifikasi Koneksi
Mulai Claude Code di proyek Anda:
claude
Setelah dimuat, ketik:
/list-tools
Anda akan melihat:
Available tools:
- n8n:web-search (Menjalankan alur kerja pencarian web)
Jika alat tidak muncul, periksa log:
# Di terminal lain, ikuti log Claude Code
tail -f ~/Library/Application\ Support/Claude\ Code/logs/mcp.log
Masalah umum:
- ENOENT: Jalur yang salah ke
n8n-mcp/dist/index.js - ECONNREFUSED: n8n tidak berjalan di localhost:5678
- 401: N8N_API_KEY salah
Langkah 4: Aplikasi Praktis—Pencarian Web dari Claude Code
Sekarang keajaiban terjadi. Di direktori proyek mana pun, mulai Claude Code dan jalankan:
claude
Pada `prompt`, ketik:
Using the web search tool in n8n, look up trending AI topics in 2026
Claude Code akan:
- Mengenali alat
n8n:web-search - Mengurai maksud Anda ("topik AI yang sedang tren di tahun 2026")
- Mengekstrak parameter kueri
- Memanggil server MCP
- Server MCP memanggil `webhook` n8n
- n8n menjalankan alur kerja dan mengembalikan hasil
- MCP mengembalikan JSON ke Claude Code
- Claude Code memformat dan menampilkan jawabannya
Sesi Contoh
$ claude
> Menggunakan alat pencarian web di n8n, cari topik AI yang sedang tren di tahun 2026
Saya akan membantu Anda mencari topik AI yang sedang tren di tahun 2026 menggunakan alat pencarian web n8n.
Memanggil n8n:web-search dengan kueri: "trending AI topics 2026"
Alat mengembalikan 8 hasil:
1. "Terobosan AI Kuantum di Tahun 2026: Yang Perlu Diketahui Pengembang"
2. "LLM Multimodal: Melampaui Teks dan Gambar"
3. "Implementasi AI Tepi: Mengurangi Biaya Cloud sebesar 40%"
4. "Agen Peninjau Kode AI: Lonjakan Adopsi di Perusahaan"
5. "Pembelajaran Federasi: Pelatihan AI yang Mengutamakan Privasi"
6. "Pembuatan Data Sintetis: Perdebatan Kualitas vs. Kuantitas"
7. "Deteksi Halusinasi AI: Alat Sumber Terbuka Baru"
8. "Komputasi Neuromorfik: Tren Desain Bersama Perangkat Keras-Perangkat Lunak"
Berdasarkan hasil ini, berikut adalah topik AI utama yang sedang tren di tahun 2026:
- Integrasi AI kuantum menjadi praktis bagi pengembang
- Model multimodal meluas melampaui teks/gambar ke audio/video
- Implementasi AI tepi untuk pengurangan biaya
- Agen AI untuk peninjauan kode mendapatkan daya tarik di perusahaan
- Pembelajaran federasi yang menjaga privasi
- Pipeline data sintetis
- Alat deteksi halusinasi
- Kemajuan perangkat keras neuromorfik
Sementara itu, di UI n8n Anda, Anda akan melihat eksekusi alur kerja muncul secara `real-time`, membuktikan bahwa Claude Code memicunya dari jarak jauh.
Pola Lanjutan: Membangun Alur Kerja Agen
Pola 1: Memperkaya Data dari Berbagai Sumber
Buat alur kerja yang mengambil pengguna GitHub, lalu mencari tweet terbaru mereka:
- Node Webhook (
enrich-user) - Permintaan HTTP → GitHub API (
/users/{{ $json.username }}) - Permintaan HTTP → X API (
/users/by/username/{{ $json.username }}) - Node Gabung (menggabungkan respons)
- Node Set (memformat objek akhir)
Sekarang di Claude Code:
Enrich user profile for @johndoe using the enrich-user workflow
Claude secara otomatis meneruskan parameter dan menerima data terstruktur.
Pola 2: Pemilihan Alat Bersyarat
Bangun beberapa alur kerja dan biarkan Claude memilih:
web-search-duckduckgo: Gratis tapi lebih lambatweb-search-serpapi: Berbayar tapi terstrukturweb-search-google: Scraper kustom
Di `prompt` Anda:
Search for Python async patterns. Use the fastest web search tool available.
Claude membaca deskripsi alat dan memilih berdasarkan instruksi Anda.
Pola 3: Merangkai Alur Kerja
Keluaran satu alur kerja dapat memicu alur kerja lain. Buat:
fetch-data: Mendapatkan data mentahanalyze-data: Menerima data, menjalankan analisissummarize-data: Menerima analisis, menghasilkan ringkasan
Di Claude Code:
Fetch sales data, analyze Q1 trends, and summarize key insights
Claude akan merangkai ketiga alur kerja secara berurutan, meneruskan keluaran di antara mereka.
Jangan Lupa Mengamankan `Webhook` Anda
Tambahkan header autentikasi di n8n:
- Edit node Webhook
- Atur Authentication (Autentikasi):
Header Auth - Nama:
X-API-Key - Nilai:
your-secure-webhook-secret
Perbarui .env untuk n8n-MCP:
N8N_WEBHOOK_SECRET=your-secure-webhook-secret
Modifikasi server MCP untuk meneruskan header (Anda perlu mengedit src/index.ts):
// Dalam fungsi eksekusi alat
const response = await fetch(webhookUrl, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.N8N_WEBHOOK_SECRET
},
body: JSON.stringify(parameters)
});
Pembatasan Tingkat (`Rate Limiting`)
Tambahkan lapisan `cache` Redis untuk mencegah penyalahgunaan:
// Di n8n-MCP, sebelum memanggil webhook
import Redis from 'ioredis';
const redis = new Redis();
const rateLimitKey = `rate_limit:${toolName}:${Date.now() / 60000}`;
const count = await redis.incr(rateLimitKey);
if (count > 10) { // 10 panggilan per menit
throw new Error('Rate limit exceeded');
}
await redis.expire(rateLimitKey, 60);
Penanganan Kesalahan
Sempurnakan server MCP untuk mengembalikan kesalahan terstruktur:
try {
const response = await fetch(webhookUrl, {...});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
return await response.json();
} catch (error) {
return {
error: error.message,
status: 'failed'
};
}
Claude Code akan menampilkan kesalahan dan dapat mencoba lagi secara otomatis.
Kesimpulan
n8n-MCP mengubah n8n dari alat otomatisasi manual menjadi `backend` agen yang dapat diprogram untuk Claude Code. Anda membangun alur kerja secara visual, mengeksposnya sebagai alat, dan mengatur tugas-tugas kompleks dengan bahasa alami. Penyiapannya mudah: instal n8n, buat alur kerja `webhook`, jalankan server MCP, dan konfigurasikan Claude Code. Hasilnya adalah agen AI kustom yang mengetahui `stack` Anda dan dapat menjalankan tugas dunia nyata. Dan ketika Anda membangun API dalam alur kerja tersebut, uji dengan Apidog—karena bahkan agen AI pun membutuhkan kontrak yang andal.