指南 · 门店店主

AI 连接：将您的 AI 助手连接到门店

在您已经在用的 AI 应用里询问营收、日程或需要跟进的顾客，还能让它帮您起草促销或课程。Bukujanji 为每家门店提供一个 MCP 服务器；用哪个 AI 应用由您选择，权限也由您授予。

适用对象: 门店店主账户
方案: Pro 和 Enterprise
服务器地址: https://api.bukujanji.com/mcp/{outlet-slug}
登录方式: OAuth + 授权确认页面

什么是 AI 连接

AI 连接通过 MCP 协议（Model Context Protocol）将第三方 AI 应用（例如 ChatGPT、Claude、Gemini 或 Grok）连接到一家 Bukujanji 门店。连接后，AI 应用可以调用我们提供的一组工具来读取门店数据；在您允许的情况下，还可以创建或修改部分数据。

AI 连接面向门店店主，而非顾客。AI 应用由您自行选择并付费；Bukujanji 只在您授予的权限范围内，发送该应用所请求的数据。

谁可以使用

仅限门店的店主账户。员工账户尝试连接时会被拒绝，因为是否把顾客数据发送给 AI 服务商，应由店主决定。
门店须使用 Pro 或 Enterprise 方案。Starter 方案的门店会被引导至升级页面。方案要求取自“设置 → AI 连接”页面的规则，因此如果 Bukujanji 管理员为您的门店设置了例外，情况可能有所不同。
如果您账户下任何一家门店开启了两步验证（2FA），该账户暂时无法通过此流程登录——对所有门店都是如此；登录页面会建议您改为直接在 Bukujanji 登录。
您需要一个支持自定义 MCP 连接器的 AI 应用账户。是否提供该功能以及需要哪种方案，由该 AI 服务商决定。

WhatsApp 提醒和 WhatsApp 收件箱使用门店自己的 WhatsApp 号码，需要开通 Easy Booking by WhatsApp 附加项。

服务器地址及查找位置

每家门店都有自己的服务器地址，以门店的 slug 结尾。一个连接只对应一家门店；如需连接其他门店，请使用该门店的地址。

https://api.bukujanji.com/mcp/{outlet-slug}

用店主账户登录商家后台。
打开“设置 → AI 连接”。
在“各门店 URL”下选择门店，然后点击“复制 URL”。

如果提示门店还没有 slug，请先在“网站 CMS”中设置门店网站地址。不带 slug 的服务器地址（…/mcp）不提供服务。

如何连接

所有 AI 应用的流程都相同：把门店的服务器地址粘贴为连接器，用店主账户登录，然后阅读并确认授权页面。各应用的菜单名称可能随时间变化；如与下文不一致，请以服务商的官方说明为准。

Claude（claude.ai）：打开 Connectors 设置，添加自定义连接器，为其命名并粘贴门店的服务器地址。然后在弹出的 Bukujanji 窗口中完成登录和授权。

ChatGPT（chatgpt.com）：在设置中开启 Developer mode，然后添加自定义连接器/插件，粘贴门店的服务器地址，并选择 OAuth 认证。此功能取决于您的 ChatGPT 方案，且需在网页端设置，而非手机 App。

其他 MCP 客户端（Gemini、Grok 或任何其他 MCP 应用）：添加一个远程 MCP 服务器（Streamable HTTP），填写门店的服务器地址并选择 OAuth 认证。客户端会自动完成注册（动态客户端注册）。并非每个服务商的所有方案或地区都允许使用自定义连接器。

出现 Bukujanji 登录页面时，请使用您所粘贴地址对应门店的店主账户登录。如果浏览器中仍保留着其他账户的登录状态，请求会被拒绝，而 AI 应用往往只显示“connection can't be made”之类的笼统提示。请先退出旧的登录，再重试。

所需权限

