From 4c1ba35aa13db48667088b99e9fe68f7eeeb4306 Mon Sep 17 00:00:00 2001 From: Leonardo Grigorio <48296347+leonardogrig@users.noreply.github.com> Date: Thu, 2 Apr 2026 12:02:42 -0300 Subject: [PATCH] Revert "docs: add MCP servers guide with Firecrawl as featured example" This reverts commit 5baee3b491dd4c172370cfaca023cd0e6c533fcc. --- docs/mcp-servers.md | 94 --------------------------------------------- 1 file changed, 94 deletions(-) delete mode 100644 docs/mcp-servers.md diff --git a/docs/mcp-servers.md b/docs/mcp-servers.md deleted file mode 100644 index 3b720d4d..00000000 --- a/docs/mcp-servers.md +++ /dev/null @@ -1,94 +0,0 @@ -# MCP Servers - -OpenClaude supports Model Context Protocol (MCP) servers. MCP lets the agent call external tools — web scraping, databases, APIs, file systems, and more — beyond what's built in. - -## How to Configure - -Create a `.mcp.json` file in the root of any project you open with OpenClaude: - -```json -{ - "mcpServers": { - "your-server-name": { - "command": "npx", - "args": ["-y", "your-mcp-package"], - "env": { - "YOUR_API_KEY": "your-key-here" - } - } - } -} -``` - -OpenClaude picks up `.mcp.json` automatically when you launch it from that directory. No restart needed after creating the file. - -## Firecrawl — Web Scraping and Search - -The built-in `WebFetch` tool works for simple pages. For JavaScript-rendered sites, paywalls, full-site crawls, or structured data extraction, [Firecrawl](https://firecrawl.dev) is the recommended MCP server. - -**Get an API key at [firecrawl.dev/app/api-keys](https://www.firecrawl.dev/app/api-keys).** - -Add this to your project's `.mcp.json`: - -```json -{ - "mcpServers": { - "firecrawl": { - "command": "npx", - "args": ["-y", "firecrawl-mcp"], - "env": { - "FIRECRAWL_API_KEY": "your-api-key-here" - } - } - } -} -``` - -Or use the remote hosted endpoint (no local process needed): - -```bash -claude mcp add firecrawl --url https://mcp.firecrawl.dev/YOUR_API_KEY/v2/mcp -``` - -### What It Adds - -Once configured, the agent can call these tools directly: - -| Tool | What it does | -|------|-------------| -| `firecrawl_scrape` | Scrape a single URL to clean markdown, handles JS-rendered pages | -| `firecrawl_search` | Web search with optional full-page content extraction | -| `firecrawl_crawl` | Crawl an entire site section (e.g., all `/docs/`) | -| `firecrawl_map` | Discover all URLs on a site | -| `firecrawl_extract` | Pull structured data from pages using a JSON schema | -| `firecrawl_agent` | Autonomous research agent that browses and synthesizes across pages | - -### Verify - -After adding `.mcp.json`, launch OpenClaude and ask it to scrape a page or search the web. The agent will use Firecrawl automatically when the task involves fetching web content. - -For self-hosted Firecrawl instances, add `FIRECRAWL_API_URL` pointing to your instance alongside the API key. - -## Other Servers - -Any MCP-compatible server works the same way. Add multiple servers under `mcpServers`: - -```json -{ - "mcpServers": { - "firecrawl": { - "command": "npx", - "args": ["-y", "firecrawl-mcp"], - "env": { - "FIRECRAWL_API_KEY": "your-key" - } - }, - "another-server": { - "command": "npx", - "args": ["-y", "another-mcp-package"] - } - } -} -``` - -Browse available MCP servers at [modelcontextprotocol.io](https://modelcontextprotocol.io).