Claude Code

Integración con Claude Code

Dé a Claude Code acceso web en vivo con CrawlForge MCP. Un solo comando claude mcp add registra el servidor para todos los proyectos, o un .mcp.json en el repositorio lo comparte con su equipo.

Requisitos previos

Claude Code

Instálelo desde code.claude.com

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.

Registrar el servidor en Claude Code

Elija su método de configuración preferido:

AOpción A: un comando, ámbito de usuario

Ejecútelo una vez y CrawlForge estará disponible en todos los proyectos:

Bash

claude mcp add crawlforge -s user -e CRAWLFORGE_API_KEY=cf_live_your_api_key_here -- npx -y crawlforge-mcp-server@latest mcp

-s user escribe la entrada en ~/.claude.json; omítalo para mantener el servidor local al proyecto actual. crawlforge init --client claude-code escribe la misma entrada por usted.

BOpción B: .mcp.json de proyecto

Cree .mcp.json en la raíz del repositorio para compartir el servidor con su equipo:

.mcp.jsonJson

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

No incluya una clave real en el repositorio: Claude Code expande ${CRAWLFORGE_API_KEY} desde el shell de cada desarrollador y pide a todos que aprueben un servidor de proyecto la primera vez que se carga.

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 comando y el JSON exactos para Claude 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

Inicie una nueva sesión de Claude Code y confirme que el servidor está conectado.

Bash

claude mcp list

Compruebe el estado — claude mcp list muestra cada servidor y si se conectó; /mcp dentro de una sesión muestra lo mismo
Reinicie si hace falta — un servidor nuevo lo detecta una sesión nueva, no una recargada
Pruebe un prompt — pruebe uno de los ejemplos a continuación; Claude 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 aparece en `claude mcp list`?

Vuelva a ejecutar el comando claude mcp add y compruebe en qué ámbito escribió
Asegúrese de que Node.js 18+ esté instalado: node --version
Un servidor de proyecto en .mcp.json necesita aprobación interactiva la primera vez
Inicie una sesión nueva: recargar la actual no es suficiente

¿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

¿Claude usa su fetch integrado en su lugar?

Agregue una línea a CLAUDE.md pidiendo a Claude que prefiera las herramientas de CrawlForge para el acceso web
Permita mcp__crawlforge__* en .claude/settings.json para evitar las solicitudes de permiso
Nombre la herramienta en el prompt ("usa scrape para…") cuando necesite anular su elección

¿Sigue teniendo problemas? Contacte con simon@crawlforge.dev indicando su versión de Claude Code, su versión de Node.js y la salida de claude mcp list.

¿Integración completada con éxito?

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

Ver todas las herramientas Guía para principiantes de Claude Code

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