Connecting to the Regrid MCP Server
The Regrid MCP Server is available at:
https://support.regrid.com/mcp
MCP client support varies by platform — some use a point-and-click UI, others require editing a local JSON config file. This guide covers current setup steps for each major client as of this writing.
Transport typeThe Regrid MCP Server uses Streamable HTTP. Wherever a platform below asks you to choose a transport, select Streamable HTTP rather than the legacy SSE (Server-Sent Events) transport. Some clients (e.g. Gemini Enterprise) only support Streamable HTTP, which is a good match for our server.
These integrations evolve quicklyEvery platform in this guide is actively iterating on its MCP/connector support. Menu names, plan requirements, and config formats can shift with little notice. If a step below doesn't match what you see in the product, check that platform's own docs before assuming the server is misconfigured.
Quick reference
| Platform | Where to add it | Config format | Auth support |
|---|---|---|---|
| Claude (claude.ai / Desktop / Cowork / mobile) | + → Connectors → Add custom connector | UI form | OAuth (custom headers require config-file workaround on Desktop) |
| Gemini (web/app) | Settings & help → Connected Apps | UI form | OAuth |
| Gemini Enterprise (Google Cloud) | Data Stores → Custom MCP Server | Google Cloud Console | Varies by IdP setup |
| Gemini CLI | Local settings.json | JSON file | API key / header / OAuth |
| ChatGPT | Settings → Advanced → Developer Mode → Add connector | UI form | OAuth / none |
| Cursor | Settings → Tools & MCP | mcp.json, key: mcpServers | OAuth (auto-triggered) / header |
| GitHub Copilot (VS Code) | Command Palette → MCP: Open User Configuration | mcp.json, key: servers | OAuth / header |
| Perplexity | Account Settings → Connectors → + Custom connector | UI form | None / API Key / OAuth 2.0 |
Claude (claude.ai, Claude Desktop, Cowork, mobile)
This is the connection method most teams are already familiar with, since it's brokered through your Anthropic account rather than a local device — meaning it works identically across web, desktop, Cowork, and mobile once configured.
Prerequisites
- A Pro, Max, Team, or Enterprise plan (custom connectors aren't available on the Free plan)
- The MCP server must be reachable over the public internet — Claude's cloud infrastructure cannot reach servers only exposed on a VPN or internal network
Steps
- Click the + button next to the chat input (web/desktop) or the paperclip icon (mobile).
- Select Connectors → Add custom connector. (Alternatively: Settings → Connectors → Add custom connector.)
- Enter the connector details:
Field Value Name Regrid MCP ServerURL https://support.regrid.com/mcp - Click Connect. If the server requires authentication, Claude will walk you through an OAuth consent flow.
- Once added, the connector appears in the Connectors menu (paperclip/"+" icon), where you can toggle it on or off per conversation.
Custom headers (e.g. Bearer tokens) on Claude DesktopThe built-in Connectors GUI currently only supports OAuth — there's no field for a custom
Authorizationheader. If your server requires header-based auth, you'll need to bypass the GUI and add the server directly to Claude Desktop's config file via themcp-remotebridge. See Settings → Developer → Edit Config to locateclaude_desktop_config.json.
Verifying the connection
Start a new chat, toggle the connector on, and ask something like:
"Use the Regrid MCP to list the available Regrid API endpoints."
Gemini
Gemini web/mobile app (Gemini Spark)
Google refers to this integration as a Connected App.
Prerequisites
- Access to Gemini Spark
- A personal Google Account — Workspace and school (Education) accounts are not currently supported
- "Keep Activity" turned on in your Gemini settings
Steps
- Go to gemini.google.com.
- Open Settings & help → Connected Apps.
- Select Add a custom app and enter the MCP server URL:
https://support.regrid.com/mcp. - Complete whatever authentication the server requests (OAuth consent screen, if applicable).
- Enable the connected app within a conversation to start using it.
Gemini Enterprise (Google Cloud)
If your organization uses Gemini Enterprise rather than the consumer Gemini app, setup happens through the Google Cloud Console instead:
- In the Google Cloud Console, navigate to Data Stores → Custom MCP Server.
- Register the server URL and select Streamable HTTP as the transport (the deprecated SSE transport is not supported here).
- Configure access permissions per your organization's IAM policy.
Gemini CLI
For teams using the Gemini CLI, MCP servers are configured through a local settings.json file rather than any UI:
{
"mcpServers": {
"regrid-support": {
"url": "https://support.regrid.com/mcp"
}
}
}ChatGPT / OpenAI
OpenAI calls custom MCP connections part of Developer Mode.
Prerequisites
- A Plus or Pro plan (Developer Mode / full custom MCP tool support is not available on Free)
- Note: earlier iterations of this feature restricted custom connectors to Deep Research mode only. With Developer Mode enabled, connectors are now also available in regular chat.
Steps
- Go to Settings → Advanced and enable Developer Mode.
- Start a new chat and click Add sources / Add connector near the + icon on the message composer.
- Add a new connector using the MCP server URL:
https://support.regrid.com/mcp. - Complete authentication if prompted (OAuth or API key, depending on server configuration).
- To use the connector in a conversation, toggle it on and reference it explicitly in your prompt, e.g.:
"Use the Regrid Support tool to look up parcel data for this address."
Not available in Advanced Voice ModeMCP connectors currently cannot be invoked while using ChatGPT's Advanced Voice Mode.
Cursor
Cursor stores MCP configuration in a JSON file named mcp.json.
Steps
- Open Cursor Settings → Tools & MCP.
- Click New MCP Server (this opens
mcp.jsonfor editing), or create the file manually at one of:.cursor/mcp.json— project-scoped; check this into version control to share the connector with your team~/.cursor/mcp.json— global; available across every project on your machine
- Add an entry:
{
"mcpServers": {
"regrid-support": {
"url": "https://support.regrid.com/mcp"
}
}
}- Save the file, then restart Cursor (or reload the MCP panel from the Tools & MCP settings page).
- If the server requires OAuth, Cursor will automatically trigger a browser-based authentication flow and securely store the resulting credentials.
Watch the root keyCursor's config root key is
mcpServers— notservers, which is the key used by VS Code/GitHub Copilot. This is the most common mistake when copying a config between the two tools.
Prefer Streamable HTTPFor remote servers like this one, prefer the Streamable HTTP transport over the legacy SSE transport.
GitHub Copilot (VS Code)
Copilot's MCP support lives in VS Code's mcp.json and requires Agent mode.
Prerequisites
- VS Code 1.101+ for reliable remote/HTTP MCP and OAuth support
Steps
- Open the Command Palette (Cmd/Ctrl+Shift+P) and run:
- MCP: Open User Configuration — for a config available across every workspace, or
- Create
.vscode/mcp.jsonmanually for a project-scoped config.
- Add a server entry:
{
"servers": {
"regrid-support": {
"type": "http",
"url": "https://support.regrid.com/mcp"
}
}
}- Save the file — VS Code will prompt you to start the server. Run MCP: List Servers from the Command Palette to confirm it connected successfully.
- Open Copilot Chat and switch the mode dropdown from Ask to Agent — MCP tools are invisible in any other mode.
- Copilot will ask for confirmation the first time it invokes a tool from the server.
Watch the root keyVS Code/Copilot's config root key is
servers— notmcpServers, which is Cursor's key. This is the #1 mistake when copying a config over from Cursor or Claude Desktop.
Other Copilot surfacesIf your team uses Visual Studio (not VS Code) or the standalone Copilot CLI instead, the config file and format differ slightly:
- Visual Studio:
.mcp.json- Copilot CLI:
~/.copilot/mcp-config.json
Perplexity
Perplexity calls this a Custom Remote Connector, available on Pro and Enterprise plans.
Steps
- Go to Account Settings → Connectors (for org-wide setup on Enterprise: Enterprise Settings → Permissions → Connectors permissions).
- Click + Custom connector, then select Remote.
- Fill in the connector details:
Field Value Name Regrid Support MCPMCP Server URL https://support.regrid.com/mcpTransport Streamable HTTP Authentication None / API Key / OAuth 2.0 — depending on how the server is configured - Check the risk-acknowledgement box and click Add.
- Click the new connector card to complete authentication and enable it, then toggle it on within a chat thread to use it.
Enterprise admin setupOn Enterprise plans, an admin must first enable "Allow members to add custom connectors" before other org members can add connectors themselves, and must explicitly share the connector org-wide from the Permissions screen.
Behind Cloudflare AccessIf the server sits behind Cloudflare Access, Perplexity has a dedicated Network access option for supplying
CF-Access-Client-Id/CF-Access-Client-Secretheaders alongside normal authentication.
Troubleshooting checklist
- Connector added but tools aren't showing up — confirm the connector/toggle is enabled for the current conversation or session, not just added at the account level.
mcpServersvs.servers— double-check the config root key matches the platform (Cursor usesmcpServers; VS Code/Copilot usesservers).- Auth errors after adding a header-based token — re-verify the header value doesn't have stray whitespace or line breaks, and that any environment-variable placeholders (e.g.
${REGRID_TOKEN}) are actually set in the shell or config'senvblock. - SSE vs. Streamable HTTP — if a platform lets you pick a transport explicitly, choose Streamable HTTP.
- Still stuck? Check the platform's own current MCP/connector documentation, since UI names and requirements shift frequently across all these products.
Updated about 4 hours ago
