Saltar al contenido
Zed

Integración con Zed

Dé al panel Agent de Zed acceso web en vivo con CrawlForge MCP. Zed llama a los servidores MCP context servers; un solo bloque context_servers en settings.json agrega CrawlForge.

Requisitos previos

Zed
Descárguelo desde zed.dev

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 Zed
Elija su método de configuración preferido:

AOpción A: editar settings.json

Abra su configuración con zed: open settings file (o Cmd+, / Ctrl+,) y agregue un bloque context_servers:

~/.config/zed/settings.jsonJson
{
  "context_servers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

Zed lee ~/.config/zed/settings.json en macOS y Linux; un .zed/settings.json en un proyecto limita el servidor a ese repositorio.

BOpción B: interfaz de configuración

Vaya a Settings → AI → MCP Servers, haga clic en Add Server → Add Local Server e introduzca el mismo comando, args y env. Zed escribe la entrada en settings.json por usted.

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 el panel Agent y confirme que el servidor está en ejecución.
  • Abra el panel Agent — haga clic en el icono de Agent en la barra de estado
  • Compruebe el servidor — Settings → AI → MCP Servers muestra crawlforge con estado verde una vez que arranca
  • 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 se carga?

  1. Compruebe que settings.json sea JSON válido
  2. Asegúrese de que Node.js 18+ esté instalado: node --version
  3. Busque errores de context_servers en ~/.config/zed/logs/Zed.log
  4. Reinicie Zed 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 se ofrecen en el panel Agent?

  1. Habilite las herramientas del servidor en su perfil de agente en Settings → AI → MCP Servers
  2. Compruebe que el servidor aparezca en ejecución antes de enviar un prompt
  3. Inicie un hilo nuevo después de cambiar la configuración

¿Integración completada con éxito?

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