Firecrawl MCP

firecrawl/firecrawl-mcp-server· Проверено 12.11.2026· 7,8 тыс.на GitHub

Подключает агента к Firecrawl: искать в интернете, превращать страницы и PDF в чистый Markdown, обходить сайты целиком и кликать по динамическим страницам в настоящем браузере.

2 реализации:

Сервер на стороне Firecrawl, ставить ничего не нужно. Без ключа доступны только scrape, search и parse с ограничением частоты.

Как подключить

Что сделать до подключения

Ключ API Firecrawl для полного набора инструментов; для входа через аккаунт есть адрес https://mcp.firecrawl.dev/v2/mcp-oauth

FIRECRAWL_API_KEY

firecrawl.dev → зарегистрироваться → раздел app/api-keys; ключ начинается с fc-

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp \
  --header 'Authorization: Bearer <ключ Firecrawl>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.firecrawl]
url = "https://mcp.firecrawl.dev/v2/mcp"
http_headers = { "Authorization" = "Bearer <ключ Firecrawl>" }

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Firecrawl>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Firecrawl>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "firecrawl": {
      "httpUrl": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Firecrawl>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "firecrawl": {
      "httpUrl": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Firecrawl>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "firecrawl": {
        "type": "remote",
        "url": "https://mcp.firecrawl.dev/v2/mcp",
        "headers": {
          "Authorization": "Bearer <ключ Firecrawl>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.firecrawl.dev/v2/mcp
Request headers: Authorization: Bearer <ключ Firecrawl>

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer <ключ Firecrawl>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

firecrawl_scrapeпревращает страницу в Markdown

firecrawl_searchищет в интернете

firecrawl_parseразбирает PDF и документы

Запускается у вас через npx и ходит в облако Firecrawl по ключу; через FIRECRAWL_API_URL работает со своей установкой Firecrawl.

Как подключить

Что сделать до подключения

Node.js с командой npx

Ключ API Firecrawl; для своей установки — адрес в FIRECRAWL_API_URL

FIRECRAWL_API_KEY

firecrawl.dev → зарегистрироваться → раздел app/api-keys

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'FIRECRAWL_API_KEY=fc-<ваш ключ>' --transport stdio firecrawl-mcp-server \
  -- npx -y firecrawl-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.firecrawl-mcp-server]
command = "npx"
args = ["-y", "firecrawl-mcp"]

[mcp_servers.firecrawl-mcp-server.env]
FIRECRAWL_API_KEY = "fc-<ваш ключ>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "firecrawl-mcp-server": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-<ваш ключ>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "firecrawl-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-<ваш ключ>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "firecrawl-mcp-server": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-<ваш ключ>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "firecrawl-mcp-server": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-<ваш ключ>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "firecrawl-mcp-server": {
        "type": "local",
        "command": ["npx", "-y", "firecrawl-mcp"],
        "environment": {
          "FIRECRAWL_API_KEY": "fc-<ваш ключ>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "firecrawl-mcp-server": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-<ваш ключ>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "firecrawl-mcp-server": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-<ваш ключ>"
      }
    }
  }
}

Инструменты сервера

firecrawl_scrapeпревращает страницу в Markdown

firecrawl_searchищет в интернете

firecrawl_mapсобирает адреса страниц сайта

firecrawl_crawlобходит раздел сайта

firecrawl_check_crawl_statusпроверяет ход обхода

firecrawl_parseразбирает PDF и документы

firecrawl_agentведёт исследование по нескольким сайтам

firecrawl_agent_statusзабирает результат исследования

firecrawl_interactкликает и печатает на странице

firecrawl_interact_stopзакрывает сессию браузера

firecrawl_monitor_createставит страницу на слежение

firecrawl_monitor_listпоказывает слежения

firecrawl_monitor_checksпоказывает историю проверок

firecrawl_developer_searchищет по GitHub и документации

firecrawl_research_search_papersищет научные статьи

firecrawl_research_read_paperчитает научную статью

firecrawl_gov_searchищет по госисточникам США

people_company_searchищет людей и компании

firecrawl_credit_usageпоказывает остаток кредитов

Показано 19 из 31.

Что попросить агента

«Забери характеристики товара со страницы <адрес>»Агент вызовет firecrawl_scrape и вытащит нужные поля из Markdown

«Перечисли все адреса на сайте <домен>»Агент вызовет firecrawl_map

«Собери все записи блога с первых двух уровней <домен>/blog»Агент вызовет firecrawl_crawl с ограничением глубины и дождётся результата

«Найди основателей <компания> и их биографии»Агент запустит firecrawl_agent и заберёт результат через firecrawl_agent_status

«Сравни условия <тема> в нескольких компаниях»Агент вызовет firecrawl_search и при необходимости дочитает страницы через firecrawl_scrape

Для каких задач

Достать с известной страницы цены, характеристики или текст в Markdown

Собрать все адреса сайта и выгрузить статьи из раздела блога

Превратить PDF, документ Word или таблицу в Markdown

Пройти страницу, где нужно сначала кликнуть или заполнить форму

Собрать сведения по теме с нескольких сайтов в структурированный JSON

Следить за страницей и получать уведомление, когда она меняется

Ограничения

Без ключа на удалённом сервере доступны только scrape, search и parse; crawl, map, agent и остальные требуют ключ

Запросы расходуют кредиты аккаунта Firecrawl; агент по умолчанию может потратить до 2 500 кредитов за запуск

Ответы firecrawl_crawl бывают очень большими и переполняют контекст: ограничивайте глубину и число страниц

Удалённый parse не видит ваши файлы: файл сначала загружается по одноразовой команде

Если не работает

На Windows сервер не стартует из Cursor

Запустите командой cmd /c "set FIRECRAWL_API_KEY=<ключ> && npx -y firecrawl-mcp".

Локальный HTTP-режим отвечает 403

Сервер отвечает только на localhost, 127.0.0.1 и [::1]. Добавьте нужное имя или IP в FIRECRAWL_MCP_ALLOWED_HOSTS через запятую.

Инструмент возвращает Error: Rate limit exceeded

Исчерпан лимит частоты запросов. На бесплатном доступе без ключа он ниже: подключите ключ или вход через аккаунт.

Агент пытается передать в firecrawl_scrape сразу несколько адресов

Scrape принимает один адрес за вызов. Попросите вызывать его отдельно для каждой страницы или сначала собрать адреса через firecrawl_map.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Firecrawl MCP (удалённый)разработчик сервиса	Firecrawl	7,8 тыс.	HTTP	токен	3	12 ноября 2026
Firecrawl MCP (локальный)разработчик сервиса	Firecrawl	7,8 тыс.	локально	токен	31	12 ноября 2026

Частые вопросы

Можно попробовать без ключа?

Да: подключите https://mcp.firecrawl.dev/v2/mcp без заголовка. Работают firecrawl_scrape, firecrawl_search и firecrawl_parse с ограничением частоты. Для обхода сайтов, карты и агента нужен ключ или вход через аккаунт.

Чем scrape отличается от crawl и map?

Scrape читает одну известную страницу. Map собирает адреса страниц сайта без содержимого. Crawl обходит много страниц раздела и отдаёт их текст: задавайте limit и maxDiscoveryDepth.

Клиент ограничивает число инструментов. Что делать?

Полный сервер даёт 31 инструмент. Удалённый адрес без ключа даёт 3, а https://mcp.firecrawl.dev/v2/mcp-search — 11 инструментов поиска. Отзывы о поиске отключаются переменными FIRECRAWL_NO_SEARCH_FEEDBACK=1 и FIRECRAWL_NO_ENDPOINT_FEEDBACK=1.

Как узнать, сколько осталось кредитов?

Попросите агента вызвать firecrawl_credit_usage: он вернёт остаток и кредиты тарифа за текущий период, а с view: historical — расход по месяцам.

Работает ли сервер из России?

Все запросы обрабатывает облако Firecrawl, поэтому нужен доступ к firecrawl.dev из вашей сети и аккаунт с кредитами; свою установку Firecrawl можно подключить через FIRECRAWL_API_URL.