Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi bản host tại mcp.firecrawl.dev chạy được scrape, search và parse mà không cần API key, nên bạn thử được trước khi đăng ký. | README ghi, Hosted MCP (keyless free tier) |
|---|---|---|
| Ưu | Gói Free cho 1.000 credit mỗi tháng, không cần thẻ; gói rẻ nhất trả phí là Hobby 19 USD/tháng cho 5.000 credit (đọc ngày 29/10/2026). | Trang giá Firecrawl, 29/10/2026 |
| Ưu | Có thể trỏ sang Firecrawl tự host bằng FIRECRAWL_API_URL, khi đó nội dung trang không đi qua máy chủ của Firecrawl. | README, Environment Variables |
| Nhược | Dùng với Firecrawl tự host từng lỗi: sau bản sửa ở v3.2.0, server vẫn đòi API key dù đã đặt FIRECRAWL_API_URL tới máy chủ của bạn. | Issue #126 |
| Nhược | Từ bản 3.18.0, chạy qua stdio với FIRECRAWL_API_KEY thì mọi lệnh đều trả về "Unauthorized" cho tới khi được sửa. | Issue #246 |
| Nhược | Ví dụ trong mô tả công cụ dạy model gọi sai cú pháp, nên model nhỏ hay gọi lỗi (MCP error -32602). Issue còn mở, chưa có phản hồi từ nhóm Firecrawl. | Issue #279 (đang mở) |
| Nhược | Trên Windows 11, người dùng báo lỗi "Client Closed" hoặc không tạo được server; issue mở từ 04/2025 vẫn chưa đóng. | Issue #36 (đang mở) |
| Chưa rõ | README không nhắc tới Claude Code hay Codex, chỉ có Claude Desktop, Cursor, Windsurf và VS Code. Đây là MCP server chuẩn nên nhiều khả năng chạy được, nhưng tác giả không ghi cách cài cho hai công cụ này. | README, Installation |
| Chưa rõ | Mình đọc mã nguồn TypeScript trong src/; gói npm chứa bản đã build (dist/) và mình chưa so hai bản với nhau. | package.json |
Khi nên dùng
- Agent cần đọc nội dung web thật (bài đối thủ, docs, kết quả tìm kiếm) dưới dạng Markdown sạch, và 1.000 credit mỗi tháng là đủ cho bạn.
Khi không nên dùng
- Bạn không muốn gửi URL và nội dung trang qua máy chủ của bên thứ ba, hoặc bạn chạy trên Windows và cần một server cài là chạy.
Cách cài
Claude Desktop
claude_desktop_config.json: "command": "npx", "args": ["-y", "[email protected]"], "env": { "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE" }Cursor
env FIRECRAWL_API_KEY=your-api-key npx -y [email protected]MCP client hỗ trợ HTTP (bản host, không cần key)
https://mcp.firecrawl.dev/v2/mcpNó chạm vào những gì
- File đọc và ghi
- Không ghi file. Công cụ firecrawl_parse đọc một file trên máy theo đường dẫn agent đưa vào và gửi lên máy chủ Firecrawl tự host của bạn (chỉ khi đặt FIRECRAWL_API_URL).
- Gọi mạng
- api.firecrawl.dev (hoặc máy chủ bạn đặt trong FIRECRAWL_API_URL). Mỗi yêu cầu kèm tên client MCP hoặc User-Agent làm "origin" để Firecrawl biết yêu cầu đến từ đâu. Trang bạn scrape được Firecrawl tải trên máy chủ của họ, không phải trên máy bạn.
- Script lúc cài
- Gói npm firecrawl-mcp 3.36.0 không có postinstall; script prepare chỉ chạy khi build từ mã nguồn.
- Tiến trình
- Một tiến trình Node chạy qua stdio khi client MCP gọi; chế độ HTTP (HTTP_STREAMABLE_SERVER, SSE_LOCAL) mở cổng 3000 trên máy.
Đọc từ: index.ts#L112-L125, origin.ts#L1-L25, server.ts#L3170-L3190, package.json
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin