Claude Code

Penyepaduan Claude Code

Beri Claude Code akses web langsung dengan CrawlForge MCP. Satu arahan claude mcp add mendaftarkan pelayan untuk setiap projek, atau .mcp.json dalam repo berkongsinya dengan pasukan anda.

Prasyarat

Claude Code

Pasang dari code.claude.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.

Daftarkan Pelayan dengan Claude Code

Pilih kaedah konfigurasi pilihan anda:

APilihan A: Satu arahan, skop pengguna

Jalankan sekali dan CrawlForge tersedia dalam setiap projek:

Bash

claude mcp add crawlforge -s user -e CRAWLFORGE_API_KEY=cf_live_your_api_key_here -- npx -y crawlforge-mcp-server@latest mcp

-s user menulis entri ke ~/.claude.json; gugurkannya untuk mengekalkan pelayan setempat kepada projek semasa. crawlforge init --client claude-code menulis entri yang sama untuk anda.

BPilihan B: .mcp.json projek

Cipta .mcp.json di akar repo untuk berkongsi pelayan dengan pasukan anda:

.mcp.jsonJson

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

Jangan commit kunci sebenar: Claude Code mengembangkan ${CRAWLFORGE_API_KEY} daripada shell setiap pembangun, dan meminta semua orang meluluskan pelayan projek pada kali pertama ia dimuatkan.

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 arahan serta JSON yang tepat untuk Claude Code.

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

Mulakan sesi Claude Code baharu dan sahkan pelayan telah bersambung.

Bash

claude mcp list

Semak status — claude mcp list menunjukkan setiap pelayan dan sama ada ia bersambung; /mcp di dalam sesi menunjukkan perkara yang sama
Mulakan semula jika perlu — pelayan baharu dikesan oleh sesi baharu, bukan sesi yang dimuat semula
Uji satu gesaan — cuba salah satu contoh di bawah; Claude 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 tiada dalam `claude mcp list`?

Jalankan semula arahan claude mcp add dan semak skop yang ditulisnya
Pastikan Node.js 18+ dipasang: node --version
Pelayan projek dalam .mcp.json memerlukan kelulusan interaktif pada kali pertama
Mulakan sesi baharu—memuat semula sesi semasa tidak mencukupi

Ralat Pengesahan?

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

Claude menggunakan fetch terbina dalamnya?

Tambah satu baris pada CLAUDE.md meminta Claude mengutamakan alat CrawlForge untuk akses web
Benarkan mcp__crawlforge__* dalam .claude/settings.json untuk menghentikan gesaan kebenaran
Namakan alat dalam gesaan ("gunakan scrape untuk…") apabila anda perlu mengatasi pilihannya

Masih menghadapi isu? Hubungi simon@crawlforge.dev dengan versi Claude Code, versi Node.js dan output claude mcp list anda.

Berjaya disepadukan?

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

Lihat Semua Alat Panduan Pemula Claude Code

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