- 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.
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.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.
Connect Claude Code
Run this in a terminal:/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: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.
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.Use the key
For any tool that takes a server URL and a custom header, use these settings, with your key in place ofrk_live_your_api_key:
Claude Code on a machine that cannot open a browser:
mcpServers config, such as ~/.cursor/mcp.json:
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
- The Authorization header is exact, with the
Bearerprefix and no trailing whitespace. - The key has not expired or been revoked. Check Settings → MCP in the dashboard.
- Your tool supports the Streamable HTTP transport.
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.

