Windsurf

Penyepaduan Windsurf

Beri Cascade, ejen Windsurf, akses web langsung dengan CrawlForge MCP. Satu entri mcpServers dalam ~/.codeium/windsurf/mcp_config.json menambah pelayan.

Prasyarat

Windsurf

Muat turun dari windsurf.com

Diperlukan

Node.js 18+

Pasang dari nodejs.org

Diperlukan

API Key

Dapatkan dari dashboard

Free

Dapatkan API Key CrawlForge

Konfigurasi di bawah memulakan pelayan melalui npx, jadi tiada pemasangan global diperlukan—hanya satu kunci.

Log masuk dari terminal: CLI membuka halaman pelayar tempat anda meluluskan kunci baharu, kemudian menyimpannya ke ~/.crawlforge/config.json.

Bash

npm install -g crawlforge-mcp-server
crawlforge login        # opens the browser approval page

Atau salin kunci daripada dashboard dan tampalkannya ke dalam konfigurasi pada langkah seterusnya.

Petua: Panduan CLI merangkumi crawlforge login dan cara pengesahan yang lain.

Konfigurasikan Windsurf

Pilih kaedah konfigurasi pilihan anda:

APilihan A: Edit mcp_config.json

Buka ~/.codeium/windsurf/mcp_config.json (%USERPROFILE%\.codeium\windsurf\mcp_config.json pada Windows) dan tambah pelayan:

~/.codeium/windsurf/mcp_config.jsonJson

{
  "mcpServers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

Simpan fail, kemudian tekan Refresh dalam panel MCPs supaya Cascade mengesan perubahan.

BPilihan B: Panel Cascade

Klik ikon MCPs dalam bar alat Cascade dan pilih Configure untuk membuka fail yang sama dalam penyunting; tampal entri di situ dan simpan.

Petua: Windsurf mengehadkan bilangan alat MCP yang aktif serentak, jadi kecilkan senarai dengan CRAWLFORGE_TOOL_GROUPS jika anda menjalankan beberapa pelayan.

Tetapkan API Key Anda

Gantikan cf_live_your_api_key_here dengan kunci anda, atau biarkan konfigurator mengisinya.

Jana konfigurasi ini dengan kunci anda: Konfigurator MCP mengisi kunci anda dan mengeluarkan JSON yang tepat untuk Windsurf.

Hadkan senarai alat (pilihan)

CrawlForge menyediakan 31 alat. Tetapkan CRAWLFORGE_TOOL_GROUPS dalam blok env yang sama untuk memuatkan hanya kumpulan yang anda perlukan, contohnya basic,search:

Json

"env": {
  "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here",
  "CRAWLFORGE_TOOL_GROUPS": "basic,search"
}

Kumpulan: basic, search, crawl, extract, batch, research, tracking, llmstxt, stealth, templates, scrape, agent.

Keselamatan: Jangan sekali-kali commit API key anda ke kawalan versi. Gunakan pemboleh ubah persekitaran atau fail konfigurasi.

Uji Penyepaduan

Buka Cascade dan sahkan pelayan sedang berjalan.

Buka Cascade — tekan Cmd+L / Ctrl+L
Semak pelayan — panel MCPs menyenaraikan crawlforge bersama alatnya sebaik sahaja ia bermula
Uji satu gesaan — cuba salah satu contoh di bawah; Cascade memilih alat CrawlForge sendiri

Contoh Gesaan

"Search for the latest AI news"

"Extract all links from example.com"

"Crawl the documentation site and summarize it"

"Extract product prices from this e-commerce site"

Lihat rujukan API penuh untuk kesemua 31 alat dan parameter mereka.

Penyelesaian Masalah

Pelayan tidak dimuatkan?

Semak mcp_config.json ialah JSON yang sah
Pastikan Node.js 18+ dipasang: node --version
Tekan Refresh dalam panel MCPs dan baca ralat yang ditunjukkan di sebelah pelayan
Mulakan semula Windsurf sepenuhnya

Ralat Pengesahan?

Semak API key bermula dengan cf_live_
Jalankan crawlforge login untuk menyimpan kunci baharu
Jana API key baharu daripada dashboard

Alat tidak muncul dalam Cascade?

Pastikan togol pelayan didayakan dalam panel MCPs
Lumpuhkan pelayan yang tidak anda gunakan—Windsurf mengehadkan bilangan alat MCP yang boleh aktif
Mulakan perbualan Cascade baharu

Masih menghadapi isu? Hubungi simon@crawlforge.dev dengan versi Windsurf, versi Node.js dan ralat yang ditunjukkan dalam panel MCPs anda.

Berjaya disepadukan?

Terokai semua alat yang tersedia, atau ikuti panduan langkah demi langkah untuk Windsurf.

Lihat Semua Alat Panduan Windsurf

{ "mcpServers": { "crawlforge": { "command": "npx", "args": [ "-y", "crawlforge-mcp-server@latest", "mcp" ], "env": { "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here" } } } }