Skip to main content

Connect Claude Desktop to Data Platform

Connect Anthropic Claude Desktop to the Zoovu Data Platform MCP server using Claude’s Model Context Protocol (MCP). Follow the steps below to configure and test against the dev server.

Prerequisites​

  • Claude Desktop installed
  • Node.js with npx
  • An MCP-scoped API key
  • A project ID and catalog ID from the Zoovu Data Platform

Dev environment​

The dev MCP server is available Monday–Friday, 08:00–20:00 (local time, same as other Data Platform dev services).

If Claude Desktop disconnects after nightly restarts, restart the app to re-establish the session.

Configure Claude Desktop​

Claude Desktop loads MCP servers from a JSON config file named claude_desktop_config.json.

Common file locations:

  • Windows: C:\Users\<YourUser>\AppData\Roaming\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

You can also open it from Claude Desktop via Settings > Developer.

Add a new MCP server entry (example for the dev server):

{
  "mcpServers": {
    "ps-mcp-dev": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-dev.data.zoovu.com/mcp/38106/r3p3358xl84xdf112eqwb76kt1w6dnro?catalogId=119092"
      ]
    }
  }
}
  • ps-mcp-dev is just a placeholder name for this server; you can change it.
  • The URL defines which project and catalog are exposed.

URL format​

Pattern:

https://mcp-dev.data.zoovu.com/mcp/{projectId}/{apiKey}?catalogId={catalogId}
  • projectId: your Data Platform project ID (e.g. 11222)
  • apiKey: MCP-scoped API key (e.g. r3p3358xl84xdf112eqwb76kt1w6dnro)
  • catalogId: catalog ID (e.g. 112211)

Find project and catalog IDs​

You can get the IDs from the Data Platform UI. Go to a catalog:

https://data.zoovu.com/catalog-manager/catalog/29328/products?projectId=55396&dataSearchId=4371295

In this URL:

  • projectId = 55396
  • catalogId = 29328

Get an API key​

Generate an MCP-scoped API key in Data Platform > Project > API Keys:

https://data.zoovu.com/projects/api-keys?projectId=<your_project_id>

Apply the configuration​

  1. Save claude_desktop_config.json.
  2. Restart Claude Desktop so it reloads MCP servers:
    • Quit and reopen Claude Desktop, or
    • Use “Restart servers” in Claude (if available).
  3. After restart, Claude should list and load the ps-mcp-dev MCP server as a tool.

Use the dev MCP server​

  • Replace projectId, apiKey, and catalogId in the URL to test different projects and catalogs.
  • In the current dev setup, filter parameters are generated only for numeric filters that are visible on the frontend search results.