Guide: Using RobinReach with AI (Claude, ChatGPT, Codex)

What This Setup Does

RobinReach connects Claude, ChatGPT, OpenAI Codex, or any MCP-compatible AI to social media management through MCP, so your AI acts as Robin, an AI social media manager that works from a conversation. Once connected, your AI can plan content, write platform-specific posts, schedule content, check analytics, diagnose failed posts, and support campaign workflows.

  • RobinReach remains the system that connects to social profiles, schedules posts, validates platform rules, and manages the dashboard.
  • Your AI (Claude / ChatGPT / Codex / your own agent) becomes the conversational interface for planning, creating, analyzing, and taking action through RobinReach.
  • You can still use the RobinReach dashboard manually; your AI is an addition to the workflow, not a replacement.

One endpoint, every client. The same RobinReach MCP URL works in Claude.ai (web), Claude Desktop, ChatGPT Connectors, OpenAI Codex CLI, and any agent built with the OpenAI Responses API or Anthropic Messages API.

Prerequisites

Requirement What to verify
RobinReach account Create an account from the RobinReach website. Choose a plan, complete sign-up, and validate the subscription through Stripe; trial validation should not charge during the free trial.
RobinReach plan RobinReach pricing lists API & MCP Access on Bloom ($24/month) and Thrive ($49/month), not Seed or Sprout. Use Bloom or Thrive for Claude/MCP access.
Connected social profiles Connect each social platform from the RobinReach dashboard, complete the platform authorization flow, and add the profile or page back into RobinReach.
AI client access See client-specific requirements below.
Trusted connection URL Copy the personal RobinReach connection URL only from Settings → Brand → Connect AI. Treat it like a password.

Per-client access requirements

  • Claude.ai (Web) : custom connectors are available on Free, Pro, Max, Team, and Enterprise (Free is limited to one custom connector).
  • Claude Desktop : free download, requires Node.js for the mcp-remote  bridge.
  • ChatGPT : Connectors require Plus, Pro, Team, or Enterprise. Not available on Free.
  • OpenAI Codex CLI : free; install with npm install -g @openai/codex .
  • OpenAI Responses API / Anthropic SDK  needs API credits with the provider.

Setup: Connect RobinReach to Your AI

Step 1 — Get your personal connection URL.

In RobinReach: Settings → Brand → Connect AI. Click Copy URL. The URL looks like:

https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY

Keep it private, it grants access to your brand.

Claude.ai (Web)

  1. Open claude.ai → click your profile → Settings → Connectors → Add custom connector.
  2. If asked for a name, use RobinReach or Robin.
  3. Paste your RobinReach connection URL → finish adding the connector.
  4. In a new chat, enable the RobinReach connector from the tools menu.
  5. Say "Hi Robin" and start working.

Claude Desktop

  1. Install Node.js if you don't have it.
  2. In Claude Desktop: Settings → Developer → Edit Config. This opens claude_desktop_config.json .
  3. Paste this in (replacing YOUR_API_KEY ):

{
  "mcpServers": {
    "robinreach": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
      ]
    }
  }
}
  1. Save and restart Claude Desktop. Robin appears in your tools.
Plan/admin note. On Team or Enterprise Claude plans, an owner/admin may need to add or approve custom connectors before individual users can connect them. Individual users may still need to authenticate their own access.

ChatGPT (Plus / Pro / Team / Enterprise)

  1. Open chatgpt.com → Settings → Connectors → Add.
  2. Paste your RobinReach connection URL → Save.
  3. ChatGPT auto-discovers the robinreach  tool.
  4. In a new chat, toggle the RobinReach connector on from the tools menu and say "Hi Robin".

OpenAI Codex CLI

  1. Install: npm install -g @openai/codex  (docs at github.com/openai/codex).
  2. Append to ~/.codex/config.toml  (replacing YOUR_API_KEY ):
[mcp_servers.robinreach]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://robinreach.com/mcp/v1/messages?api_key=YOUR_API_KEY"
]
  1. Run codex  — the robinreach  tool appears in the tool list automatically.

OpenAI Responses API / Anthropic SDK (build your own agent)

The endpoint speaks remote MCP natively. Drop it into any agent flow:

from openai import OpenAI
client = OpenAI()
 
response = client.responses.create(
  model="gpt-5",
  tools=[{
    "type": "mcp",
    "server_label": "robinreach",
    "server_url": "https://robinreach.com/mcp/v1/messages",
    "headers": {"Authorization": "Bearer YOUR_API_KEY"}
  }],
  input="Plan a week of posts for Instagram and LinkedIn."
)

