Saltar al contenido
Windsurf

Integración con Windsurf

Dé a Cascade, el agente de Windsurf, acceso web en vivo con CrawlForge MCP. Una sola entrada mcpServers en ~/.codeium/windsurf/mcp_config.json agrega el servidor.

Requisitos previos

Windsurf
Descárguelo desde windsurf.com

Requerido

Node.js 18+
Instálelo desde nodejs.org

Requerido

API Key
Obténgala desde el panel

Free

1
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.

2
Configurar Windsurf
Elija su método de configuración preferido:

AOpción A: editar mcp_config.json

Abra ~/.codeium/windsurf/mcp_config.json (%USERPROFILE%\.codeium\windsurf\mcp_config.json en Windows) y agregue el servidor:

~/.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"
      }
    }
  }
}

Guarde el archivo y pulse Refresh en el panel de MCPs para que Cascade detecte el cambio.

BOpción B: panel de Cascade

Haga clic en el icono MCPs de la barra de herramientas de Cascade y elija Configure para abrir el mismo archivo en el editor; pegue ahí la entrada y guarde.

3
Configurar su API key
Sustituya cf_live_your_api_key_here por su clave, o deje que el configurador la rellene.

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.

4
Probar la integración
Abra Cascade y confirme que el servidor está en ejecución.
  • Abra Cascade — presione Cmd+L / Ctrl+L
  • Compruebe el servidor — el panel MCPs muestra crawlforge con sus herramientas una vez que arranca
  • Pruebe un prompt — pruebe uno de los ejemplos a continuación; Cascade 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 se carga?

  1. Compruebe que mcp_config.json sea JSON válido
  2. Asegúrese de que Node.js 18+ esté instalado: node --version
  3. Pulse Refresh en el panel de MCPs y lea el error que aparece junto al servidor
  4. Reinicie Windsurf por completo

¿Errores de autenticación?

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

¿Las herramientas no aparecen en Cascade?

  1. Asegúrese de que el interruptor del servidor esté habilitado en el panel de MCPs
  2. Desactive los servidores que no use: Windsurf limita cuántas herramientas MCP pueden estar activas
  3. Inicie una nueva conversación de Cascade

¿Integración completada con éxito?

Explore todas las herramientas disponibles o siga la guía paso a paso para Windsurf.