VS Code

Penyepaduan VS Code

Beri mod ejen GitHub Copilot akses web langsung dengan CrawlForge MCP. .vscode/mcp.json dalam ruang kerja, atau mcp.json profil pengguna, menambah pelayan dalam satu blok.

Prasyarat

VS Code

Muat turun dari code.visualstudio.com dengan GitHub Copilot

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 VS Code

Pilih kaedah konfigurasi pilihan anda:

APilihan A: .vscode/mcp.json ruang kerja

Cipta .vscode/mcp.json di akar repo. VS Code menggunakan kunci servers dan medan type:

.vscode/mcp.jsonJson

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

Jika anda commit fail ini, jangan masukkan kunci: pemboleh ubah ${input:…} VS Code meminta setiap pembangun memasukkan nilai mereka sendiri.

BPilihan B: Profil pengguna

Jalankan MCP: Open User Configuration dari Command Palette (⇧⌘P / Ctrl+Shift+P) dan tambah entri servers yang sama; ia kemudian terpakai untuk setiap ruang kerja. MCP: Add Server membimbing anda melalui medan yang sama.

Gesaan kepercayaan: VS Code tidak mempercayai mcp.json ruang kerja secara automatik. Buka fail itu, terima pemberitahuan kepercayaan, kemudian muat semula tetingkap.

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 VS 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

Buka Copilot Chat dalam mod Agent dan sahkan pelayan sedang berjalan.

Buka Copilot Chat — tekan Ctrl+Alt+I (⌃⌘I pada macOS) dan tukar pemilih mod kepada Agent
Semak pelayan — jalankan MCP: List Servers dari Command Palette; crawlforge sepatutnya ditunjukkan sedang berjalan
Uji satu gesaan — cuba salah satu contoh di bawah; ejen 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 bermula?

Semak .vscode/mcp.json ialah JSON yang sah
Pastikan Node.js 18+ dipasang: node --version
Jalankan MCP: List Servers, pilih crawlforge dan buka outputnya untuk melihat ralat
Muat semula tetingkap selepas mengedit fail

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 sembang?

Pastikan Copilot Chat berada dalam mod Agent—mod Ask tidak memanggil alat
Klik ikon alat dalam kotak input sembang dan dayakan alat crawlforge
Mulakan semula VS Code sepenuhnya

Masih menghadapi isu? Hubungi simon@crawlforge.dev dengan versi VS Code, versi Node.js dan output pelayan daripada MCP: List Servers anda.

Berjaya disepadukan?

Terokai semua alat yang tersedia, atau ikuti panduan langkah demi langkah untuk mod ejen Copilot.

Lihat Semua Alat Panduan Ejen Copilot

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