权限	含义
outlet:read	读取门店数据：日程与预约、顾客、报表、服务目录与价格、促销、课程、待跟进事项，以及钱包（仅金额）。始终开启。如需关闭，请撤销连接。
catalog:write	设置基础数据：创建服务、桌台/场地、每周课程、房间、员工和套餐；设置营业时间、退款/改期政策、休息日和锁定时段；修改现有项目的价格、名称、描述和容量；启用或停用项目。
promos:write	创建促销和优惠券码，并受以下限制：折扣最多 50% 或 Rp 1.000.000，有效期最长 90 天，优惠券必须设置数量上限。
bookings:write	用顾客的有效套餐预订课程名额，将课程预约改到其他场次，填写原因后取消预约（退款按门店政策执行），以及标记出勤。
customers:write	登记新顾客（课程类门店可同时登记孩子/学员），为现有顾客添加孩子/学员，以及添加顾客备注。
messages:write	通过门店的 WhatsApp 号码发送模板化 WhatsApp 提醒（预约提醒、套餐即将到期、剩余次数不足），每次调用发送给一位顾客。
inbox:write	读取 WhatsApp 收件箱（顾客姓名、号码和聊天内容会发送给 AI 服务商），并在您确认具体文字后回复一个会话。除非您勾选，否则不开启。

您可以随时在“设置 → AI 连接”中对相应连接点击“修改权限”来更改写入权限，无需重新连接。更改约一分钟后生效。

读取工具

读取工具不会更改任何数据，AI 应用可在连接的权限范围内随时调用。

工具	作用
get_outlet_context	门店资料：名称、时区、营业时间，以及启用中的服务、场地和课程列表及其 ID。
explain_capabilities	说明通过此连接可以做什么、不能做什么。
get_agenda	某一天或最多 7 天范围内的日程：课程场次（含学员和剩余名额）、服务/场地到访、套餐购买和取消。
check_availability	某一天的占用情况：营业时间、停业、锁定时段、员工请假和空余名额。
get_booking	按交易编号查询一笔预约的详情，包括金额明细（小计、折扣、总计、已付、待付）。
search_customers	按条件搜索或列出顾客（N 天未到店、某门课程、有有效套餐等），并统计人数。不含出生日期或备注。
get_follow_ups	现成的待关注名单：未付款预约、即将到期的套餐、剩余次数不足、久未到店的顾客、明天的场次。
get_report_summary	按时段的报表，数字与后台“报表”/“销售”菜单一致（营收、预约、按服务、按员工、付款方式等）。
get_price_list	价目表：带规格的服务、桌台/场地费率、课程价格和特价。
get_promotions	促销和优惠券码：金额、已使用数量、有效期和状态。不含顾客数据。
get_classes	课程及其固定课表、讲师、容量和价格。
get_wallet	门店钱包（只读）：余额、冻结余额、最近的资金变动和最近的提现记录。不含银行账号。
get_setup_status	新门店的就绪情况：还缺少哪些设置，以及尚未决定的退款/改期政策风险。
get_whatsapp_inbox	读取 WhatsApp 收件箱的会话列表和聊天内容。需要 inbox:write 权限。
request_capability	将无法满足的需求记录为功能候选，供 Bukujanji 团队评估（不含顾客个人数据）。

写入工具与两步确认

所有写入工具都分两步执行。第一步，AI 应用在不带确认的情况下调用工具，获得一份预览，准确列出将要创建或更改的内容，并附有确认码。这份预览会展示给您。只有您在对话中确认后，AI 应用才会用相同的参数加上确认标记和确认码再次调用。确认码由预览内容计算得出，因此与您所见不同的更改会被拒绝。

工具	作用	权限
create_service	创建带价格规格的新服务。	catalog:write
create_court	创建带费率的新桌台/场地/租用空间。	catalog:write
create_class	创建带每周课表的新课程；课节会自动生成。	catalog:write
update_catalog_item	修改现有项目的价格、名称、描述、是否可在线预约以及课程容量。不修改课程课表或分类。	catalog:write
set_catalog_item_status	停用或重新启用服务、场地、课程、促销或优惠券。数据会保留。	catalog:write
setup_outlet	填写营业时间、房间、员工、员工排班、员工与服务的关联、套餐、退款/改期政策、休息日和锁定时段。	catalog:write
create_promo	创建自动折扣促销。	promos:write
create_voucher	创建带数量上限的优惠券码。	promos:write
book_package_seat	用顾客的有效套餐预订课程名额（扣次，无需付款）。	bookings:write
reschedule_booking	将课程场次预约改到同一课程的其他场次（须填写原因）。	bookings:write
cancel_booking	填写原因后取消一笔预约；退款影响会显示在预览中。	bookings:write
mark_attendance	标记已到场，或撤销标记。	bookings:write
create_customer	登记新顾客，课程类门店可同时登记孩子/学员。	customers:write
add_participant	为现有顾客添加孩子/学员（课程类门店）。	customers:write
add_customer_note	为顾客添加备注；不会读取或删除之前的备注。	customers:write
send_whatsapp_reminder	向一位顾客发送一条模板化 WhatsApp 提醒。	messages:write
reply_whatsapp_chat	用您逐字确认过的文字回复一个收件箱会话。	inbox:write

