> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wherobots.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Wherobots as an Official Connector in Claude

> Enable the official Wherobots connector in Claude Desktop or Claude on the web for AI-assisted geospatial development.

<Badge color="purple">Public Preview</Badge>

**Claude** is Anthropic's AI assistant, available as a [native desktop app](https://claude.ai/download) for macOS and Windows and a [browser-based app](https://claude.ai).

Both support MCP integrations through Claude's connector Directory, where Wherobots can be added as an official connector.

## Component Overview

Wherobots' Agentic Tools consist of the following components that work together to provide our agentic experience:

<AccordionGroup>
  <Accordion title="MCP Server" icon="message-bot">
    Connects your AI assistant to Wherobots Cloud for catalog exploration, Spatial SQL generation, and query execution.
  </Accordion>

  <Accordion title="Agent Skills" icon="brain">
    Gives your AI assistant domain-specific Wherobots knowledge for more accurate commands and fewer errors.
  </Accordion>

  <Accordion title="Wherobots CLI" icon="terminal">
    Wraps the full Wherobots API into a single binary for job submission, log streaming, and automation.
  </Accordion>
</AccordionGroup>

## Why use Wherobots' agentic tools?

Wherobots' agentic tools connect your AI assistant to Wherobots Cloud and your local development environment so you can interact with your spatial data, catalogs, and jobs in a more intuitive way.

<AccordionGroup>
  <Accordion title="Explore your spatial catalog conversationally" icon="book-open">
    The MCP Server connects your AI assistant to Wherobots Cloud so you can browse catalogs, databases, and table schemas (including Overture Maps and your own datasets) by asking questions in plain language instead of navigating the console.
  </Accordion>

  <Accordion title="Generate Spatial SQL without memorizing functions" icon="code">
    Describe a geospatial task (e.g. "find buildings within 500m of this point") and the MCP Server returns optimized Spatial SQL using WherobotsDB's ST functions, spatial joins, and indexing patterns.
  </Accordion>

  <Accordion title="Submit and monitor Wherobots jobs from your editor" icon="rocket">
    Use the CLI or the extension to submit Spark job runs, stream logs in real time, check resource metrics, and cancel jobs without leaving your editor or terminal.
  </Accordion>

  <Accordion title="Get Wherobots-aware AI assistance" icon="brain">
    Agent Skills teach your AI assistant Wherobots-specific APIs, query patterns, and workflow sequences so it produces correct `wherobots` CLI commands, valid MCP tool calls, and accurate notebook code on the first try.
  </Accordion>
</AccordionGroup>

## Before you start

The following prerequisites are required:

