RealtyPad works with any AI assistant that can connect to a remote **MCP server**. This article covers Claude (claude.ai and Claude Desktop), Claude Code, and ChatGPT. For Cursor, see [How do I connect Cursor or another MCP client?](https://support.realtypad.ai/hc/faq/articles/1787171770-how-do-i-connect-cursor-or-another-mcp-client).

## Before you start

* Sign in at [app.realtypad.ai](https://app.realtypad.ai) and switch to the **workspace** you want the assistant to use (account menu, top right). Access is scoped to the workspace you're in when you authorize.

* The MCP URL is `https://app.realtypad.ai/mcp` (no slash at the end). You can copy it from your account menu → **Agent & API** → **MCP access**.

## Claude (claude.ai or Claude Desktop)

1. In Claude, go to **Customize → Connectors**

2. Click **+ Add**, then **Add custom connector**

3. Name it **RealtyPad**, paste `https://app.realtypad.ai/mcp`, and click **Continue**. Choose to sign in, then click **Add**

4. Sign in to RealtyPad in the browser and click **Authorize**

5. In a chat, click **+** (lower left) → **Connectors** and make sure **RealtyPad** is on

6. Ask Claude to list a few deals, then to call `get_agent_manual` so it loads RealtyPad's working instructions

Custom connectors work on every Claude plan. The Free plan allows **one** custom connector. On **Team** and **Enterprise**, an organization owner adds the connector under **Organization settings → Connectors**, then each member clicks **Connect** under **Customize → Connectors**.

## Claude Code

1. In your terminal, run:

   `claude mcp add --transport http realtypad https://app.realtypad.ai/mcp`

   Add `--scope user` to use RealtyPad in all your projects, not just the current one.

2. Start Claude Code and run `/mcp`, pick **realtypad**, and sign in to RealtyPad in the browser

3. Ask Claude to list a few deals and to call `get_agent_manual`

Can't open a browser (for example on a server)? Use an agent token instead:

`claude mcp add --transport http realtypad https://app.realtypad.ai/mcp --header "Authorization: Bearer <agent-token>"`

## ChatGPT

1. In ChatGPT, open **Settings → Apps** and turn on **Developer mode**

2. Create a connector, paste `https://app.realtypad.ai/mcp`, and choose **OAuth**

3. Sign in to RealtyPad in the browser and authorize

4. Ask ChatGPT to list a few deals and to call `get_agent_manual`

## No browser sign-in? Use an agent token

For scripts or clients that can't open a browser:

1. Open your account menu → **Agent & API**

2. Under **Long-lived agent token**, click **Mint agent token** and copy it right away (it's shown once and lasts about 90 days)

3. Add it to your client's MCP config as an `Authorization: Bearer <token>` header. **Copy config** on the same page gives you a ready-made example.

Treat the token like a password. Tokens bind to the workspace you were in when you minted.

## Troubleshooting

* **No sign-in prompt, or a 401 error:** remove and re-add the connector, then finish the browser consent.

* **Sign-in opens the wrong site, or "Protected resource … does not match":** use `https://app.realtypad.ai/mcp` exactly, without a trailing slash, and reconnect.

* **The assistant sees no deals, or the wrong ones:** you authorized a different workspace. Switch workspace in the app, then re-authorize (or mint a new token).

* **Revoking access:** remove the connector from your assistant. Workspace owners and admins can also cut off any connection under account menu → **Billing** → **Seats, agents & automation** → **Remove**. Minting a new agent token retires your old one.

* **"Agent Connection limit reached":** see [MCP troubleshooting](https://support.realtypad.ai/hc/faq/articles/1791383431-mcp-troubleshooting-authorization-connection-limits-and-the-wrong-workspace).

More detail: [docs.realtypad.ai → Connect LLM Agent (MCP)](https://docs.realtypad.ai/connect-mcp/)

When contacting support, send: which assistant you're using, the workspace name, and the exact error message.
