VS Code

Integración con VS Code

Dé al modo agente de GitHub Copilot acceso web en vivo con CrawlForge MCP. Un .vscode/mcp.json en el espacio de trabajo, o el mcp.json del perfil de usuario, agrega el servidor en un solo bloque.

Requisitos previos

VS Code

Descárguelo desde code.visualstudio.com con GitHub Copilot

Requerido

Node.js 18+

Instálelo desde nodejs.org

Requerido

API Key

Obténgala desde el panel

Free

Obtener una API key de CrawlForge

La configuración de abajo inicia el servidor mediante npx, así que no hace falta ninguna instalación global: solo una clave.

Inicie sesión desde la terminal: el CLI abre una página del navegador donde usted aprueba una clave nueva y luego la guarda en ~/.crawlforge/config.json.

Bash

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

O copie una clave desde el panel y péguela en la configuración del siguiente paso.

Consejo: La guía del CLI explica crawlforge login y las demás formas de autenticarse.

Configurar VS Code

Elija su método de configuración preferido:

AOpción A: .vscode/mcp.json del espacio de trabajo

Cree .vscode/mcp.json en la raíz del repositorio. VS Code usa una clave servers y un campo 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"
      }
    }
  }
}

Si incluye el archivo en el repositorio, deje la clave fuera: las variables ${input:…} de VS Code piden a cada desarrollador su propio valor.

BOpción B: perfil de usuario

Ejecute MCP: Open User Configuration desde la paleta de comandos (⇧⌘P / Ctrl+Shift+P) y agregue la misma entrada servers; se aplicará a todos los espacios de trabajo. MCP: Add Server le guía por los mismos campos.

Aviso de confianza: VS Code no confía automáticamente en un mcp.json del espacio de trabajo. Abra el archivo, acepte la notificación de confianza y recargue la ventana.

Configurar su API key

Sustituya cf_live_your_api_key_here por su clave, o deje que el configurador la rellene.

Genere esta configuración con su clave: El configurador MCP rellena su clave y genera el JSON exacto para VS Code.

Limitar la lista de herramientas (opcional)

CrawlForge incluye 31 herramientas. Defina CRAWLFORGE_TOOL_GROUPS en el mismo bloque env para cargar solo los grupos que necesite, por ejemplo basic,search:

Json

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

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

Seguridad: Nunca incluya su API key en el control de versiones. Use variables de entorno o el archivo de configuración.

Probar la integración

Abra Copilot Chat en modo Agent y confirme que el servidor está en ejecución.

Abra Copilot Chat — presione Ctrl+Alt+I (⌃⌘I en macOS) y cambie el selector de modo a Agent
Compruebe el servidor — ejecute MCP: List Servers desde la paleta de comandos; crawlforge debería aparecer en ejecución
Pruebe un prompt — pruebe uno de los ejemplos a continuación; el agente elige la herramienta de CrawlForge por sí mismo

Ejemplos de prompts

"Busca las últimas noticias sobre IA"

"Extrae todos los enlaces de example.com"

"Rastrea el sitio de documentación y resúmelo"

"Extrae los precios de productos de este sitio de comercio electrónico"

Consulte la referencia de la API completa para ver las 31 herramientas y sus parámetros.

Solución de problemas

¿El servidor no arranca?

Compruebe que .vscode/mcp.json sea JSON válido
Asegúrese de que Node.js 18+ esté instalado: node --version
Ejecute MCP: List Servers, seleccione crawlforge y abra su salida para ver el error
Recargue la ventana después de editar el archivo

¿Errores de autenticación?

Compruebe que la API key empiece con cf_live_
Ejecute crawlforge login para guardar una clave nueva
Genere una nueva API key desde el panel

¿Las herramientas no aparecen en el chat?

Asegúrese de que Copilot Chat esté en modo Agent: el modo Ask no llama a herramientas
Haga clic en el icono de herramientas del cuadro de chat y habilite las herramientas de crawlforge
Reinicie VS Code por completo

¿Sigue teniendo problemas? Contacte con simon@crawlforge.dev indicando su versión de VS Code, su versión de Node.js y la salida del servidor en MCP: List Servers.

¿Integración completada con éxito?

Explore todas las herramientas disponibles o siga la guía paso a paso para el modo agente de Copilot.

Ver todas las herramientas Guía del agente de Copilot

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