* A [Claude](https://claude.ai) account with an active paid [subscription](https://www.anthropic.com/pricing).
* A **Wherobots Account** within a Professional, Innovation, or Enterprise Organization. See [Create a Wherobots Account](/get-started/wherobots-cloud/create-account).
* For the desktop flow: [Claude Desktop](https://claude.ai/download) installed.
* If you are on Claude's **Team** or **Enterprise** plan, ask your Claude plan's **Owner** or **Primary Owner** to enable connectors for your Claude organization.
* Each user still must authenticate individually after the Connector is enabled.
  * For more information, see the [Wherobots connector does not appear in the Directory](#the-wherobots-connector-does-not-appear-in-the-directory) section of this page or [Use Connectors to extend Claude's capabilities](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities#h_bbcedba6ca).

## Install and configure

When Wherobots is available in your Claude Directory as an official connector, each user can enable it from their own account. The same steps work in Claude on the web and Claude Desktop.

<Note>
  On **Team** and **Enterprise** plans, an Owner or Primary Owner may need to enable connectors for the organization before you can add Wherobots. If the connector does not appear or you cannot enable it, ask your team's owner to enable it for the organization. Each user still authenticates individually after it is enabled. For more information, see [Use Connectors to extend Claude's capabilities](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities#h_bbcedba6ca).
</Note>

<Steps>
  <Step title="Open Connectors in Claude">
    1. Open the connectors page:
       * **Web:** Go to [https://claude.ai/directory](https://claude.ai/directory).
             <Frame>
               <img src="https://mintcdn.com/wherobots/1ufYnZKbUKooC-ox/develop/agentic-tools/images/claude-directory-wherobots-connector.png?fit=max&auto=format&n=1ufYnZKbUKooC-ox&q=85&s=9ff4b4697332bdae311a59dd5bf0b837" width="500" data-path="develop/agentic-tools/images/claude-directory-wherobots-connector.png" />
             </Frame>
       * **Desktop:** Open **Customize > Connectors > Browse** from the left sidebar.
  </Step>

  <Step title="Enable the Wherobots connector">
    1. In the **Directory** modal, search for `wherobots`.
           <Frame>
             <img src="https://mintcdn.com/wherobots/yxh_cgunQ9YvqePl/develop/agentic-tools/images/claude-directory.png?fit=max&auto=format&n=yxh_cgunQ9YvqePl&q=85&s=0f24fa7266b6e716526a81cd60790f12" width="500" data-path="develop/agentic-tools/images/claude-directory.png" />
           </Frame>

    2. Select the official **Wherobots Spatial AI Assistant**.

    3. Click **+** to enable the Connector in your Claude Organization.
  </Step>

  <Step title="Complete OAuth">
    1. A new browser tab will open to the Wherobots sign-in page.
    2. Sign in to Wherobots, select your Organization from the **Organization access** dropdown, and click **Allow access**.

           <Frame caption="Wherobots OAuth consent screen for Claude.">
             <img src="https://mintcdn.com/wherobots/-xg1VXa7MjWQmfwe/develop/agentic-tools/images/claude-grant-access.png?fit=max&auto=format&n=-xg1VXa7MjWQmfwe&q=85&s=4f31edc3256a5c85a578456c452e5561" alt="Wherobots OAuth consent screen prompting Claude access for the selected Organization" width="1500" height="760" data-path="develop/agentic-tools/images/claude-grant-access.png" />
           </Frame>
    3. Return to Claude. The **Wherobots** connector will appear in the **Web** section of the **Connectors** page.

       You have successfully connected Wherobots to Claude! You can now use the Wherobots connector in your Claude conversations and agentic workflows.
  </Step>
</Steps>

## Verify installation

Ask a question in Claude:

```text wrap theme={"system"} theme={"system"}
List the catalogs in my Wherobots Data Hub
```

If configured correctly, Claude calls the Wherobots MCP server (showing a tool such as `list_catalogs`) and returns the catalogs available in your Organization.

## Troubleshooting

The following section details how to troubleshoot the installation of the Wherobots Spatial AI Assistant in Claude.

### The Wherobots connector does not appear in the Directory

On **Team** and **Enterprise** plans, connectors must be enabled at the organization level before individual users can add them. If you search the **Directory** and Wherobots does not appear—or the option to add it is unavailable—ask your team's Owner or Primary Owner to enable connectors for the organization.

Once enabled at the org level, each user still completes the [Install and configure](#install-and-configure) steps and authenticates individually. See [Use Connectors to extend Claude's capabilities](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities#h_bbcedba6ca) for details on connector permissions.

### Sign-in or OAuth fails

If the consent screen does not complete or Claude reports it cannot connect:

* Confirm you have a stable internet connection and an active Wherobots Account in a Professional, Innovation, or Enterprise Organization.
* Make sure you selected the correct Organization from the **Organization access** dropdown before clicking **Allow access**.
* On the Claude **Connectors** page, disconnect the Wherobots connector and reconnect to restart the OAuth flow.

### Claude does not call the Wherobots MCP server

If Claude answers without invoking a Wherobots tool (such as `list_catalogs`):

* Confirm the **Wherobots** connector is enabled on the **Connectors** page and toggled on for the conversation.
* Start a new conversation and ask an explicitly geospatial question so Claude selects the connector:

  ```text wrap theme={"system"} theme={"system"}
  List the catalogs in my Wherobots Data Hub
  ```

## Next steps

<CardGroup cols={2}>
  <Card title="MCP Server Best Practices" icon="message-bot" href="/develop/mcp/mcp-server-usage">
    Common tasks, example prompts, and cost considerations for the MCP Server.
  </Card>

  <Card title="MCP Server Demo Video" icon="video" href="/develop/mcp/mcp-server-automating-geospatial-workflows">
    Watch the MCP Server automate catalog discovery, spatial queries, and notebook generation.
  </Card>

  <Card title="Agent Skills" icon="brain" href="/develop/agent-skills">
    Learn more about available skills and installation options.
  </Card>

  <Card title="MCP Server vs CLI" icon="scale-balanced" href="/develop/mcp-vs-cli">
    Understand when to use the MCP Server vs. the CLI.
  </Card>
</CardGroup>