刻意不支持的操作

删除任何内容。“移除”某项内容的唯一方式是停用它。
更改场地或服务预约的时间（课程场次预约可以改期）。
创建新的收费预约。通过 AI 连接创建的新预约只能是使用有效套餐的名额。
记录付款、退款或提现。钱包为只读。
更改员工权限和登录账户，或网站设置。
编辑现有的促销或优惠券（只能新建或停用），或修改服务和场地的价格、名称、描述和状态以外的内容。
向从未与门店聊过天的号码发送自由文本消息、群发消息，或发送提醒模板以外的自由文本消息。
访问其他门店的数据。令牌只绑定一家门店。

如果您提出的需求没有对应的工具，AI 应用会按指示将其记录为功能候选（不含顾客个人数据），并告诉您该操作仍需在后台完成。

使用限制

顾客数据：在批量列表工具（search_customers 和 get_follow_ups）上，每个连接每天最多 500 行（姓名和电话号码）。“天”按门店时区计算，午夜重置。只统计人数的查询（countOnly）不占用额度。如需完整名单，请使用后台的“顾客”菜单，可导出。
频率：每个连接每分钟最多 60 次请求。
访问令牌有效期为 1 小时，AI 应用会用刷新令牌自动续期（有效期 30 天，每次使用后更换）。如果连接中断，请从 AI 应用重新连接。
每次调用的日程范围最多 7 天。
促销和优惠券的折扣上限见上方权限表。
AI 应用可能出错。请在确认前仔细检查每份预览。

会发送的数据

Bukujanji 不会主动向 AI 服务商推送数据。只有当您的 AI 应用调用工具时，数据才会在连接的权限范围内发出。根据授权确认页面，可能发送的数据类别包括：

日程与预约：顾客姓名、电话号码、服务、时间，以及员工填写的预约备注和取消原因。
顾客名单：姓名、电话、最近一次到店。
报表汇总：营收数字和预约数量。
服务目录与价格：服务、桌台/场地、课程、促销、优惠券、价目表。
套餐与待跟进事项：即将到期的套餐、剩余次数、未付款预约、久未到店的顾客。
钱包：门店余额、结算和提现记录（仅金额，不含银行账号）。
WhatsApp 收件箱聊天内容，仅在您勾选 inbox:write 权限时发送。

不会发送：出生日期、之前保存的顾客备注，以及其他门店的数据。数据到达 AI 服务商后，其存储和使用遵循该服务商的隐私政策；部分个人方案可能会使用对话内容训练模型，除非您在服务商的设置中关闭。作为门店店主，由您决定发送这些顾客数据，并就其法律依据对您的顾客负责。

每次调用时，Bukujanji 会保存一条活动记录：工具名称、是否成功、耗时，以及经过遮盖的参数（自由文本只保留前两个字符和长度）。返回给 AI 应用的内容不会保存在该记录中。详情见《隐私政策》第 5.1 节。

撤销连接

打开“设置 → AI 连接”，在相应连接上点击“撤销”。连接会从下一次请求起停止（最迟约一分钟），令牌也无法再续期。
在账户设置页面修改密码，会自动撤销该账户的所有 AI 连接。通过“忘记密码”重置密码目前不会撤销连接——如果您怀疑账户被他人访问，请手动撤销连接。
“修改权限”可开启或关闭写入权限，无需重新连接。读取权限无法单独关闭；如需关闭，请撤销连接。
“历史记录”显示每个连接最近 20 次操作。
仅在 AI 应用中删除连接器，并不会撤销 Bukujanji 端的授权。请同时在后台撤销。

