Connect REP AI to the AI assistant you already use, such as Claude or ChatGPT, and ask about your store in plain language. Your assistant reads your REP AI data and answers questions like "What did shoppers ask about most last week?" or "How did REP AI perform this month compared with last month?" You don't need to open the REP AI Console or export reports.
Your assistant can also help you fix wrong answers. It can propose a change to your global AI instructions, your custom FAQs, or the instructions of your Sales and Support skills. Change permissions are off unless you turn them on, and nothing changes until you say yes in the chat.
Every assistant connects to the same REP AI address:
https://mcp.hellorep.ai/mcp/v1
Jump to your assistant:
What you can ask your assistant
| Ask about | Example question | Permission it needs |
|---|---|---|
| Performance: conversations, engagement, AI-generated sales, conversion and orders, compared with the previous period | "How did REP AI perform last month compared with the month before?" | How REP AI is performing |
| Conversation topics: what shoppers talk about, and how often REP AI helped | "What did shoppers ask about most in the last 30 days?" | How REP AI is performing |
| Customer problems: where shoppers get stuck, such as high shipping costs or missing product information | "Where do shoppers get stuck on my store?" | How REP AI is performing |
| Support workload: how many support emails REP AI handled and how they were resolved | "How many support emails did REP AI resolve this week?" | How much support email Rep handled |
| Specific conversations: filtered by date, topic, problem, shopper emotion, satisfaction or channel | "Show me conversations from frustrated shoppers last week." | What shoppers talked about, and how it went |
| One shopper's history: every conversation with a shopper, found by their email address | "What happened with alex@example.com?" | What shoppers talked about, and how it went and Who the shopper was |
| Fix a wrong answer: add or edit a global AI instruction, a custom FAQ, or a skill's instructions | "Shoppers keep asking about free shipping and the AI answers wrong. Fix it." | Global AI instructions, Custom FAQs, or Sales & Support skill instructions |
Your assistant can combine these. For example: "Find the top three customer problems this month, and show me two conversations for each. Then fix the answer for the most common one."
Before you start
- You need a REP AI account for your store.
- You need the admin role on that store in the REP AI Console. If you are not an admin, ask an admin of your store to make the connection.
- Your assistant's plan must allow custom connections. The Claude section below explains what Claude needs.
How connecting works
The steps differ a little in each assistant, but every connection ends the same way:
- You add REP AI in your assistant with the address above.
- The REP AI login page opens. Sign in to the REP AI Console.
- If you manage more than one store, select the store to connect.
- Under What … will be able to see (the screen shows your assistant's name), select the information your assistant may read. See "Choose what your assistant can see" below.
- Check the Let the assistant read what shoppers wrote switch. It is on by default. Turn it off if your assistant should not see message text.
- Under Let your assistant change your AI, tick what your assistant may change. These are off unless you tick them. Leave them off if your assistant should only read.
- Click Connect. You return to your assistant, and REP AI is ready to use.
Claude
Who can set it up:
- Free plan: you can add one custom connector.
- Team and Enterprise: an organization owner adds the REP AI connector first. Members then connect it to their own REP AI store.
Set it up in Claude (claude.ai, or the desktop app):
- Open Settings → Connectors.
- Add REP AI in one of two ways:
- From the connector directory: browse or search for REP AI, then click Connect.
-
As a custom connector: click Add custom connector, name it REP AI, paste
https://mcp.hellorep.ai/mcp/v1, click Add, then click Connect next to REP AI.
- The REP AI login page opens. Sign in and approve the connection (see "How connecting works" above).
- Ask your question in any Claude chat. Connectors you add on claude.ai also work in the Claude desktop and mobile apps.
For more detail, see Ask Claude About Your Store: Connect REP AI to Claude.
ChatGPT
- In ChatGPT, open Plugins, search for REP AI and connect it.
- Sign in with your REP AI login and pick your store.
- On the consent screen, only the two narrowest read options start ticked. Changing your AI stays off until you tick it.
- Ask your first question in any ChatGPT chat.
Every change ChatGPT suggests waits for your yes in the chat, and each one is saved in the Audit Log, where you can revert it.
Other assistants
REP AI works with assistants and tools that support remote MCP servers. Use the address https://mcp.hellorep.ai/mcp/v1.
Claude Code:
- In your terminal, run:
claude mcp add --transport http rep-ai https://mcp.hellorep.ai/mcp/v1 - In Claude Code, run
/mcp, select rep-ai, and choose to authenticate. - Your browser opens the REP AI login page. Sign in and approve the connection.
Any assistant that supports remote MCP servers: add a remote server with the address above. If the assistant supports OAuth sign-in, it opens the REP AI login page for you.
Clients that can't sign in but can send a header: create a key in the REP AI Console instead.
- Open the account menu, then click API.
- In Connections (MCP), click Use a key instead. Name the connection, choose what it can see, and create it.
- Copy the secret. It is shown only once.
- Send it with every request as the header
Authorization: Bearer <your secret>. For example, in Claude Code:claude mcp add --transport http rep-ai https://mcp.hellorep.ai/mcp/v1 --header "Authorization: Bearer <your secret>"
Keep the secret private, like a password.
Choose what your assistant can see and change
You decide what your assistant may read, and whether it may change anything. Select only what you need. When you connect through a sign-in page, the first two permissions are selected by default. You must select the others yourself.
| Permission | What your assistant can see |
|---|---|
| How REP AI is performing | Store-wide performance figures, and the topics and customer problems summarized across all your conversations. |
| What shoppers talked about, and how it went | For each conversation: its topics, the problem the shopper had, how they seemed to feel, satisfaction, timings, tags, and whether an order followed. Not the messages themselves. |
| The actual messages | The messages exchanged between your shoppers and REP AI. |
| Who the shopper was | The name, email address and phone number of the shoppers in your conversations. |
| How much support email Rep handled | How many support tickets REP AI handled and how they were resolved. |
Let the assistant read what shoppers wrote works together with The actual messages. Your assistant sees message text only when both are on. When either is off, it can see how many conversations there were, what they were about and how they ended, but not the messages.
Your assistant can answer a question only when the connection has the permission that question needs (see the table at the top). If a permission is missing, your assistant tells you it can't answer that question. Add the permission in the REP AI Console and ask again.
What your assistant can change. These permissions are off unless you tick them, and a store admin must approve them.
| Permission | What your assistant can do |
|---|---|
| Global AI instructions | Read your global AI instructions, add new ones and edit existing ones. It can't remove them. |
| Custom FAQs | Read your custom FAQs, add new ones and edit their question and answer. It can't delete them. |
| Sales & Support skill instructions | Read and edit the instructions of your existing Sales and Support skills. It can't create, delete, turn on or turn off a skill, or change refund and other permissions. |
How changes work
Every change goes through the same steps, so you stay in control:
- Ask your assistant to fix something, for example a wrong answer about shipping.
- Your assistant reads what is there now, then proposes the smallest change that fixes it.
- Your assistant shows you the text before and after the change.
- Say yes to apply it. If you say no, or ask for something else, nothing changes.
- The change goes live on the next shopper message.
Every change appears in your Audit Log under your name, with the name of the assistant that made it. You can revert any change there with one click.
A proposal can be applied once and expires after a few minutes. If someone edits the same item in the Console before you say yes, your assistant has to propose the change again.
Your assistant can only change global AI instructions, custom FAQs, and the instructions of your existing Sales and Support skills. It can never delete anything, turn a skill on or off, or change triggers, targeting, chips, product links, refund or other action permissions, API endpoints, widget design, billing or integrations. Make those changes in the REP AI Console.
Manage or disconnect
In the REP AI Console:
- Open the account menu, then click API.
- Go to Connections (MCP). Each connection shows what it can see and change, who approved it, and when it was last used.
- To change what an assistant can see or change, click Edit on its connection. Change the permissions or the message-text switch, then click Save changes. You don't need to reconnect.
- To disconnect an assistant, click Revoke on its connection, then confirm.
When you revoke a connection, the assistant loses access right away. A revoked connection can't be turned back on. To connect again, start again from your assistant and approve the new request.
Every member of your store can see the list of connections. Only an account admin can edit or revoke them.
In your assistant: you can also remove REP AI from your assistant's settings. To make sure access ends on the REP AI side too, also revoke the connection in the REP AI Console.
Troubleshooting
"Only an account admin can connect an AI assistant to this store."
You are not an admin of that store. Ask an admin of the store to make the connection, or to give you the admin role.
"AI assistant connections are not on this store's plan."
Contact us and we'll help you turn them on.
"This connection request is no longer valid."
The request expired or was already answered. Start the connection again from your assistant.
Your assistant can't find the option to add a custom connection.
Your assistant's plan or account type may not allow it. For Claude, check "Who can set it up" in the Claude section above.
Your assistant says there is no data for a period.
REP AI reports only from the day your store started using REP AI. Topics and customer problems update once a day, so today's conversations appear in them the next day. Conversation search goes back up to one year. A lookup of one shopper by email has no date limit.
Support email figures are empty.
Support workload covers REP AI's AI email answering. If AI email answering is not connected for your store, there is nothing to report.
Your assistant can't answer a question about conversations or a specific shopper.
The connection doesn't have the permission that question needs. Check the table at the top of this article. Then add the permission with Edit in the REP AI Console.
Your assistant says it can't change your AI.
The connection doesn't have the change permission for that item. Tick Global AI instructions, Custom FAQs, or Sales & Support skill instructions with Edit in the REP AI Console. If changes through assistants are switched off for your store, contact us.
Your assistant says a proposal expired or the item changed.
A proposal lasts a few minutes, and it is refused if someone edited the same item first. Ask your assistant to propose the change again.
Days look slightly different from the REP AI Console.
REP AI counts whole days in UTC (Coordinated Universal Time) when it answers your assistant. Your Console may show your local time, so the first or last day of a period can differ slightly.
Your data and privacy
- Your assistant changes your AI only after you say yes in the chat. Every change is recorded in your Audit Log and can be reverted.
- REP AI sends data only when your assistant asks for it to answer your question, and only within the permissions you approved.
- REP AI marks text written by shoppers as information to report on, not instructions to follow. It is never your approval.
- Data your assistant receives is handled under your assistant provider's own terms and privacy policy.
- You can change permissions or revoke a connection at any time in the REP AI Console.
- See the REP AI privacy policy: https://www.hellorep.ai/legal/privacy-policy
Technical details
For developers and reviewers.
-
Server address:
https://mcp.hellorep.ai/mcp/v1(Streamable HTTP) -
Sign-in: OAuth 2.1 with PKCE. The merchant signs in and approves the connection in the REP AI Console. Clients that can't use OAuth can use a scoped key from the REP AI Console, sent as
Authorization: Bearer <secret>. -
Access: read tools are marked read-only. Change tools only propose a change and return the before and after. A change is applied only by
apply_approved_change, which needs the merchant's approval in the conversation, and only for the object types the connection may change. - Tools and the permissions they need:
| Tool | What it answers | Permission (scope) |
|---|---|---|
get_rep_performance |
Performance figures for a period, compared with the previous period | How REP AI is performing (analytics.read) |
get_conversation_topics |
What shoppers talk about, with counts | How REP AI is performing (analytics.read) |
get_customer_problems |
Where shoppers get stuck, with counts | How REP AI is performing (analytics.read) |
get_support_workload |
Support emails REP AI handled and how they were resolved | How much support email Rep handled (support.read) |
search_conversations |
Conversations filtered by date, topic, problem, emotion, satisfaction or channel | What shoppers talked about, and how it went (tickets.read). Message text also needs The actual messages (messages.read). Shopper details also need Who the shopper was (customers.read). |
get_shopper_conversations |
Every conversation with one shopper, by email address | What shoppers talked about, and how it went (tickets.read) and Who the shopper was (customers.read). Message text also needs messages.read. |
get_ai_instructions |
Reads the global AI instructions | Global AI instructions (instructions.write) |
propose_instruction_change |
Proposes adding or rewording one global AI instruction | Global AI instructions (instructions.write) |
find_faqs |
Searches the custom FAQs | Custom FAQs (faqs.write) |
propose_faq_change |
Proposes a new FAQ, or a new question or answer for an existing one | Custom FAQs (faqs.write) |
get_skill_instructions |
Reads the instructions of the Sales and Support skills | Sales & Support skill instructions (skills.write) |
propose_skill_change |
Proposes new instruction text for one existing skill | Sales & Support skill instructions (skills.write) |
apply_approved_change |
Applies one proposal that the merchant approved. Single use, expires after a few minutes, and is refused if the item changed since. | The permission of the proposal's object type |
Need help? Contact REP AI support from the REP AI Console, or email support@hellorep.ai.