Knowhere
Docs Sign in

Connect Knowhere to your AI app

Knowhere answers map questions — what's nearby, how far, whether you could walk there. Connect it once and your AI app asks on your behalf.

Your MCP server address
https://app.knowhere.live/mcp

Your app will ask you to sign in when it connects. Sign in if you have an account; if not, ask whoever sent you here for an invite. Everything else works now.

Next, pick your app below — each one wants this pasted somewhere different.

Which app are you using?

Steps for Claude

Custom connectors need a paid Claude plan (Pro, Max, Team or Enterprise).

  1. Open Claude's connector settings

    In the Claude app, or on claude.ai in a browser. The button below opens the right page.

    Open Claude connector settings

  2. Choose to add a custom connector

    Name it Knowhere.

  3. Paste this address into the URL box

    Then press Add. Leave the advanced settings alone — there is no key to enter.

    https://app.knowhere.live/mcp
  4. Sign in when the window opens

    Claude opens a Knowhere sign-in page. Sign in and it closes itself.

  5. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for ChatGPT

Needs ChatGPT Plus or Pro. On a work or school account, an admin may have to allow custom connectors first.

  1. Turn on developer mode

    This is what lets ChatGPT talk to a server that isn't in its own directory.

  2. Start a new connector

    Name it Knowhere. For authentication, choose OAuth.

  3. Paste this address into the MCP server URL box

    https://app.knowhere.live/mcp
  4. Sign in when it asks

    ChatGPT registers itself with Knowhere on its own; you only sign in.

  5. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for v0

  1. Open v0's MCP connections

    Open v0 MCP settings

  2. Add a custom server

    Skip the presets — Knowhere isn't one of them.

  3. Paste this address

    https://app.knowhere.live/mcp
  4. Sign in when the window opens

  5. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for Claude Code

  1. Run this in your terminal

    --scope user registers it once for every project. Without it the server exists only in the folder you happen to be in.

    claude mcp add --transport http --scope user knowhere https://app.knowhere.live/mcp
  2. Open the MCP list and pick knowhere

    Type /mcp in Claude Code, choose knowhere, and approve it.

  3. Sign in when the browser opens

    The window closes itself when it's done.

  4. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for Cursor

  1. Install it with one click

    Cursor opens and asks to confirm.

    Add Knowhere to Cursor

  2. Or add it by hand

    If the button did nothing, put this in ~/.cursor/mcp.json instead.

    {
      "mcpServers": {
        "knowhere": {
          "type": "http",
          "url": "https://app.knowhere.live/mcp"
        }
      }
    }
  3. Sign in

    knowhere shows Needs login — click it and sign in.

  4. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for VS Code

  1. Install it with one click

    On VS Code Insiders, use the by-hand path below instead.

    Add Knowhere to VS Code

  2. Or add it by hand

    Paste this address when it asks for the URL, and name it knowhere.

    https://app.knowhere.live/mcp
  3. Sign in when prompted

    VS Code asks for permission to authenticate, then opens the browser.

  4. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for Codex

  1. Register the server

    codex mcp add knowhere --url https://app.knowhere.live/mcp
  2. Sign in

    This opens a browser window and stores the token for you.

    codex mcp login knowhere
  3. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for Gemini CLI

  1. Add this to ~/.gemini/settings.json

    Merge it into the mcpServers block if you already have one.

    {
      "mcpServers": {
        "knowhere": {
          "httpUrl": "https://app.knowhere.live/mcp"
        }
      }
    }
  2. Restart Gemini CLI and sign in

    It finds Knowhere's sign-in on its own and opens a browser the first time it connects.

  3. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for Windsurf

  1. Add this to ~/.codeium/windsurf/mcp_config.json

    On Windows the file is under %USERPROFILE%\.codeium\windsurf\.

    {
      "mcpServers": {
        "knowhere": {
          "serverUrl": "https://app.knowhere.live/mcp"
        }
      }
    }
  2. Refresh, then sign in

  3. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for Zed

Zed only talks to servers running on your own machine, so this one needs a small bridge. It requires Node.js.

  1. Add this to Zed's settings.json

    {
      "context_servers": {
        "knowhere": {
          "args": [
            "-y",
            "mcp-remote",
            "https://app.knowhere.live/mcp"
          ],
          "command": "npx",
          "source": "custom"
        }
      }
    }
  2. Check that it started

    The dot next to knowhere turns green. Sign in in the browser window it opens.

  3. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer

Steps for Manual setup

  1. Add this entry to your app's MCP config

    Most apps read a block like this one — Claude Desktop's claude_desktop_config.json, a project .mcp.json. Restart the app afterwards.

    {
      "mcpServers": {
        "knowhere": {
          "type": "http",
          "url": "https://app.knowhere.live/mcp"
        }
      }
    }
  2. Or, if it only asks for an address

    https://app.knowhere.live/mcp
  3. Authorize it

    Knowhere speaks OAuth and registers apps automatically. There is no key or token to paste anywhere.

  4. Ask it something

    If an answer comes back, it's working.

    Using Knowhere, is there a grocery store within a 15-minute walk of 1600 Pennsylvania Ave NW, Washington DC?

    See what else it can answer