Paylo

Paylo MCP 服务

面向 AI Agent 的商务发现网关

Paylo MCP 服务通过模型上下文协议，将 AI 助手连接到尼日利亚商务平台 Paylo。

• **购物者：**按名称、类别、州和区域搜索已验证的 Paylo 商店、产品和服务，并查看共享的礼物愿望清单。
• **卖家：**从 Paylo 自行维护的数据中了解 Paylo 当前的套餐、费用和功能，并获取一键注册链接来开设商店。

---

连接

服务托管于：

https://mcp.usepaylo.com

它通过 / 和 /mcp 提供 Streamable HTTP 服务，并在 /sse 提供旧版 SSE。无需账户、API 密钥或本地设置。

**Claude：**从 Claude 连接器目录添加 Paylo，或在 Claude 的连接器设置中使用 URL https://mcp.usepaylo.com 添加自定义连接器。

**其他客户端：**任何支持远程服务的 MCP 客户端都可以连接到相同的 URL。

---

安全与数据

• **只读。**所有工具只读取公开的 Paylo 数据。该连接器无法登录账户、下单、收款或转移资金。
• 注册由用户自行操作。get_seller_signup_link 仅返回链接。只有用户自行打开链接、勾选复选框接受 Paylo 的服务条款，并选择 Google 或 Apple 账户后，才会创建任何内容。身份验证（KYC）之后会在 Paylo Business 应用中进行，不会通过助手进行。
• **不收集凭据。**该连接器不会索要密码、银行卡详细信息或身份证件。
• **卖家撰写的内容。**商店名称、描述和产品文本由卖家撰写，并作为数据返回。
• **无付费推广。**商店搜索结果按在售商品数量排序。
• **归属追踪。**链接包含标明所连接客户端的 UTM 参数（见下文）。除工具参数外，不会向 Paylo 发送任何对话内容。

隐私政策：https://usepaylo.com/privacy-policy

支持

请发送电子邮件至 [email protected]，或访问 Paylo 帮助中心。如有安全问题，请使用相同的邮箱地址，并在主题中注明 “Security”。

---

可用工具

工具	描述
search_storefronts	按名称、关键词或类别搜索已启用的 Paylo 店面
get_storefront	按店面 slug 获取完整的目录摘要和统计数据
search_products	在所有商店或指定店面中搜索产品
get_product	按店面 slug 和产品 slug 获取单个产品的详细信息
search_services	在所有商店或指定店面中搜索服务
get_categories	列出店面提供的类别
get_wishlist	按分享链接或令牌获取公开愿望清单及商品筹资进度
get_changelog	根据平台更新日志说明 Paylo 的功能
get_seller_overview	面向卖家的 Paylo 介绍：功能、费用及入门方式
get_seller_signup_link	一键卖家注册链接（使用 Google/Apple 登录），包含推荐归属追踪；只有用户打开链接后才会创建内容

所有响应都包含用于归属追踪的 UTM 标记 URL。utm_source 是 MCP 初始化时连接客户端经清理的 clientInfo.name（例如 claude-code、chatgpt）；若无此值，则使用用户代理检测结果，最后回退为 ai。

---

架构

AI Agent → MCP (Streamable HTTP or SSE) → Paylo MCP Server → usepaylo.com API → Storefront Catalog

MCP 服务是一个轻量代理。它不会直接访问数据库；所有数据都从 Paylo 后端 API 获取，并以结构化 JSON 返回。

---

自托管

如果你更愿意运行自己的实例：

git clone https://github.com/scephiro/paylo-mcp-server.git
cd paylo-mcp-server
npm install
npm run build

设置环境变量：

GPT_API_SECRET=your_backend_secret
PAYLO_API_BASE_URL=https://usepaylo.com   # default
MCP_PORT=3030                              # default

启动服务：

node build/index.js

服务监听 http://0.0.0.0:3030。可通过 /mcp 使用 Streamable HTTP 连接，或通过 GET /sse 和 POST /messages?sessionId=<id> 使用旧版 SSE。

---

Docker

docker run -p 3030:3030 \
  -e GPT_API_SECRET=your_secret \
  ghcr.io/scephiro/paylo-mcp-server:latest

---

许可证

MIT——参见 LICENSE。