撤销连接不会删除 AI 服务商已经收到的数据。如需删除，请联系您所使用的 AI 应用的服务商。

提问示例

先从提问开始，授予写入权限后再加入操作类指令。

“上个月营收是多少？本周谁的套餐到期？”
“下周三有哪些场次？还有名额吗？”
“谁还没付款？”
“我的余额是多少？上一次提现是什么时候？”
“为烹饪课创建一个 9 折促销，有效期到月底。”（AI 会先给您看预览）
“用 Ani 女士的套餐帮她预约周六 10:00 的场次。”
“把 Camille 从周六 10:00 的课改到周日 10:00。”
“给明天场次的学员发送 WhatsApp 提醒。”
“我的门店是新开的，开始接受预约前还缺什么？”

问题排查与支持

“Connection can't be made”：请确认您使用的是与服务器地址相符的门店店主账户登录，并退出浏览器中其他 Bukujanji 登录状态。
Starter 门店：AI 连接需要 Pro 或 Enterprise 方案。
AI 应用提示缺少权限：在该连接上打开“修改权限”，开启所需权限。
顾客名单被截断：该连接当天的顾客数据额度已用完；请改用统计人数的提问，或使用后台的“顾客”菜单。

其他帮助及个人数据相关请求：请发送邮件至 support@bukujanji.com。

什么是 AI 连接

AI 连接面向门店店主，而非顾客。AI 应用由您自行选择并付费；Bukujanji 只在您授予的权限范围内，发送该应用所请求的数据。

谁可以使用

仅限门店的店主账户。员工账户尝试连接时会被拒绝，因为是否把顾客数据发送给 AI 服务商，应由店主决定。
门店须使用 Pro 或 Enterprise 方案。Starter 方案的门店会被引导至升级页面。方案要求取自“设置 → AI 连接”页面的规则，因此如果 Bukujanji 管理员为您的门店设置了例外，情况可能有所不同。
如果您账户下任何一家门店开启了两步验证（2FA），该账户暂时无法通过此流程登录——对所有门店都是如此；登录页面会建议您改为直接在 Bukujanji 登录。
您需要一个支持自定义 MCP 连接器的 AI 应用账户。是否提供该功能以及需要哪种方案，由该 AI 服务商决定。

WhatsApp 提醒和 WhatsApp 收件箱使用门店自己的 WhatsApp 号码，需要开通 Easy Booking by WhatsApp 附加项。

服务器地址及查找位置

每家门店都有自己的服务器地址，以门店的 slug 结尾。一个连接只对应一家门店；如需连接其他门店，请使用该门店的地址。

https://api.bukujanji.com/mcp/{outlet-slug}

用店主账户登录商家后台。
打开“设置 → AI 连接”。
在“各门店 URL”下选择门店，然后点击“复制 URL”。

如果提示门店还没有 slug，请先在“网站 CMS”中设置门店网站地址。不带 slug 的服务器地址（…/mcp）不提供服务。

如何连接

Claude（claude.ai）：打开 Connectors 设置，添加自定义连接器，为其命名并粘贴门店的服务器地址。然后在弹出的 Bukujanji 窗口中完成登录和授权。

所需权限

权限	含义
outlet:read	读取门店数据：日程与预约、顾客、报表、服务目录与价格、促销、课程、待跟进事项，以及钱包（仅金额）。始终开启。如需关闭，请撤销连接。
catalog:write	设置基础数据：创建服务、桌台/场地、每周课程、房间、员工和套餐；设置营业时间、退款/改期政策、休息日和锁定时段；修改现有项目的价格、名称、描述和容量；启用或停用项目。
promos:write	创建促销和优惠券码，并受以下限制：折扣最多 50% 或 Rp 1.000.000，有效期最长 90 天，优惠券必须设置数量上限。
bookings:write	用顾客的有效套餐预订课程名额，将课程预约改到其他场次，填写原因后取消预约（退款按门店政策执行），以及标记出勤。
customers:write	登记新顾客（课程类门店可同时登记孩子/学员），为现有顾客添加孩子/学员，以及添加顾客备注。
messages:write	通过门店的 WhatsApp 号码发送模板化 WhatsApp 提醒（预约提醒、套餐即将到期、剩余次数不足），每次调用发送给一位顾客。
inbox:write	读取 WhatsApp 收件箱（顾客姓名、号码和聊天内容会发送给 AI 服务商），并在您确认具体文字后回复一个会话。除非您勾选，否则不开启。

