How do I connect Rheos to Claude?

On claude.ai or in the Claude app, open Settings → Connectors → Add custom connector. Paste https://mcp.rheos.app, click Connect and sign in with your Rheos email. Rheos in Claude and ChatGPT is in beta. We're opening it to Rheos accounts a few at a time.

What is the Rheos MCP server URL?

https://mcp.rheos.app. It is the same URL for every app.

Do I need an API key to connect Rheos?

No. claude.ai, Claude Desktop, ChatGPT, Claude Code, Codex, Cursor and VS Code all sign in with your Rheos email. A key is only for a tool that can't sign in. Only an organisation owner or admin can create one. Keys start with rk_live_, are shown in full once, can read your brands and create or edit drafts, can publish only if Allow publishing was ticked, and expire after 90 days.

How do I connect Rheos to ChatGPT?

On chatgpt.com, open Plugins, click +, then Add custom MCP server. Name it Rheos, paste https://mcp.rheos.app, choose OAuth and sign in with your Rheos email. Then type @ and pick Rheos in your message. ChatGPT is web only. Saving and scheduling posts needs ChatGPT Business, Enterprise or Edu, and on Business only an admin or owner can add Rheos. On Pro, ChatGPT can only read from Rheos. Plus, Go and Free can't add custom servers. If the option is missing, turn on Developer mode in Settings → Apps & Connectors → Advanced.

How do I connect Rheos to Claude Code?

Run claude mcp add --transport http --scope user rheos https://mcp.rheos.app in a terminal, then type /mcp in Claude Code and sign in with your Rheos email.

Why does a post say my social account was disconnected?

Social networks expire access on their own schedule. Reconnect the account in Rheos under Settings → Social Accounts. It can't be done from the chat.

The harness for social media marketing

Connect Rheos to your AI assistant

One connector URL. Sign in with your Rheos email, and your brand and publishing tools are there in every chat.

https://mcp.rheos.app

In beta: these steps work once your account has access. We're opening it a few accounts at a time. Get early access.

Want more detail? Read the full setup guide in the Rheos docs.

Before you start

1.A Rheos account that's in the beta. Any member of your organisation can connect once it is.
2.At least one brand set up, so there is a voice to write in. Onboarding does this for you.
3.Your social accounts connected in Rheos under Settings → Social Accounts: Instagram (a Business or Creator account), Facebook, LinkedIn or X. You connect them in Rheos, not in the chat. If your assistant needs one, it gives you a link to do it.

Sign in with your Rheos email

For claude.ai, Claude Desktop, ChatGPT, Claude Code, Codex, Cursor and VS Code. No key to copy or keep safe. Once your account has access, your setup steps and API keys are in Settings → MCP in Rheos. Custom connectors are a Claude feature: see Anthropic's guide to custom connectors for how they work on your Claude plan.

claude.ai

1.On claude.ai, open Settings → Connectors → Add custom connector.
2.Paste https://mcp.rheos.app and click Connect.
3.Sign in with your Rheos email.

Claude Desktop

1.In the Claude app, open Settings → Connectors → Add custom connector.Connectors you add on claude.ai show up in the app too.
2.Paste https://mcp.rheos.app and click Connect.
3.Sign in with your Rheos email.

ChatGPT

1.On chatgpt.com, open Plugins, click +, then Add custom MCP server.Web only. Saving and scheduling needs ChatGPT Business, Enterprise or Edu; on Business, only an admin or owner can add it. On Pro, ChatGPT can only read from Rheos. Plus, Go and Free can't add custom servers. Option missing? Turn on Developer mode in Settings → Apps & Connectors → Advanced.
2.Name it Rheos. Under Connection, paste https://mcp.rheos.app. Under Authentication, choose OAuth.
3.Tick "I understand and want to continue", click Create as a plugin, and sign in with your Rheos email when asked.
4.Install the Rheos plugin, then start a new chat.
5.Type @ and pick Rheos in each message that should use it.ChatGPT may ask you to confirm before changes like saving or scheduling a post.

Claude Code

Run this in a terminal:

claude mcp add --transport http --scope user rheos https://mcp.rheos.app

Then type /mcp in Claude Code and sign in with your Rheos email. No key to copy.

Codex

Run these in a terminal:

codex mcp add rheos --url https://mcp.rheos.app
codex mcp login rheos

Codex opens the Rheos sign-in in your browser. Sign in with your Rheos email. No key to copy.

Cursor and VS Code

In Rheos, open Settings → MCP, pick Cursor or VS Code, then choose Add to Cursor or Add to VS Code. Your editor asks to install Rheos, then opens the Rheos sign-in.

If the button does nothing, add https://mcp.rheos.app as an MCP server in your editor instead.

Or use an API key

Only for a tool that can't sign in, such as a machine that can't open a browser. Only an organisation owner or admin can create a key: in Settings → MCP, find API keys, choose Generate new key, name it after the tool that will use it, then choose Generate key and copy it. Use one key per tool, so you can revoke one without breaking the rest.

Claude Code

For a machine that can't open a browser to sign in. Run this in a terminal:

claude mcp add --transport http rheos https://mcp.rheos.app --header "Authorization: Bearer rk_live_your_api_key"

Cursor and others

Add this to your tool's MCP config (Cursor: ~/.cursor/mcp.json), then reload the tool.

mcp.json

{
  "mcpServers": {
    "rheos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.rheos.app",
        "--header",
        "Authorization: Bearer rk_live_your_api_key"
      ]
    }
  }
}

Any tool that takes a URL and a header

Server URL: https://mcp.rheos.app
Header: Authorization
Value: Bearer rk_live_your_api_key

Replace rk_live_your_api_key with your key.

Keys start with rk_live_, and Rheos shows a key in full only once. A key can read your brands and create or edit drafts. It can schedule and publish only if you ticked Allow publishing when you made it. Keys expire after 90 days. Treat a key like a password: never paste it into a chat or commit it to git, and revoke it in Settings → MCP if it may be exposed.

If something goes wrong

Claude or ChatGPT says Rheos MCP is in private beta.

Your account isn't in the beta yet. We're opening it a few accounts at a time. Ask us for early access and we'll tell you when you're in.

The server connects but no Rheos tools show up.

Some apps read the tool list only when they start, so fully quit and reopen the app rather than starting a new chat. With an API key, check the Authorization header is exact, with the Bearer prefix, and that your tool supports Streamable HTTP.

Scheduling or publishing is refused.

If you signed in, remove the connector and add it again. If you use an API key, it was made without Allow publishing: generate a new key with it ticked.

Claude Code, Cursor or another tool stopped connecting with a key.

API keys expire after 90 days. An owner or admin can generate a new key in Settings → MCP, then you swap it into your command or config.

A post says the social account is disconnected.

Reconnect the account in Rheos under Settings → Social Accounts. Social networks expire access on their own schedule, and reconnecting is the only fix.

A Rheos tool gave an error or a wrong answer.

Ask your assistant to report it. It sends the details to the Rheos team with the rheos_report_feedback tool, then carries on with your task.

Want in, or stuck?

Ask for early access, or tell us the app and what you saw, and we'll get you connected.

Get early access What Rheos does in Claude and ChatGPT