Skip to main content
The Rheos connector is in private beta. Ask the Rheos team for access. It lives at:
Everything you need is on Settings → MCP in the Rheos dashboard (dashboard.rheos.app/settings/mcp). Pick your AI under Set up Rheos in to see its steps. There are two ways to connect:
  • Sign in for claude.ai, Claude Desktop, ChatGPT, Claude Code, Codex, Cursor and VS Code. You sign in with your Rheos login. No key needed.
  • API key for tools that cannot sign in, such as a machine that cannot open a browser.
If you connected Rheos before October 2026, remove the connector and add it again.

Connect Claude

These steps work in claude.ai and in Claude Desktop. Connectors you add on claude.ai show up in the Claude app too.
1

Open Connectors

In claude.ai or the Claude app, open Settings → Connectors → Add custom connector.
2

Add Rheos

Paste https://mcp.rheos.app and select Connect.
3

Sign in

Sign in with your Rheos email, the same way you sign in to Rheos.
4

Check it works

Ask “What Rheos brands do I have?” Claude should call rheos_list_brands and list your brands.
Custom connectors are a Claude feature. For how they work, see Anthropic’s guide to getting started with custom connectors.

Connect ChatGPT

Custom MCP servers work in ChatGPT on the web, not in the phone app. Which ChatGPT plan you are on decides what Rheos can do there:
  • Business, Enterprise and Edu: full access, including drafting, scheduling and publishing. On Business, only a workspace admin or owner can add Rheos.
  • Pro: ChatGPT can read from Rheos but cannot make changes.
  • Plus, Go and Free: custom MCP servers are not available.
1

Add a custom MCP server

On chatgpt.com, open Plugins, select +, then Add custom MCP server. If you don’t see the option, turn on Developer mode in Settings → Apps & Connectors → Advanced.
2

Add Rheos

Name it Rheos. Under Connection, paste https://mcp.rheos.app. Under Authentication, choose OAuth.
3

Create it and sign in

Select I understand and want to continue, then Create as a plugin. Sign in with your Rheos email when asked.
4

Use it in a chat

Install the Rheos plugin and start a new chat. Type @ and pick Rheos in each message that should use it. ChatGPT may ask you to confirm before changes such as saving or scheduling a post.
OpenAI renames these controls often. For the current steps, see OpenAI’s guide to connecting custom MCP servers in ChatGPT.

Connect Claude Code

Run this in a terminal:
Then type /mcp in Claude Code, pick rheos, choose Authenticate and sign in with your Rheos email in the browser. No key to copy. You can also paste the setup message from Settings → MCP into Claude Code’s chat. Claude runs the command for you.

Connect Codex

Run these in a terminal:
Codex opens the Rheos sign-in in your browser. Sign in with your Rheos email. No key to copy. You can also paste the setup message from Settings → MCP into Codex’s chat. Codex runs the commands for you.

Connect Cursor or VS Code

1

Add Rheos in one click

On Settings → MCP, pick Cursor or VS Code, then select Add to Cursor or Add to VS Code.
2

Sign in

Your editor asks to install Rheos, then opens the Rheos sign-in. Sign in with your Rheos email.
If the button does nothing, add https://mcp.rheos.app as an MCP server in your editor instead.

Connect with an API key

Use an API key only when your tool cannot sign in. Only an organisation owner or admin can create one. Anyone else on the account can still connect by signing in, or ask an owner or admin for a key.

Create an API key

1

Open MCP

Go to Settings → MCP (dashboard.rheos.app/settings/mcp) and find API keys.
2

Name the key

Select Generate new key, then give it a Key name after the tool that will use it, such as “Cursor — work laptop”. Use one key per tool, so you can revoke one without breaking the rest.
3

Choose whether it can publish

With Allow publishing left off, the key can read your brands and create or edit drafts that you review in Rheos. Select it to also let the key schedule and publish posts to your connected social accounts.
4

Copy the key

Select Generate key and copy the key. It starts with rk_live_. This is the only time the dashboard shows it in full.
Treat a key like a password. Anyone with it can read your brands and create drafts, and publish too if you allowed publishing. Never paste a key into a chat or commit it to git. Use environment variables, a secret manager or your tool’s own credential store.
Keys expire after 90 days. When a key expires, generate a new one and update your tool.

Use the key

For any tool that takes a server URL and a custom header, use these settings, with your key in place of rk_live_your_api_key: Claude Code on a machine that cannot open a browser:
Cursor and other tools that use an mcpServers config, such as ~/.cursor/mcp.json:
Reload the tool afterwards. Rheos should show as connected.

Check the connection

Once connected, each of these prompts should produce a tool call:
  • “List my Rheos brands.” calls rheos_list_brands
  • “Load the context for my first Rheos brand.” calls rheos_get_brand_context
If you connected with a key and your tool shows no Rheos tools, check:
  1. The Authorization header is exact, with the Bearer prefix and no trailing whitespace.
  2. The key has not expired or been revoked. Check Settings → MCP in the dashboard.
  3. Your tool supports the Streamable HTTP transport.
If scheduling or publishing fails because the key does not have the publish scope, the key was created without Allow publishing. Generate a new key with it selected. If you connected by signing in and rheos_get_capabilities says publishing is not granted, remove the connector and add it again. If it still says that, contact Rheos support.

Rotate or revoke a key

Open Settings → MCP in the Rheos dashboard. Each key shows when it was last used, when it was created and when it expires. To revoke a key, select the bin icon next to it and confirm. Any tool using that key stops working immediately, and this cannot be undone. To rotate a key, generate a new one first, update your tool’s config, then revoke the old one.

What to do next

See it in action

Example chats: drafting from a URL, planning a week, filling your strategy’s open slots.

Tools reference

Every tool the connector gives your assistant, with parameters.
Last modified on November 2, 2026