您可以随时在“设置 → AI 连接”中对相应连接点击“修改权限”来更改写入权限，无需重新连接。更改约一分钟后生效。

读取工具

读取工具不会更改任何数据，AI 应用可在连接的权限范围内随时调用。

工具	作用
get_outlet_context	门店资料：名称、时区、营业时间，以及启用中的服务、场地和课程列表及其 ID。
explain_capabilities	说明通过此连接可以做什么、不能做什么。
get_agenda	某一天或最多 7 天范围内的日程：课程场次（含学员和剩余名额）、服务/场地到访、套餐购买和取消。
check_availability	某一天的占用情况：营业时间、停业、锁定时段、员工请假和空余名额。
get_booking	按交易编号查询一笔预约的详情，包括金额明细（小计、折扣、总计、已付、待付）。
search_customers	按条件搜索或列出顾客（N 天未到店、某门课程、有有效套餐等），并统计人数。不含出生日期或备注。
get_follow_ups	现成的待关注名单：未付款预约、即将到期的套餐、剩余次数不足、久未到店的顾客、明天的场次。
get_report_summary	按时段的报表，数字与后台“报表”/“销售”菜单一致（营收、预约、按服务、按员工、付款方式等）。
get_price_list	价目表：带规格的服务、桌台/场地费率、课程价格和特价。
get_promotions	促销和优惠券码：金额、已使用数量、有效期和状态。不含顾客数据。
get_classes	课程及其固定课表、讲师、容量和价格。
get_wallet	门店钱包（只读）：余额、冻结余额、最近的资金变动和最近的提现记录。不含银行账号。
get_setup_status	新门店的就绪情况：还缺少哪些设置，以及尚未决定的退款/改期政策风险。
get_whatsapp_inbox	读取 WhatsApp 收件箱的会话列表和聊天内容。需要 inbox:write 权限。
request_capability	将无法满足的需求记录为功能候选，供 Bukujanji 团队评估（不含顾客个人数据）。

写入工具与两步确认

工具	作用	权限
create_service	创建带价格规格的新服务。	catalog:write
create_court	创建带费率的新桌台/场地/租用空间。	catalog:write
create_class	创建带每周课表的新课程；课节会自动生成。	catalog:write
update_catalog_item	修改现有项目的价格、名称、描述、是否可在线预约以及课程容量。不修改课程课表或分类。	catalog:write
set_catalog_item_status	停用或重新启用服务、场地、课程、促销或优惠券。数据会保留。	catalog:write
setup_outlet	填写营业时间、房间、员工、员工排班、员工与服务的关联、套餐、退款/改期政策、休息日和锁定时段。	catalog:write
create_promo	创建自动折扣促销。	promos:write
create_voucher	创建带数量上限的优惠券码。	promos:write
book_package_seat	用顾客的有效套餐预订课程名额（扣次，无需付款）。	bookings:write
reschedule_booking	将课程场次预约改到同一课程的其他场次（须填写原因）。	bookings:write
cancel_booking	填写原因后取消一笔预约；退款影响会显示在预览中。	bookings:write
mark_attendance	标记已到场，或撤销标记。	bookings:write
create_customer	登记新顾客，课程类门店可同时登记孩子/学员。	customers:write
add_participant	为现有顾客添加孩子/学员（课程类门店）。	customers:write
add_customer_note	为顾客添加备注；不会读取或删除之前的备注。	customers:write
send_whatsapp_reminder	向一位顾客发送一条模板化 WhatsApp 提醒。	messages:write
reply_whatsapp_chat	用您逐字确认过的文字回复一个收件箱会话。	inbox:write

刻意不支持的操作

删除任何内容。“移除”某项内容的唯一方式是停用它。
更改场地或服务预约的时间（课程场次预约可以改期）。
创建新的收费预约。通过 AI 连接创建的新预约只能是使用有效套餐的名额。
记录付款、退款或提现。钱包为只读。
更改员工权限和登录账户，或网站设置。
编辑现有的促销或优惠券（只能新建或停用），或修改服务和场地的价格、名称、描述和状态以外的内容。
向从未与门店聊过天的号码发送自由文本消息、群发消息，或发送提醒模板以外的自由文本消息。
访问其他门店的数据。令牌只绑定一家门店。

