Paylo

Paylo MCP サーバー

AI エージェントのためのコマース探索ゲートウェイ

Paylo MCP サーバーは、Model Context Protocolを介して、AI アシスタントをナイジェリアのコマースプラットフォームであるPayloに接続します。

• **購入者：**名前、カテゴリ、州、地域でPayloの認証済みストア、商品、サービスを検索し、共有されたギフトウィッシュリストを確認できます。
• **販売者：**Payloが管理する最新データから、Payloの現行プラン、手数料、機能を確認でき、ワンタップでストアを開設できる登録リンクを取得できます。

---

接続

サーバーは次の場所でホストされています。

https://mcp.usepaylo.com

/ と /mcp でStreamable HTTPを、レガシーSSEとして/sseを利用できます。アカウント、APIキー、ローカルでのセットアップは不要です。

Claude：Claude Connectors Directoryから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	ストアのスラッグを指定して、ストアのカタログ概要と統計情報を取得します
search_products	すべてのストア、または特定のストア内の商品を検索します
get_product	ストアのスラッグと商品のスラッグを指定して、単一商品の詳細を取得します
search_services	すべてのストア、または特定のストア内のサービスを検索します
get_categories	ストアで利用可能なカテゴリの一覧を取得します
get_wishlist	共有リンクまたはトークンを指定して公開ウィッシュリストを取得し、アイテムごとの資金調達の進捗状況を確認します
get_changelog	プラットフォームの変更履歴に基づいてPayloの機能を説明します
get_seller_overview	販売者向けPayloの概要：機能、手数料、利用開始方法
get_seller_signup_link	アトリビューション情報付きのワンタップ販売者登録リンク（Google／Appleサインイン）。ユーザーがリンクを開くまで何も作成されません

すべての応答には、アトリビューション追跡用のUTMタグ付きURLが含まれます。utm_sourceには、MCP initializeで渡される接続クライアントのサニタイズ済み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で待ち受けます。Streamable HTTPでは/mcp経由で、レガシーSSEではGET /sseおよびPOST /messages?sessionId=<id>経由で接続します。

---

Docker

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

---

ライセンス

MIT — LICENSEをご覧ください。