walletap

@walletap/mcp-server

通过任意 AI 助手签发和管理 Apple Wallet 与 Google Wallet 卡券。

快速开始

npx @walletap/mcp-server

或全局安装：

npm install -g @walletap/mcp-server
walletap-mcp

身份验证

将 Walletap API 密钥设置为环境变量：

export WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxx

你可以在 Walletap 控制台的 Settings 中找到 API 密钥。

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "walletap": {
      "command": "npx",
      "args": ["-y", "@walletap/mcp-server"],
      "env": {
        "WALLETAP_API_KEY": "wt_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor / Windsurf

添加到 .cursor/mcp.json 或 .windsurf/mcp.json：

{
  "mcpServers": {
    "walletap": {
      "command": "npx",
      "args": ["-y", "@walletap/mcp-server"],
      "env": {
        "WALLETAP_API_KEY": "wt_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

HTTP 远程模式

适用于可自托管部署、n8n、Make 或 Zapier AI：

walletap-mcp --transport http

这会启动一个 HTTP 服务（默认端口为 3001），并提供：

• POST /mcp — JSON-RPC 端点
• GET /mcp/sse — 用于流式传输的 Server-Sent Events
• GET /health — 健康检查

Docker 示例：

FROM node:22-alpine
RUN npm install -g @walletap/mcp-server
ENV WALLETAP_API_KEY=wt_live_xxxxxxxxxxxxxxxxxxxx
ENV MCP_PORT=3001
EXPOSE 3001
CMD ["walletap-mcp", "--transport", "http"]

工具参考

工具	功能	关键输入
list_passes	分页列出某个模板的卡券	templateId、status、limit
search_passes	按邮箱或电话号码搜索卡券	templateId、searchQuery
export_passes	将卡券导出为 CSV	templateId、status
get_pass	获取单张卡券及其钱包链接	id 或 externalId+templateId
create_pass	创建一张或多张钱包卡券	passes[]、sendToEmail、sendToPhone
update_pass	更新卡券字段、印章或余额	id、templateFields、stampOperation、balanceOperation
notify_pass	向一位卡券持有者发送通知	passId、title、content
list_templates	列出所有卡券模板	limit、startAfter
create_template	创建新模板	name、type
update_template	更新模板配置或设计	templateId、data
delete_template	删除模板	templateId
send_template_notification	向模板中的所有卡券持有者发送通知	templateId、title、content
create_certificate	创建 Apple Wallet 证书	templateId
list_locations	列出所有营业地点	—
create_location	创建新地点	name、latitude、longitude
update_location	更新地点详情	id、name、address
delete_location	删除地点	id
create_reader	创建 VTAP NFC 读卡器	name、templateId、phone
list_sub_accounts	列出团队成员	—
create_sub_account	创建团队成员	email、displayName、password
update_sub_account	更新团队成员权限	userId、permissions、templateIds
delete_sub_account	移除团队成员	userId
translate_pass_text	将卡券文本翻译为多种语言	texts、sourceLanguage、targetLanguages

提示词示例

连接 Walletap 后，你可以对 AI 助手这样说：

• “创建一个名为‘Coffee Rewards’的会员卡模板，并向 [email protected] 签发一张卡券”
• “显示我的会员模板中所有尚未安装的卡券”
• “为我的印章卡模板中外部 ID 为‘CUST-42’的卡券添加 3 个印章”
• “向所有卡券持有者发送通知：‘本周末双倍积分！前往任意地点即可获得 2 倍积分。’”
• “将我的所有会员卡券导出为 CSV，供营销团队使用”
• “将我们的卡券标签翻译成西班牙语、法语和德语”

API 基础 URL

默认连接到 https://api.walletap.io。通过以下方式覆盖：

export WALLETAP_API_BASE_URL=https://your-custom-instance.example.com

许可证

MIT