Skip to content
Crawler.sh Logo Crawler.sh Logo Crawler

Use Crawler MCP with Zed

Zed exposes MCP servers as “context servers”. Once crawler-mcp is installed (guide), declare it in your Zed settings.

Open settings

Section titled “Open settings”

In Zed, run the zed: open settings command (Cmd+, on macOS). The file lives at:

~/.config/zed/settings.json

Add the server entry

Section titled “Add the server entry”

  1. Find the absolute path

    Section titled “Find the absolute path”
    which crawler-mcp

  2. Edit settings.json

    Section titled “Edit settings.json”
    {
      "context_servers": {
        "crawler-sh": {
          "command": {
            "path": "/Users/you/.crawler/bin/crawler-mcp",
            "args": [],
            "env": {}
          }
        }
      }
    }

    Use the absolute path from step 1. Zed will not expand ~.

  3. Reload

    Section titled “Reload”

    Zed picks up settings changes on save. Open the Agent Panel and confirm crawler-sh appears with three tools listed.

Raise the page cap

Section titled “Raise the page cap”

Set CRAWLER_TOKEN in the env block to raise the per-crawl cap from 50 to 400 pages (or 10,000 with a Pro subscription). See Tier caps.

{
  "context_servers": {
    "crawler-sh": {
      "command": {
        "path": "/Users/you/.crawler/bin/crawler-mcp",
        "args": [],
        "env": { "CRAWLER_TOKEN": "your-token" }
      }
    }
  }
}

Try it

Section titled “Try it”

Open the Agent Panel and ask:

Use crawler-sh to crawl https://example.com to depth 2 and list the page titles.

Zed will prompt you to allow the tool call, then act on the returned Markdown.

See also

Section titled “See also”