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

API キーは、Walletap ダッシュボードの「Settings」で確認できます。

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	ウォレット URL を含む単一のパスを取得します	id または externalId+templateId
create_pass	1 つ以上のウォレットパスを作成します	passes[]、sendToEmail、sendToPhone
update_pass	パスのフィールド、スタンプ、または残高を更新します	id、templateFields、stampOperation、balanceOperation
notify_pass	パスの所有者 1 人に通知を送信します	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 倍！ 2 倍のポイントを獲得するには、いずれかの店舗にお越しください。』という通知を送信して」
• 「マーケティングチーム向けに、すべてのロイヤルティパスを CSV としてエクスポートして」
• 「パスのラベルをスペイン語、フランス語、ドイツ語に翻訳して」

API ベース URL

デフォルトでは https://api.walletap.io に接続します。次のように変更できます。

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

ライセンス

MIT