如果您提出的需求没有对应的工具，AI 应用会按指示将其记录为功能候选（不含顾客个人数据），并告诉您该操作仍需在后台完成。

使用限制

顾客数据：在批量列表工具（search_customers 和 get_follow_ups）上，每个连接每天最多 500 行（姓名和电话号码）。“天”按门店时区计算，午夜重置。只统计人数的查询（countOnly）不占用额度。如需完整名单，请使用后台的“顾客”菜单，可导出。
频率：每个连接每分钟最多 60 次请求。
访问令牌有效期为 1 小时，AI 应用会用刷新令牌自动续期（有效期 30 天，每次使用后更换）。如果连接中断，请从 AI 应用重新连接。
每次调用的日程范围最多 7 天。
促销和优惠券的折扣上限见上方权限表。
AI 应用可能出错。请在确认前仔细检查每份预览。

会发送的数据

日程与预约：顾客姓名、电话号码、服务、时间，以及员工填写的预约备注和取消原因。
顾客名单：姓名、电话、最近一次到店。
报表汇总：营收数字和预约数量。
服务目录与价格：服务、桌台/场地、课程、促销、优惠券、价目表。
套餐与待跟进事项：即将到期的套餐、剩余次数、未付款预约、久未到店的顾客。
钱包：门店余额、结算和提现记录（仅金额，不含银行账号）。
WhatsApp 收件箱聊天内容，仅在您勾选 inbox:write 权限时发送。

撤销连接

打开“设置 → AI 连接”，在相应连接上点击“撤销”。连接会从下一次请求起停止（最迟约一分钟），令牌也无法再续期。
在账户设置页面修改密码，会自动撤销该账户的所有 AI 连接。通过“忘记密码”重置密码目前不会撤销连接——如果您怀疑账户被他人访问，请手动撤销连接。
“修改权限”可开启或关闭写入权限，无需重新连接。读取权限无法单独关闭；如需关闭，请撤销连接。
“历史记录”显示每个连接最近 20 次操作。
仅在 AI 应用中删除连接器，并不会撤销 Bukujanji 端的授权。请同时在后台撤销。

撤销连接不会删除 AI 服务商已经收到的数据。如需删除，请联系您所使用的 AI 应用的服务商。

提问示例

先从提问开始，授予写入权限后再加入操作类指令。

“上个月营收是多少？本周谁的套餐到期？”
“下周三有哪些场次？还有名额吗？”
“谁还没付款？”
“我的余额是多少？上一次提现是什么时候？”
“为烹饪课创建一个 9 折促销，有效期到月底。”（AI 会先给您看预览）
“用 Ani 女士的套餐帮她预约周六 10:00 的场次。”
“把 Camille 从周六 10:00 的课改到周日 10:00。”
“给明天场次的学员发送 WhatsApp 提醒。”
“我的门店是新开的，开始接受预约前还缺什么？”

问题排查与支持

“Connection can't be made”：请确认您使用的是与服务器地址相符的门店店主账户登录，并退出浏览器中其他 Bukujanji 登录状态。
Starter 门店：AI 连接需要 Pro 或 Enterprise 方案。
AI 应用提示缺少权限：在该连接上打开“修改权限”，开启所需权限。
顾客名单被截断：该连接当天的顾客数据额度已用完；请改用统计人数的提问，或使用后台的“顾客”菜单。

其他帮助及个人数据相关请求：请发送邮件至 support@bukujanji.com。

什么是 AI 连接

谁可以使用

服务器地址及查找位置

如何连接

登录与授权确认页面

所需权限

读取工具

写入工具与两步确认

刻意不支持的操作

使用限制

会发送的数据

撤销连接

提问示例

问题排查与支持

什么是 AI 连接

谁可以使用

服务器地址及查找位置

如何连接

登录与授权确认页面

所需权限

读取工具

写入工具与两步确认

刻意不支持的操作

使用限制

会发送的数据

撤销连接

提问示例

问题排查与支持