mcpField
S
Smile.io MCP by usefulapi

Smile.io MCP by usefulapi

远程服务
usefulapi.io商业与营销0今天更新

关于 Smile.io MCP by usefulapi

Smile.io MCP by usefulapi 将 Smile.io 忠诚度数据和操作接入 MCP 客户端,面向管理客户积分、奖励、积分获取规则及 VIP 等级的企业。

主要功能

  1. 01查询客户及积分历史
  2. 02查看奖励和兑换选项
  3. 03查看积分获取规则及 VIP 等级
  4. 04调整客户积分余额
  5. 05记录活动并兑换奖励

适用场景

  1. 01查询客户积分余额和历史
  2. 02查看可兑换奖励及 VIP 状态
  3. 03在客户互动后调整积分
  4. 04为客户兑换积分奖励

MCP 相关

通过托管端点向 MCP 客户端提供 Smile.io 忠诚度查询及写入工具。读取工具仅供查询,写入工具可更改客户数据或兑换积分。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://smile-io.usefulapi.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

14
参数类型必填说明
emailstring否要查找的精确邮箱地址。
limitinteger否结果数量上限,1-250(Smile 默认值为 50)。
stateenum否candidate = 尚未加入,member = 已加入计划,disabled = 已排除。candidate | member | disabled
cursorstring否来自上一响应的 metadata.next_cursor(或 previous_cursor)的游标。第一页请省略。
updated_at_minstring否仅返回在此 ISO 8601 日期时间或之后更新的记录,例如 2026-01-01T00:00:00Z。
include_vip_statusboolean否包含每位客户的 vip_status 对象(include=vip_status)。

详细介绍

usefulapi 提供的 Smile.io MCP

在 Claude、Cursor 或任何 MCP 客户端中使用 Smile.io——查询忠诚度计划客户、积分余额和历史记录、积分赚取与兑换方式、已发放的奖励和 VIP 等级,以及调整积分。 托管服务,无需本地安装:使用你自己的 Smile.io 凭据连接。

实时端点: https://smile-io.usefulapi.io/mcp · 主页: https://usefulapi.io/smile-io

连接

  • Claude(claude.ai、桌面版):打开 自定义 → 连接器,点击 + 添加 → 添加自定义连接器,然后粘贴 https://smile-io.usefulapi.io/mcp。
  • Claude Code: claude mcp add --transport http smile-io https://smile-io.usefulapi.io/mcp,然后运行 /mcp 登录。
  • VS Code: 添加到 VS Code。
  • Cursor 和其他客户端: 将该 URL 添加为远程 MCP 服务:
{
  "mcpServers": {
    "smile-io": {
      "url": "https://smile-io.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 Smile.io 凭据。

分步设置说明、凭据查找方式和常见问题:https://usefulapi.io/smile-io/

首次连接时,你需要提供 Smile.io 商家 API 密钥(Smile Admin → Settings → Developer tools → API keys)。 系统会验证密钥并按用户存储,且仅限你本人使用——配置文件中不会存放密钥。

工具

工具类型功能
smile_list_customers读取列出客户
smile_get_customer读取获取客户信息
smile_list_points_transactions读取列出积分交易
smile_get_points_transaction读取获取积分交易
smile_list_points_products读取列出积分商品(兑换方式)
smile_get_points_product读取获取积分商品
smile_list_reward_fulfillments读取列出奖励发放记录
smile_list_earning_rules读取列出积分赚取规则(赚取方式)
smile_list_vip_tiers读取列出 VIP 等级
smile_get_points_settings读取获取积分设置
smile_get_referral_settings读取获取推荐设置
smile_create_points_transaction写入调整客户的积分余额
smile_create_activity写入记录客户活动
smile_purchase_points_product写入兑换客户的积分奖励
smile_usage_status元数据使用状态(免费套餐用量计数)
smile_request_feature元数据申请添加缺失功能
smile_upgrade元数据升级到 Pro(不限量*)
smile_cancel_subscription元数据取消 Pro 订阅

read 工具为只读;write 工具会修改数据(客户端应先征求确认);meta 工具用于报告用量、管理订阅或发送功能申请。

定价

套餐价格限额
免费$0每月 50 次工具调用
Pro(每位用户)$9/mo 或 $90/yr(免费 2 个月)不限量*

*此服务的 Pro 套餐公平使用限额为每月 10,000 次工具调用。如需更多,请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 smile_upgrade 订阅(它会返回 Stripe Checkout 链接)。可随时使用 smile_cancel_subscription 取消:Pro 服务会持续到付费周期结束,当前周期不予退款;在此之前运行 smile_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT © usefulapi。与 Smile.io 无关联,也未获其认可。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。