> For the complete documentation index, see [llms.txt](https://docs.remote.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.remote.it/mcp-server/connect-claude.md).

# Connect Claude

This guide adds Remote.It as a connector in Claude, so Claude can see and manage your devices in conversation.

{% hint style="warning" %}
**Preview release.** Use the preview URL below for now. It will change when the MCP server is fully released.

```
https://mcp.demo.remote.it/mcp
```

{% endhint %}

## Claude web & desktop

Custom connectors are configured once in your Claude settings and are then available in Claude on the web (claude.ai), the desktop apps, and mobile.

{% hint style="info" %}
Custom connectors require a paid Claude plan (Pro, Max, Team, or Enterprise). On Team and Enterprise plans, an admin may need to add the connector for the organization.
{% endhint %}

{% stepper %}
{% step %}

## Add the connector

Open [claude.ai](https://claude.ai) and go to **Settings** → **Connectors**, then click **Add custom connector**. Enter a name (e.g. `Remote.It`) and the server URL:

```
https://mcp.demo.remote.it/mcp
```

Click **Add**.
{% endstep %}

{% step %}

## Sign in to Remote.It

Claude opens a browser window to sign in. Use your normal Remote.It account (social sign-in and 2FA work as usual), then review the consent screen — this is where you choose what the assistant may do (see [Permissions & Safety](/mcp-server/permissions-and-safety.md)).
{% endstep %}

{% step %}

## Enable it in a conversation

Back in Claude, start a new conversation and make sure the Remote.It connector is enabled in the tools menu (the sliders icon in the chat input).
{% endstep %}
{% endstepper %}

Try it out:

> Which of my devices are online?

## Claude Code

Add the server with one command:

```bash
claude mcp add --transport http remoteit https://mcp.demo.remote.it/mcp
```

The first time a Remote.It tool is used, Claude Code walks you through the same browser sign-in. Use `/mcp` inside Claude Code to check connection status or re-authenticate.

## Other MCP clients

Any MCP client that supports the **Streamable HTTP** transport with **OAuth 2.1** authorization can connect using the same URL — no client registration or API keys required. Consult your client's documentation for adding a remote MCP server.

## Troubleshooting

* **Sign-in window doesn't appear** — pop-up blockers can suppress the OAuth window. Allow pop-ups for your Claude client and retry.
* **Claude says it has no Remote.It tools** — check that the connector is enabled for the current conversation in the tools menu, then start a new conversation.
* **"No devices found" but you have devices** — you may have granted limited access at sign-in. Remove the connector and add it again to re-run consent with broader access.
* **Connector stopped working** — during the preview period the server URL may change. Check this page for the current URL.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.remote.it/mcp-server/connect-claude.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.