Learning Timeline
Key Insights
Keselamatan API Key
Jangan sekali-kali berkongsi API key n8n anda dengan sesiapa. Sesiapa yang mempunyai akses kepada key ini boleh mengawal akaun n8n anda sepenuhnya.
Langkah Restart Wajib
Claude Desktop tidak akan mengesan perubahan pada fail konfigurasi secara automatik. Anda mesti 'Quit' aplikasi sepenuhnya (bukan sekadar tutup window) dan buka semula.
Full Configuration vs Basic
Gunakan 'Full Configuration' jika anda mahu Claude membantu debug execution atau mencipta workflow secara terus dalam instance n8n anda, bukan sekadar menjana kod.
Step by Step
Penyediaan Awal: Claude Desktop & Node.js
- Muat turun dan pasang Claude Desktop dari laman web rasmi Claude.
- Log masuk menggunakan akaun sedia ada atau cipta akaun percuma baru.
- Layari laman web Node.js dan pilih versi yang sesuai dengan sistem operasi anda (Windows atau Mac).
- Muat turun installer Node.js dan ikuti arahan pemasangan (prompts) sehingga selesai.
- Pastikan Node.js telah dipasang dengan betul sebelum meneruskan ke langkah seterusnya.
Menjalankan n8n MCP Server
- Buka aplikasi 'Terminal' jika anda menggunakan Mac, atau 'Command Prompt' jika anda menggunakan Windows.
- Salin dan tampal command: `npx n8n-mcp` ke dalam terminal.
- Tekan 'Enter' untuk menjalankan command tersebut.
- Jika ini kali pertama anda menjalankannya, terminal akan bertanya sama ada anda mahu memasang package tersebut. Tekan kekunci 'y' dan 'Enter' untuk setuju.
- Pastikan terminal menunjukkan bahawa n8n MCP server sedang berjalan (running).
Konfigurasi Claude Desktop Config File
- Buka aplikasi Claude Desktop.
- Klik pada ikon profil atau tetapan, kemudian cari bahagian 'Local MCP Servers'.
- Klik butang 'Edit Config'. Ini akan membuka folder di komputer anda di mana fail `claude_desktop_config.json` berada.
- Buka fail `claude_desktop_config.json` tersebut menggunakan code editor (seperti VS Code) atau text editor biasa (seperti Notepad/TextEdit).
- Salin blok kod konfigurasi MCP (Full Configuration) dan tampal ke dalam fail JSON tersebut.
Penyambungan API n8n ke Claude
- Buka instance n8n anda di browser.
- Salin URL n8n anda bermula dari 'https://' sehingga '.cloud' (atau domain host anda) dan tampal ke dalam bahagian URL di fail config tadi.
- Di n8n, klik pada menu 'Settings' di bahagian bawah sebelah nama akaun anda.
- Pilih 'n8n API' di bar sisi sebelah kiri.
- Klik 'Create a new API key', beri nama (contoh: 'n8n MCP Demo'), dan klik 'Create'.
- Salin API key yang dijana dan tampal ke dalam bahagian API Key di fail `claude_desktop_config.json` anda.
- Simpan (Save) fail konfigurasi tersebut.
- Tutup (Quit) aplikasi Claude Desktop sepenuhnya dan buka semula untuk membolehkan Claude membaca konfigurasi baru.
- Klik pada ikon 'Search and tools' (ikon tukul/search) di Claude untuk memastikan MCP server telah aktif.
