Letisim retail MCP

消費者向けeSIMの発見とチェックアウトの受け渡しのための、公開・リダイレクト優先のMCPサーフェスです。

このサーバーは意図的にメールアドレスや支払い認証情報を受け付けません。create_checkout は、不活性で個人情報を含まない AgentCheckout のみを保持します。購入者は、返却されたファーストパーティーの Letisim URL を開く必要があります。既存のWebチェックアウトが再見積もりを行い、メールと法的同意を収集し、Order/Payment を作成して、支払いデータをPSPに直接渡します。

ローカルでの実行

npm run build -w @letisim/retail-mcp
# Start the API separately with RETAIL_MCP_ENABLED=1 in a non-production test environment.
LETISIM_API_BASE_URL=http://127.0.0.1:3200 npm run start:http -w @letisim/retail-mcp

Streamable HTTP エンドポイントは http://127.0.0.1:3210/retail です。start:stdio は同じツールファクトリーをローカルのMCPホストに公開します。ループバック以外のバインドは、RETAIL_MCP_ALLOWED_HOSTS が設定されていない限りフェイルクローズです。ExecPlan 内の法務、税務、領収書、クライアントマトリクス、管理ライブの各ゲートがクローズされるまで、このパッケージは非公開・テスト専用です。APIルートは RETAIL_MCP_ENABLED=1 でない限りフェイルクローズです。また、そのキーは意図的に、汎用の本番環境変数ライター許可リストには含まれていません。

Related MCP server: mcp-esim

パートナー帰属

インストールは、1つの環境変数だけでアフィリエイトパートナーに帰属させることができます。

LETISIM_MCP_ATTRIBUTION=promo:TRAVELPRO   # or ref:<campaign-slug>

そのインストールで開始された購入には、パートナーのプロモーションコードがファーストパーティーのチェックアウトURLに付与され、既存のアフィリエイト規約が報酬を決定します。このハンドルは意図的にツールの引数にしていません。信頼できないページを読んだエージェントが他人のコミッションを奪えないようにするためです。不正な形式、未知、または失効したハンドルは、帰属なしのチェックアウトにフォールバックし、購入を失敗させることはありません。ハンドルは https://partner.letisim.com の Letisim アフィリエイトカビネットで取得してください。

Claude Code でのインストール

claude plugin marketplace add skorik94-glitch/letisim-mcp
claude plugin install letisim@letisim

このプラグインはバンドルされた dist/stdio.js を実行するため、npmパッケージもビルドステップも不要です。アフィリエイトの場合は、Claude Code を起動する前に LETISIM_MCP_ATTRIBUTION をエクスポートしてください。

現在の機能

プラン検索、目的地カバレッジ、価格は本番カタログに対してライブです。見積もりとチェックアウトの受け渡しは、Letisim がエージェントコマースゲートを開くまで 404 を返します。これは意図的なサーバーサイドのスイッチであり、クライアントのバグではありません。

配布

レジストリメタデータは server.json にあり、package.json と同期が test/distribution.test.ts によって保たれています。公開リポジトリ https://github.com/skorik94-glitch/letisim-mcp は、Letisim モノレポから scripts/sync-retail-mcp-public.mjs によって生成されています。ミラーではなく上流のソースを編集してください。