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
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.
npm install -g crawlforge-mcp-server
crawlforge login # opens the browser approval pageO copie una clave desde el panel y péguela en la configuración del siguiente paso.
crawlforge login y las demás formas de autenticarse.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:
{
"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.
CRAWLFORGE_TOOL_GROUPS si ejecuta varios servidores.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:
"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.
- 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?
- Compruebe que
mcp_config.jsonsea JSON válido - Asegúrese de que Node.js 18+ esté instalado:
node --version - Pulse Refresh en el panel de MCPs y lea el error que aparece junto al servidor
- Reinicie Windsurf por completo
¿Errores de autenticación?
- Compruebe que la API key empiece con
cf_live_ - Ejecute
crawlforge loginpara guardar una clave nueva - Genere una nueva API key desde el panel
¿Las herramientas no aparecen en Cascade?
- Asegúrese de que el interruptor del servidor esté habilitado en el panel de MCPs
- Desactive los servidores que no use: Windsurf limita cuántas herramientas MCP pueden estar activas
- Inicie una nueva conversación de Cascade