🔥 Servidor MCP de Firecrawl

Opera un Firecrawl autohospedado desde Claude mediante MCP.

LP: daisukehori.github.io/firecrawl-mcp

Puedes operar Firecrawl autohospedado directamente desde Claude.ai / Claude Desktop / Claude Code a través de MCP (Protocolo de Contexto de Modelo).

Incluye 11 herramientas para búsqueda web, scraping individual/por lotes, rastreo de sitios, obtención de mapas de sitio y extracción estructurada mediante LLM.

Arquitectura

Claude.ai ──MCP──▶ Vercel (firecrawl-mcp)
                        │
                        ▼
               Firecrawl (self-hosted)
               your-firecrawl.example.com

Una aplicación Next.js en Vercel procesa el protocolo MCP y lo retransmite a la API de Firecrawl autohospedada. El servidor es sin estado (stateless) y no realiza almacenamiento de datos ni registro de logs.

Related MCP server: Firecrawl MCP Server

Lista de herramientas (11 herramientas)

Scraping

Rastreo (Crawl)

Búsqueda, Mapeo y Extracción

Inicio rápido (3 pasos)

Paso 1: Preparar Firecrawl autohospedado

Inicia Firecrawl siguiendo la guía de autohospedaje de Firecrawl.

git clone https://github.com/mendableai/firecrawl.git
cd firecrawl
docker compose up -d

Se inicia por defecto en http://localhost:3002.

Paso 2: Desplegar el servidor MCP

Despliegue con un clic (recomendado)

Despliegue manual

git clone https://github.com/DaisukeHori/firecrawl-mcp.git
cd firecrawl-mcp
cp .env.example .env.local
# .env.local を編集
npm install
npm run dev

Paso 3: Conectar desde Claude

Claude.ai (Web): Settings → MCP → Add:

• URL: https://your-firecrawl-mcp.vercel.app/api/mcp

• Nombre del encabezado: x-api-key Valor: tu_MCP_API_KEY

Claude Desktop / Cursor / VS Code / Windsurf:

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-firecrawl-mcp.vercel.app/api/mcp"],
      "env": {
        "HEADER_x-api-key": "あなたのMCP_API_KEY"
      }
    }
  }
}

Claude Code:

claude mcp add --transport http firecrawl https://your-firecrawl-mcp.vercel.app/api/mcp \
  --header "x-api-key: あなたのMCP_API_KEY"

Variables de entorno

Ejemplos de uso

ユーザー: 「docs.firecrawl.dev の全ページをMarkdownで取得して」

AI: まずサイトマップを確認します。
    [firecrawl_map] → 47ページ検出
    
    クロールジョブを開始します。
    [firecrawl_crawl] → ジョブID: abc-123
    
    ... ステータス確認中 ...
    
    ✅ 47ページ全て取得完了しました。

ユーザー: 「この3つのURLから商品名と価格を抽出して」

AI: [firecrawl_extract]
    ✅ 構造化データ:
    {"name": "Product A", "price": 2980}
    {"name": "Product B", "price": 4980}
    {"name": "Product C", "price": 7980}

🔒 Seguridad

• Todas las comunicaciones están protegidas por HTTPS (cifrado TLS)

• El servidor es sin estado. La URL de Firecrawl y la clave API se guardan en las variables de entorno de Vercel y solo se usan durante la solicitud

• El servidor no tiene base de datos. Solo actúa como proxy hacia la API de Firecrawl

• El código fuente es totalmente público

• Se evita el acceso no autorizado mediante MCP_API_KEY

Preguntas frecuentes

P: ¿Se puede usar con la versión en la nube de Firecrawl? → Sí. Configura FIRECRAWL_API_URL=https://api.firecrawl.dev e introduce la clave API de la nube en FIRECRAWL_API_KEY.

P: La herramienta extract no funciona → En la versión autohospedada, se requiere una configuración de LLM como OPENAI_API_KEY en el lado de Firecrawl. Consulta la guía de autohospedaje.

P: El estado del scraping/rastreo por lotes se queda en scraping → En la versión autohospedada, hay un retraso de unos segundos en la transición de estado. Tras 2 o 3 sondeos (polling), cambiará a completed. Este es un comportamiento conocido.

P: ¿Qué versión de Firecrawl se necesita? → Versión compatible con la API v1 (punto final /v1/). No habrá problemas si usas la última versión con Docker Compose.

P: ¿Cuál es la diferencia con HubSpot MA MCP? → HubSpot MA MCP es para operar HubSpot CRM/MA (128 herramientas). Firecrawl MCP es para scraping/rastreo web (11 herramientas). Como sus usos son diferentes, pueden utilizarse conjuntamente.

Stack tecnológico

Next.js 15 / TypeScript / MCP SDK / Vercel / Zod

Licencia

Licencia MIT

Servidores MCP relacionados

Conjunto de servidores MCP publicados por Hori. Todos pueden utilizarse desde clientes MCP como Claude.ai / Cursor / ChatGPT, etc.