摘要
在任意 AI 智能体中使用 Re:amaze 客服系统:阅读并回复来自邮件、在线聊天和社交渠道的会话,发布回复和内部备注,管理联系人及其备注,以及 FAQ 文章、渠道、客服人员、回复模板、满意度评价和客服报告。
引导式设置
2 分钟将 Re:amaze 连接到 Claude
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Re:amaze,再把你的 MCP URL 添加到 Claude。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
试试这样问
Re:amaze 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Re:amaze、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Re:amaze + Claude
在任意 AI 智能体中使用 Re:amaze 客服系统:阅读并回复来自邮件、在线聊天和社交渠道的会话,发布回复和内部备注,管理联系人及其备注,以及 FAQ 文章、渠道、客服人员、回复模板、满意度评价和客服报告。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
REAMAZE_BRAND, REAMAZE_LOGIN_EMAIL, REAMAZE_API_TOKEN
步骤 1 — 获取凭证
设置大约需要 5 分钟。你需要一个 Re:amaze 账号、其中一个客服人员用户(连接器使用该用户的 API 令牌),以及品牌的主机名。
- 在 Re:amaze 中打开 Settings, Developer, API Token,点击 Generate New Token。把令牌复制到
REAMAZE_API_TOKEN。每个客服人员用户都有自己的令牌,连接器以该用户的身份操作。 - 把
REAMAZE_LOGIN_EMAIL设为该用户登录 Re:amaze 所用的邮箱地址。令牌只有和生成它的用户的邮箱一起使用才有效。 - 把
REAMAZE_BRAND设为品牌的主机名:品牌地址中.reamaze.io之前的部分,可在 Settings, Brand Settings 中看到。对于mybrand.reamaze.io,就是mybrand:只填由字母、数字和连字符组成的名称,不要带https://或.reamaze.io。 - 安装连接器。用
reamaze_list_channels检查连接:它会列出品牌的渠道及其 slug,其他工具把这些 slug 用作category。
Cloud 和自托管的方式相同:连接器通过 HTTPS 使用 HTTP Basic 认证,登录邮箱作为用户名,API 令牌作为密码。不需要 Redirect URL,也不需要 IP 白名单。
每个连接器对应一个品牌:调用发送到 https://<brand>.reamaze.io/api/v1。会话、消息、渠道、FAQ 文章和回复模板都属于该品牌;联系人和客服人员属于整个账号。报告和满意度评价默认涵盖账号下的所有品牌,除非你指定某个品牌。要处理另一个品牌的收件箱,请用该品牌的主机名再设置一个连接器。
连接器以令牌所属用户的身份操作:该客服人员在 Re:amaze 中能看到和能做的,AI 也能看到和能做。除非指定其他发件人,回复和备注都以该用户的名义发出。报告和满意度评价需要该用户拥有 access_reports 权限。
回复会立即发出:reamaze_create_message 使用 visibility 0 时,会立即通过会话的渠道(邮件、在线聊天、短信等)向客户发送回复,所以 AI 会先给你看内容,等你确认。visibility 1 则添加只有客服人员能看到的内部备注。客服人员回复后,Re:amaze 会把会话标为 Done,除非 AI 传入 suppress_autoresolve;满意度调查和通知也可以用同样方式关闭。用 reamaze_create_conversation 新建的会话会照常发送通知,除非设置了 suppress_notifications。
有些更新是整体替换:reamaze_update_conversation 中的 tag_list 会替换会话的全部标签,新的文章正文会替换旧正文,reamaze_create_conversation 中的 user_data 会替换客户已有的数据属性。
ID 和代码:会话用 slug 标识(例如 knock-knock-a1b2c3),渠道也用 slug 标识(例如 support);联系人用邮箱地址标识,或用 E.164 格式的手机号(+12223334444)加上标识类型 mobile;文章用 slug,回复模板用数字 ID。会话状态:0 Open、1 Responded、2 Done、3 Spam、4 Archived、5 On Hold、6 Auto-Done、7 AI Agent Assigned、8 AI Agent Done、9 Spam (AI)。
日期、分页和限流:列表筛选使用 ISO 8601 日期时间;报告使用两个 YYYY-MM-DD 格式的日期,默认最近 30 天,间隔最多一年。列表每页返回 30 条;AI 用 page 获取下一页。API 按令牌每分钟限流,超出时返回 429:稍等后重试。
常见错误:401 表示邮箱或令牌错误,通常是因为邮箱不属于生成令牌的用户。403 表示令牌有效,但该用户缺少权限(报告和评价需要 access_reports)。404 表示 slug 不存在或品牌主机名错误。422 表示 Re:amaze 拒绝了创建或更新,例如联系人已存在;响应中会说明原因。
可读取的内容:会话,包括主题、状态、标签、负责人、渠道、自定义数据和关注者,以及会话中的每条消息(回复和内部备注),包括发件人、收件人和附件;按发件人、渠道、标签或日期筛选的所有会话的消息;联系人及其身份(邮箱、手机号、社交账号)和备注;已发布、草稿和内部的 FAQ 文章;渠道及其设置;客服人员用户和角色;回复模板;带评论的满意度评价;以及关于会话量、响应时间、客服人员、标签和渠道的报告。
写入工具在安装时即已开启:没有任何工具被关闭。AI 可以回复客户并添加内部备注(reamaze_create_message),新建会话(reamaze_create_conversation),修改会话的状态、标签、负责人或渠道(reamaze_update_conversation),创建和更新联系人并添加联系人备注(reamaze_create_contact、reamaze_update_contact、reamaze_add_contact_note),以及创建或编辑 FAQ 文章(reamaze_create_article、reamaze_update_article)。不希望 AI 使用的工具,请在连接器页面关闭。
不支持:删除或编辑联系人备注、编辑联系人身份、创建客服人员用户、Status Page API 以及修改回复模板。没有任何工具会删除内容。
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
步骤 3 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
推荐路径:在 claude.ai web 上工作,无需触碰任何配置文件。
- 在 Claude 中打开 Customize → Connectors。
- 点击 +,然后点击 Add custom connector。
- 输入名称(例如
Re:amaze)和远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。 - 点击 Connect,登录 AnythingMCP(OAuth)并允许访问。
下面所有工具都会出现在你的聊天中,开始输入提示。
可用工具
| Tool | What it does |
|---|---|
reamaze_list_conversations | List conversations of the brand, 30 per page, newest first by creation unless sort says otherwise |
reamaze_get_conversation | Get one conversation: subject, slug, status, tags, first message, last staff and last customer message, author, assignee, channel, custom… |
reamaze_list_conversation_messages | List the messages of one conversation, newest first, 30 per page: body, visibility (0 reply, 1 internal note), origin, created_at, user… |
reamaze_list_messages | List messages across all conversations of the brand, newest first, 30 per page, each with its conversation (subject, slug, channel) |
reamaze_create_conversation | Create a new conversation on behalf of a customer in a channel, with its first message |
reamaze_update_conversation | Update a conversation: status (e.g. 2 Done, 5 On Hold with hold_until), tags (replaces the tag list), custom data, assignee, or move it to… |
reamaze_create_message | Add a message to a conversation. visibility 0 (default) is a reply that Re:amaze sends to the customer at once over the conversation's… |
reamaze_list_contacts | List or search the account's contacts (customers), 30 per page: name, email, friendly_name, mobile and notes |
reamaze_get_contact_identities | List the identities of one contact: each type (email, mobile, twitter, facebook, instagram, igsid) and identifier |
reamaze_create_contact | Create a contact with an email or a mobile number (E.164, e.g. +12223334444) |
reamaze_update_contact | Update a contact's name, friendly name, avatar URL or data attributes, and optionally add notes |
reamaze_list_contact_notes | List all notes on one contact: id, note text, created_at, updated_at and creator (staff name and email) |
reamaze_add_contact_note | Add one note to a contact, optionally attributed to another staff user |
reamaze_list_articles | List or search the brand's FAQ (help center) articles, 30 per page: title, body, slug, status (0 Published, 1 Draft, 4 Internal), url… |
reamaze_get_article | Get one FAQ article by slug: title, full body, status, url, author, topic and timestamps |
reamaze_create_article | Create a FAQ article in a topic. status 1 (Draft) keeps it unpublished for review; 0 publishes it, 4 makes it internal |
reamaze_update_article | Update a FAQ article's title, body or status (0 Published, 1 Draft, 4 Internal) |
reamaze_list_channels | List the brand's channels: name, slug (used as category elsewhere), email, channel type (1 Email, 2 Twitter, 3 Facebook, 6 Chat, 8… |
reamaze_get_channel | Get one channel by slug: name, email, type, visibility, spam filter, reply-from settings, signature, verification state and brand |
reamaze_list_staff | List the account's staff users, 30 per page, oldest first: name, email, created_at and role |
reamaze_list_response_templates | List or search response templates (canned replies) of the brand, including the user's personal ones: id, name, body and template group |
reamaze_get_response_template | Get one response template (canned reply) by id: its name, full body text and template group |
reamaze_list_satisfaction_ratings | List customer satisfaction survey ratings, 30 per page: id, rating (1 to 5), comment, user_id, assignee_id, conversation_id and timestamps |
reamaze_get_report | Get a support report between two dates (default the last 30 days; at least 1 day, at most 1 year). report: volume (conversations per day)… |
示例提示
- “哪些未关闭的会话还没有分配负责人?每位客户想要什么?”
- “给我看与 [email protected] 的最新会话,并根据我们的 FAQ 文章拟一条回复;等我确认后再发送。”
- “在关于延迟送达的会话里添加一条内部备注,说明我们已联系承运商,并把会话设为 On Hold,直到周一。”
- “最近 30 天我们的响应时间有什么变化?团队里谁发出的回复最多?”
- “列出上个月 1 星或 2 星的满意度评价及其评论。”
FAQ
Claude Code 和 Claude Desktop 一样工作吗? 是的,两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
下一步
这份指南对你有帮助吗?