Claude Desktop

Claude Desktop supports the Model Context Protocol (MCP), so you can use Geonode scraping tools directly in chat.

Geonode authenticates with a static X-Api-Key header. In Claude Desktop, the working setup today is Settings → Developer → Edit Config with mcp-remote.

Step 1 — Open Settings

Open Claude Desktop.

Click your profile menu in the bottom-left corner, then select Settings.

Step 2 — Open Developer → Edit Config

In Settings:

1. Under Desktop app, open Developer.
2. Find Local MCP servers.
3. Click Edit Config.

This opens claude_desktop_config.json.

You can also edit the file directly:

Step 3 — Add the Geonode MCP server

Add the Geonode server under the top-level mcpServers key.

If the file already has other settings, keep them and place mcpServers alongside those top-level keys — do not nest it inside another object.

{
  "mcpServers": {
    "geonode-scraper": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://scraper.geonode.io/mcp",
        "--header",
        "X-Api-Key:${GEONODE_API_KEY}"
      ],
      "env": {
        "GEONODE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Geonode API key.

Step 4 — Fully restart Claude Desktop

1. Save claude_desktop_config.json.
2. Quit Claude Desktop completely — close the process, not only the window.
3. Open Claude Desktop again.
4. Start a new chat.

A partial window close is not enough. MCP servers load on a full app restart.

Step 5 — Verify the connection

In a new chat, ask Claude to call a Geonode tool. For example:

Call the geonode scraper statistics endpoint and tell me the HTTP status and a short summary of the response.

If the connection works:

• Claude uses the Geonode MCP tools
• You do not need to pass api_key in the chat prompt
• A successful statistics call returns HTTP 200

Step 6 — Start using Geonode MCP

Once connected, describe tasks in natural language. Claude selects the Geonode tool automatically.

Extract a web page

Extract the content from https://geonode.com

Summarize a page

Read https://geonode.com and summarize the homepage.

Crawl a documentation website

Crawl https://docs.geonode.com and tell me what documentation sections exist.

Check extraction statistics

Show my Geonode extraction statistics.

Important setup notes

FAQs