Connect an AI assistant (MCP beta)

    All CollectionsAccount, teams and invoicesConnect an AI assistant (MCP beta)

    Connected AIs lets an AI assistant you already use, such as ChatGPT or Claude, work with your ReplyZen workspace through the Model Context Protocol (MCP). You can ask it how your agents are set up, what happened to a comment, or why an automation did or did not fire. If you allow it, it can also preview and apply a small set of configuration changes.

    The dashboard stays your home for ReplyZen. MCP is a conversational way to inspect the same workspace.

    Private beta and how to request access

    MCP is in private beta for existing ReplyZen customers. ReplyZen turns it on per workspace; owners can't switch it on themselves.

    • Any workspace member can connect an assistant and choose its permissions. Members can revoke their own connections; owners can manage all connections.
    • To request access, go to replyzen.ai/mcp/connect while signed in, or open Settings → Connected AIs and choose Request beta access. You can also email [email protected] with the workspace you want to connect.
    • Once your workspace is enrolled, Settings → Connected AIs shows the setup steps below.

    Which assistants you can use

    ReplyZen MCP supports the assistants below. Setup steps and available actions can change during the private beta.

    AssistantStatus
    ChatGPTBeta
    ClaudeBeta
    CodexEarly
    Claude CodeBeta
    Other MCP clientsNot yet verified

    Every assistant uses the same MCP address:

    https://queues.replyzen.ai/mcp/
    

    ChatGPT

    Works in ChatGPT on the web. On Pro, ChatGPT can read your workspace. On Business, Enterprise, and Edu it can also make changes, if your workspace admin allows custom apps.

    1. Open ChatGPT Plugins, select +, then Add custom MCP server. Name it ReplyZen and add a short description.
    2. Under Connection, paste the MCP address above and choose OAuth for authentication.
    3. Accept the risk warning (I understand and want to continue), then select Create as a plugin. Sign in to ReplyZen when asked, pick the workspace, and review the permissions.
    4. Install the ReplyZen plugin, start a new chat, type @, select ReplyZen, and send the first prompt below.

    See the official ChatGPT setup guide for current instructions. See also plan and workspace requirements.

    Claude

    Works on every Claude plan. Free allows one custom connector. On Team and Enterprise, an owner adds ReplyZen once, then each member connects it.

    1. Open Customize → Connectors, select + Add, then Add custom connector. On Team or Enterprise, an owner uses Organization settings → Connectors → Add → Custom → Web instead.
    2. Name it ReplyZen, paste the MCP address above, and select Continue. Keep the detected sign-in settings and select Continue again.
    3. Choose Sign in now, sign in to ReplyZen, pick the workspace, review the permissions, then select Add. On Team or Enterprise, each member then opens Customize → Connectors and selects Connect next to ReplyZen.
    4. In a chat, select + at the lower left, open Connectors, switch ReplyZen on, and send the first prompt below.

    See the official Claude setup guide for current instructions.

    Codex

    codex mcp add replyzen --url https://queues.replyzen.ai/mcp/
    codex mcp login replyzen
    

    The login command opens ReplyZen in your browser for workspace approval. On a machine without a browser, run codex mcp login replyzen --no-browser, open the printed URL on another device, and paste the full redirect URL back into the terminal.

    See the official Codex setup guide.

    Claude Code

    claude mcp add --transport http --scope user replyzen https://queues.replyzen.ai/mcp/
    

    The --scope user option makes ReplyZen available in every project. Then open Claude Code and run /mcp to review the server and authenticate, or run claude mcp login replyzen from your shell.

    See the official Claude Code setup guide.

    Other MCP clients

    Clients that support Streamable HTTP and OAuth Authorization Code with S256 PKCE can try the same address. We haven't verified any other client yet.

    A good first prompt: "Use ReplyZen to list our active agents and show which pages are assigned to each one."

    What the permissions mean

    When you connect, ReplyZen shows a permission screen. You pick one workspace and choose what the assistant can do there. ReplyZen identifies ChatGPT and Claude clients when their metadata is fetched from a recognized official HTTPS address. Other clients appear as custom clients; their names alone do not prove who built them. Requested permission groups are selected by default, so untick any change permissions you do not want. Check that the return address shown on the permission screen matches the assistant you started from.

    PermissionWhat it allows
    See your ReplyZen setup (always on)Agents and their instructions, automations, pages, and change history. It also includes the text of comments and DM conversations the assistant looks up when it lists comments or explains what happened.
    Change agent settingsTone, moderation, links, and other agent settings, and adding to or replacing an agent's instructions. This changes how future comments and DMs are answered.
    Change automationsEditing triggers and scope, and turning automations on or off. An active automation can send DMs and publish replies to real people.
    Assign pages to agentsMoving pages between agents or taking a page away from all of them. Assigning can start replies, moderation, and DMs on that page; unassigning stops replies and moderation there.

    Publishing controls (auto-publish, publish mode, confidence threshold), comment deletion, and creating or deleting agents and automations are not available over MCP. Use the dashboard for those.

    What the assistant can do

    These are the tools ReplyZen offers. An assistant only sees the ones its permissions allow.

    Read (always available)

    • Verify the connection (whoami)
    • List agents and inspect one agent (list_agents, get_agent)
    • List connected pages and their assigned agents (list_pages)
    • List recent comments and what happened to each, filtered by agent, page, platform, post, outcome, or date (list_comments)
    • Explain what happened to one comment (explain_comment)
    • Check your plan's usage and limits: replies and moderations used this billing period, when they reset, and whether a limit has stopped replies or moderation and since when (get_usage)
    • List automations and inspect one (list_automations, get_automation)
    • List DM conversations and where each stands (answered, waiting, handed off, needs you), filtered by page, the person's name, platform, outcome, or date (list_conversations)
    • Explain one DM conversation message by message: which automations matched, who was allowed to answer, what the AI decided, and whether a reply was actually sent, or why not (explain_conversation)
    • Explain why automations did or did not fire for a comment or DM conversation, including whether anything was actually sent for each DM match (explain_automations)
    • Review agent and automation change history (get_agent_changes, get_automation_changes)
    • Read the writing guide: how ReplyZen uses each instruction field, which settings control links, emojis, tone, length and language, and what to avoid, so text your assistant drafts works the way it reads (get_writing_guide)

    Change (only with the matching permission)

    • Update agent settings and agent instructions (update_agent_settings, update_agent_instructions)
    • Update an automation, or which agents and pages it covers (update_automation, update_automation_scope)
    • Assign or unassign pages (assign_pages, unassign_pages)
    • Revert a recorded agent or automation change (revert_agent_change, revert_automation_change)

    How changes are previewed and confirmed

    Every change happens in two steps:

    1. Preview. The assistant asks ReplyZen for a preview. Nothing is written. ReplyZen returns the exact before and after, plus what it will affect, and a short-lived confirmation.
    2. Confirm. The change is applied only when that exact preview is confirmed. A confirmation works once and expires.

    ReplyZen tells your assistant to show you the preview before it confirms. Whether it actually stops to ask you depends on your assistant's tool-approval settings. If your assistant is set to run tools without asking, it can preview and confirm in one turn. Keep approval prompts on for ReplyZen if you want to OK every change yourself, or connect with read-only access.

    What revert can and cannot undo

    Every change is recorded with who made it. Agent and automation configuration changes can be reverted from the audit trail, as long as nothing else has edited that agent or automation since. A page unassignment can be put back by assigning the page again.

    Revert restores configuration only. It cannot:

    • withdraw replies that were already published
    • recall DMs that were already sent
    • remove likes
    • reverse hides or other moderation that already happened on the platform

    See activity and revoke access

    Open Settings → Connected AIs in your workspace.

    • The connection ledger lists every connected assistant, who connected it, its permissions, and when it was last active.
    • What your AIs did shows recent activity. Previewed means nothing changed; Applied and Reverted changed saved ReplyZen settings. It never shows your assistant conversations.
    • Members can revoke their own connections. Owners can rename or revoke any connection. Revoking disconnects it immediately. Changes it already applied stay in place, and reconnecting starts a fresh permission review.

    If MCP is turned off for your workspace, existing connections stop working but still appear in Connected AIs, so members can revoke their own connections and owners can revoke any connection before MCP is turned back on.

    Feedback

    Tell us what you want your assistant to do next from the support chat in your ReplyZen dashboard, or email [email protected]. Your assistant can't send feedback to ReplyZen for you.