What to Ask Robin

Task Example prompt
Weekly planning Plan my social media for the next 7 days. Check what is already scheduled, identify gaps, and draft platform-specific posts.
Campaign execution We are running a summer sale, 25% off everything, ending Sunday. Plan the campaign and schedule drafts for each platform.
Platform-specific posting Create one Instagram post and one LinkedIn post about our new coffee blend. Make each version fit the platform.
Analytics What has been working best this month? Summarize top posts, engagement patterns, and what I should do next.
Failure diagnosis Why did my LinkedIn post fail on Saturday, and what do I need to fix?
Article repurposing Turn this article into social posts for my connected channels: [URL]. Keep each post platform-specific.
Ecommerce Check new Shopify/Etsy/WooCommerce products and draft posts for the best new arrivals.
  1. Ask Robin to list connected profiles and scheduled content. Confirm that the accounts and calendar match what you expect.
  2. Tell Robin your brand basics: audience, products or services, preferred tone, words to use or avoid, and content pillars.
  3. Ask for a one-week content plan in draft mode. Review the ideas before allowing scheduling.
  4. Approve only the posts you want published. Use RobinReach's dashboard or Claude's connector approval prompts to inspect scheduled actions.
  5. After the first posts publish, ask Robin for a performance summary and recommendations for the next week.

Platform-Specific Guidance

RobinReach emphasizes platform-specific customization. Do not ask Robin to copy the same caption everywhere unless that is truly what you want. Better prompts name the platforms and the role of each post.

  • LinkedIn: ask for professional, insight-led copy and company-page context when needed.
  • Twitter/X: ask for short, hook-first posts that respect the 280-character limit.
  • Instagram: ask for visual-first captions, strong opening lines, and hashtags where appropriate.
  • TikTok: ask for energetic hooks and short-form video-friendly language.
  • Facebook: ask for conversational posts and questions that invite comments.
  • Pinterest: ask for a title and descriptive, keyword-rich copy.

Supported Platforms Mentioned by RobinReach

RobinReach's Claude connects to 13 social platforms and specifically mentions Instagram, Facebook, LinkedIn, Twitter/X, TikTok, YouTube, Pinterest, Threads, Bluesky, Telegram, Google Business Profile, Instagram Direct, and more.

Review and Safety Rules

  • Use draft mode when trying a new workflow, new campaign type, or new team process.
  • Review Claude tool approval prompts carefully, especially for actions that create, modify, schedule, publish, or delete content.
  • Keep the RobinReach connection URL private and copy it only from RobinReach Settings -> Connect Claude.
  • RobinReach says social accounts are connected through OAuth and that Claude accesses data through RobinReach's API rather than direct social media passwords or tokens.
  • RobinReach says posts are validated against 40+ platform rules before going live; still review scheduled output for brand, legal, and timing issues.
  • Disconnect the connector from Claude or revoke social profile access in the connected platform if access should end.

Troubleshooting

Issue What to check
AI client can't add the connector Confirm the URL was copied from Settings → Brand → Connect AI. In Claude/ChatGPT, custom connectors live under Settings → Connectors. On Team/Enterprise, ask an owner/admin whether custom connectors are enabled.
ChatGPT says connectors aren't available Custom connectors require ChatGPT Plus, Pro, Team, or Enterprise. They are not available on the Free tier.
Claude Desktop config not working Make sure Node.js is installed (required for the mcp-remote bridge), the JSON in claude_desktop_config.json is valid, and Claude Desktop has been restarted after saving.
Codex doesn't see the robinreach tool Re-check ~/.codex/config.toml — the [mcp_servers.robinreach] block must be present and the URL must include your ?api_key= query string. Restart the Codex session after editing.
Robin cannot see accounts Confirm the social profile was added in RobinReach after the platform authorization flow, not only authorized on the external platform.
Scheduling is wrong Check the brand timezone in RobinReach and the date/time selected for the post.
Post fails validation Check platform character limits, media type, missing required fields (e.g. Pinterest title, YouTube title), expired tokens, and any platform-specific rules shown by RobinReach.
Output is off-brand Give direct feedback in chat: explain what was wrong, restate tone, audience, banned phrases, and preferred content pillars. Robin remembers your preferences across conversations.
API key was leaked or shared Open RobinReach Settings → Brand and regenerate or delete the API key. Every connected AI loses access instantly. Then copy the new URL from Connect AI and re-add it in your AI client.

Source Notes

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.