Pinelabs Mcp Server について
Pine Labs Payment Gateway MCP Serverは、Pine Labsの決済APIをAIアシスタントやエージェント型アプリケーションに公開します。決済処理や照会を行う加盟店・開発者向けで、注文、決済リンク、返金、サブスクリプション、精算、レポートを扱い、読み取り専用モードも備えます。
主な機能
- 01決済リンクと注文の作成・照会
- 02カード決済とUPIインテント決済の処理
- 03返金、入金、サブスクリプションの管理
- 04精算、取引、加盟店成功率の照会
- 05読み取り専用モードで読み取りツールのみ登録
- 06CLIによる認証情報とクライアントの設定
活用シーン
- 01注文、取引、精算情報の照会
- 02決済リンクまたはチェックアウト注文の作成
- 03加盟店の取引成功率の確認
- 04読み取り専用モードでの監視と分析
MCP 対応
Pine Labsの決済APIをMCPツールとして、Claude Desktop、Cursor、VS CodeなどのMCPクライアントに提供します。ローカルStdioサーバーのほか、リモートMCPサーバーの選択肢も記載されています。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.pinelabs.com/mcpclaude mcp add --transport http pinelabs-online https://mcp.pinelabs.com/mcp{"mcpServers":{"pinelabs-online":{"type":"http","url":"https://mcp.pinelabs.com/mcp"}}}Cursor で開く{"servers":{"pinelabs-online":{"type":"http","url":"https://mcp.pinelabs.com/mcp"}}}VS Code で開く{"mcpServers":{"pinelabs-online":{"type":"http","url":"https://mcp.pinelabs.com/mcp"}}}{"mcpServers":{"pinelabs-online":{"serverUrl":"https://mcp.pinelabs.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://mcp.pinelabs.com/mcp認証が必要ツール
詳細
Pine Labs Payment Gateway MCP Server(公式)
Pine Labs 決済ゲートウェイ用の MCP クライアントです。クライアントの認証情報を使って、Claude Desktop、Cursor、VS Code、その他の AI アシスタントを Pine Labs の決済 API に接続できます。
完全なドキュメント | 利用可能なツール | ユースケース | よくある質問
目次
- 前提条件
- クイックスタート
- CLI コマンド
- 対応 AI クライアント
- 手動設定
- 利用可能なツール
- ユースケース
- リモート MCP サーバー
- 認証
- ローカル MCP サーバー
- 設定
- デバッグ
- よくある質問
- キーワード
- ライセンス
前提条件
- Node.js 18 以降 -- ダウンロード または
npm i pinelabs-mcpを実行してインストール - Pine Labs のクライアント認証情報 -- Pine Labs 開発者ポータルからクライアント ID とクライアントシークレットを取得してください
クイックスタート
認証情報の取得
- アカウントに付属する Pine Labs の加盟店ダッシュボードでサインアップするか、ログインします。
- アカウント設定に移動し、クライアント ID と クライアントシークレットを確認します。
- 上記のセットアップ手順に従って、MCP サーバーの設定にこれらの認証情報を使用します。
設定と接続
# 1. Configure your credentials
npx pinelabs-mcp configure --client-id=YOUR_ID --client-secret=YOUR_SECRET
# 2. Test your connection
npx pinelabs-mcp test
# 3. Auto-configure your AI client
npx pinelabs-mcp setup cursor # or: claude-desktop, vscode, windsurf, opencode, copilot, codex
その後、AI クライアントを再起動して、Pine Labs のツールを使い始めてください。
CLI コマンド
pinelabs-mcp start Start MCP server (stdio mode)
pinelabs-mcp configure Interactive credential setup
pinelabs-mcp configure --client-id=X --client-secret=Y [--env=uat|prod]
pinelabs-mcp test Test connectivity and credentials
pinelabs-mcp setup <client> Auto-configure an AI client
pinelabs-mcp setup <client> --local Use local path (dev mode)
pinelabs-mcp setup <client> --print Preview config without writing
pinelabs-mcp status Show current configuration
pinelabs-mcp help Show help message
pinelabs-mcp --version Show version
対応 AI クライアント
| クライアント | コマンド | 設定パス |
|---|---|---|
| Claude Desktop | setup claude-desktop | プラットフォーム固有の Claude 設定 |
| Cursor | setup cursor | ~/.cursor/mcp.json |
| VS Code | setup vscode | .vscode/mcp.json(プロジェクト) |
| Windsurf | setup windsurf | ~/.codeium/windsurf/mcp_config.json |
| OpenCode | setup opencode | .opencode/config.json(プロジェクト) |
| GitHub Copilot | setup copilot | ~/.copilot/mcp-config.json |
| OpenAI Codex | setup codex | .codex/config.toml |
手動設定
npx pinelabs-mcp setup を使わずに手動で設定する場合は、次の内容を AI クライアントの MCP 設定に追加してください。
{
"mcpServers": {
"pinelabs": {
"command": "npx",
"args": ["-y", "pinelabs-mcp"],
"env": {
"PINELABS_CLIENT_ID": "your_client_id",
"PINELABS_CLIENT_SECRET": "your_client_secret"
}
}
}
}
注: VS Code では、トップレベルのキーとして
"mcpServers"ではなく"servers"を使用します。本番環境では、envブロックに"PINELABS_ENV": "prod"を追加してください。
利用可能なツール
Pine Labs MCP Server は、複数のカテゴリにわたる 50 以上のツールを公開します。各ツールは、特定の Pine Labs 決済 API エンドポイントに対応しています。
ツールの種類
以下の各ツールには、アクセスパターンと運用上のリスクを示す 種類 が付いています。これにより、読み取り専用のデプロイで安全に使えるツールと、自律型(エージェント型)のフローでユーザーによる明示的な確認が必要なツールを判断できます。
| 種類 | 意味 | 例 |
|---|---|---|
| 読み取り | 安全で、副作用がありません。データの取得または照会のみを行います。読み取り専用モードで使用できます。 | get_order_by_order_id、get_all_settlements、list_plural_apis |
| 書き込み | リソースを作成または変更します。破壊的ではありませんが、サーバーの状態を変更します。読み取り専用モードではスキップされます。 | create_payment_link、create_order、update_plan |
| 破壊的 | キャンセル、削除、返金、または送金を行います。取り消せない、または金銭的な影響があります。エージェントのフローでは、ユーザーによる明示的な確認が必要です。 | cancel_order、create_refund、create_payout、delete_plan |
読み取り専用モード: サーバーを
--read-onlyを指定して実行する(または同等の設定を行う)と、Readツールのみが登録され、すべてのWrite/Destructiveツールセットがスキップされます。分析、監視、または信頼できないエージェントのコンテキストで役立ちます。
決済リンク
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
create_payment_link | 書き込み | 決済を受け付けるための新しい決済リンクを作成します | 決済リンク - 作成 |
get_payment_link_by_id | 読み取り | 決済リンク ID を指定して決済リンクを取得します | 決済リンク - ID で取得 |
get_payment_link_by_merchant_reference | 読み取り | マーチャント決済リンク参照を指定して決済リンクを取得します | 決済リンク - 参照で取得 |
cancel_payment_link | 破壊的操作 | 有効な決済リンクをキャンセルします | 決済リンク - キャンセル |
resend_payment_link_notification | 書き込み | 決済リンクの通知を顧客に再送します | 決済リンク - 再送 |
注文
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
get_order_by_order_id | 読み取り | 注文 ID を指定して注文の詳細を取得します | 注文 - ID で取得 |
get_order_by_merchant_order_reference | 読み取り | マーチャント注文参照を指定して注文の詳細を取得します | 注文 - マーチャント参照で取得 |
capture_order | 書き込み | 注文に対して、事前承認済みの決済を売上確定します | 注文 - 売上確定 |
cancel_order | 破壊的操作 | 注文に対する事前承認済みの決済をキャンセルします | 注文 - キャンセル |
fetch_order_payments | 読み取り | 注文に関連付けられたすべての決済試行を取得します | 注文 - 決済を取得 |
チェックアウト注文
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
create_order | 書き込み | 新しいチェックアウト注文を作成し、チェックアウトリンクを生成します | 注文 - 作成 |
カード決済
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
create_card_payment | 書き込み | 注文に対してサーバー間のカード決済を作成します | カード決済 - 作成 |
get_card_details | 読み取り | カード番号からカードの詳細(BIN、ネットワーク、種類)を取得します | カード詳細 - 取得 |
OTP
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
generate_otp | 書き込み | カード決済の認証フロー用 OTP を生成します | OTP - 生成 |
submit_otp | 書き込み | カード決済の認証を完了するため、OTP を送信します | OTP - 送信 |
resend_otp | 書き込み | カード決済の認証用 OTP を再送します | OTP - 再送 |
返金
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
create_refund | 破壊的操作 | 売上確定済みの決済に対する全額または一部の返金を開始します | 返金 - 作成 |
決済
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
get_all_settlements | 読み取り | 日付範囲を指定して、加盟店のすべての決済を取得します | 決済 - すべて取得 |
get_settlement_by_utr | 読み取り | UTR(Unique Transaction Reference)を指定して、特定の決済を取得します | 決済 - UTR で取得 |
振込
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
create_payout | 破壊的操作 | 受取人に資金を送金するための振込を作成します(資金が移動します) | 振込 - 作成 |
get_payout_details | 読み取り | 振込 ID を指定して、振込の詳細を取得します | 振込 - 取得 |
get_payout_payments | 読み取り | 振込に関連付けられた支払いの一覧を取得します | 振込 - 支払いを取得 |
get_payout_balance | 読み取り | 加盟店が利用できる振込残高を取得します | 振込 - 残高を取得 |
update_payout | 書き込み | 既存の振込リクエストを更新します | 振込 - 更新 |
cancel_payout | 破壊的操作 | 保留中の振込リクエストをキャンセルします | 振込 - キャンセル |
サブスクリプション
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
create_plan | 書き込み | 新しいサブスクリプションプランを作成します | プラン - 作成 |
get_plans | 読み取り | サブスクリプションプランを取得します | プラン - すべて取得 |
get_plan_by_id | 読み取り | プラン ID でサブスクリプションプランを取得します | プラン - 個別取得 |
get_plan_by_merchant_reference | 読み取り | 加盟店のプラン参照情報でプランを取得します | プラン - 個別取得 |
update_plan | 書き込み | 既存のサブスクリプションプランを更新します | プラン - 更新 |
delete_plan | 破壊的操作 | サブスクリプションプランを削除します | プラン - 削除 |
create_subscription | 書き込み | プランに紐づく新しいサブスクリプションを作成します | サブスクリプション - 作成 |
get_subscriptions | 読み取り | サブスクリプションを取得します | サブスクリプション - すべて取得 |
get_subscription_by_id | 読み取り | サブスクリプション ID でサブスクリプションを取得します | サブスクリプション - 個別取得 |
get_subscription_by_merchant_reference | 読み取り | 加盟店の参照情報でサブスクリプションを取得します | サブスクリプション - 個別取得 |
pause_subscription | 書き込み | アクティブなサブスクリプションを一時停止します | サブスクリプション - 一時停止 |
resume_subscription | 書き込み | 一時停止中のサブスクリプションを再開します | サブスクリプション - 再開 |
cancel_subscription | 破壊的操作 | アクティブなサブスクリプションをキャンセルします | サブスクリプション - キャンセル |
update_subscription | 書き込み | 既存のサブスクリプションを更新します | サブスクリプション - 更新 |
create_presentation | 書き込み | サブスクリプションのプレゼンテーション(支払い請求)を作成します | プレゼンテーション - 作成 |
get_presentation | 読み取り | プレゼンテーション ID でプレゼンテーションを取得します | プレゼンテーション - 取得 |
delete_presentation | 破壊的操作 | プレゼンテーションを削除します | プレゼンテーション - 削除 |
get_presentations_by_subscription_id | 読み取り | サブスクリプションのすべてのプレゼンテーションを取得します | プレゼンテーション - サブスクリプションで取得 |
get_presentation_by_merchant_reference | 読み取り | 加盟店の参照情報でプレゼンテーションを取得します | プレゼンテーション - 取得 |
send_subscription_notification | 書き込み | サブスクリプションの引き落とし前通知を送信します | プレゼンテーション - 作成 |
create_debit | 破壊的操作 | サブスクリプションに対する引き落とし(支払い回収)を実行します | プレゼンテーション - 作成 |
create_merchant_retry | 書き込み | 引き落としに失敗した場合に、マンデートの実行を再試行します(最大 3 回) | 加盟店の再試行 |
UPI 決済
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
create_upi_intent_payment_with_qr | 書き込み | 即時決済のための QR コード付き UPI インテント決済を作成します | UPI Intent QR |
レポートと取引検索
| ツール | 種類 | 説明 | API リファレンス |
|---|---|---|---|
get_payment_link_details | 読み取り | 指定した期間内の決済リンクの詳細を取得します | API Docs |
get_order_details | 読み取り | 指定した期間内の注文の詳細を取得します | API Docs |
get_refund_order_details | 読み取り | 指定した期間内の返金注文の詳細を取得します | API Docs |
search_transaction | 読み取り | 取引 ID で取引を検索します | API Docs |
開発者ツール
| ツール | 種類 | 説明 |
|---|---|---|
get_api_documentation | 読み取り | 特定の API に関する Pine Labs API ドキュメントを取得します |
list_plural_apis | 読み取り | 利用可能なすべての Pine Labs (Plural) API を説明とともに一覧表示します |
detect_stack | 読み取り | 現在のプロジェクトの技術スタックを検出し、統合ガイダンスを調整します |
integrate_pinelabs_checkout | 読み取り | Pine Labs Checkout 向けに、スタックに応じたコードスニペットと統合ガイダンスを生成します |
加盟店分析
| ツール | 種類 | 説明 |
|---|---|---|
get_merchant_success_rate | 読み取り | 指定した期間における加盟店の取引成功率を取得します |
ユースケース
- 決済ゲートウェイの統合:AI アプリケーションを Pine Labs の決済ゲートウェイに接続し、チェックアウト注文の作成、決済リンクの生成、プログラムによる取引処理を行います。
- AI を活用したチェックアウトフロー:AI アシスタントが注文を作成し、決済リンクを生成し、決済状況をリアルタイムで追跡する、会話型のチェックアウト体験を構築します。
- UPI 決済の自動化:AI 駆動型のインターフェースを通じて、UPI インテント QR コードを生成し、アプリ内または POS での決済に向けて UPI 決済を処理します。
- サブスクリプションライフサイクル管理:定期決済プランの作成、サブスクリプションの有効化、一時停止と再開、デビットの提示、デビット前通知を自動化します。
- エージェント型決済ワークフロー:注文の作成から照合まで、手動の介入なしに決済業務をエンドツーエンドで管理する、自律型 AI エージェントを構築します。
- 注文の追跡と照合:注文の詳細を照会し、ID で取引を検索し、決済を照合して、ステータスの確認や紛争の解決を行います。
- 決済分析とレポート:任意の期間を指定して、決済リンクのレポート、注文の概要、返金の詳細、加盟店の成功率を取得します。
- カスタマーサポートの自動化:サポート担当者やチャットボットが取引を検索し、決済状況を確認し、注文をキャンセルし、決済通知を再送できるようにします。
リモート MCP サーバー
リモート MCP サーバーは Pine Labs がホストおよび保守しています。npm CLI を使用する代わりに、リモートエンドポイントを使って AI クライアントを手動で設定する場合は、この方法を利用してください。
メリット
- セットアップ不要:管理が必要な Python、Docker、ローカルインフラストラクチャはありません
- 常に最新:最新の決済 API 機能とセキュリティパッチが自動的に適用されます
- 高可用性:Pine Labs の本番インフラストラクチャ上でホストされています
- セキュアな認証:HTTPS 経由のクライアント認証情報による認証
Pine Labs のホスト型サービスではなく、セルフホストのリモートデプロイメントに接続する場合は、以下のリモート URL を
<your-mcp-server-url> に置き換えてください。
前提条件
リモート MCP 接続をプロキシするには npx が必要です。
Node.js(npm と npx を含む)をインストールしてください。
macOS
brew install node
Windows
choco install nodejs
または、https://nodejs.org/ からダウンロードしてください。
インストールの確認
npx --version
Cursor での使用方法
以下を Cursor の MCP 設定に追加してください。
{
"mcpServers": {
"pinelabs": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.pinelabs.com/mcp",
"--header",
"X-Client-Id:<your-client-id>",
"--header",
"X-Client-Secret:<your-client-secret>"
]
}
}
}
<your-client-id> と <your-client-secret> を Pine Labs の認証情報に置き換えてください。詳細については、認証を参照してください。
Claude Desktop での使用方法
以下を claude_desktop_config.json に追加してください。
{
"mcpServers": {
"pinelabs": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.pinelabs.com/mcp",
"--header",
"X-Client-Id:<your-client-id>",
"--header",
"X-Client-Secret:<your-client-secret>"
]
}
}
}
<your-client-id> と <your-client-secret> を Pine Labs の認証情報に置き換えてください。
- Claude Desktop での MCP サーバーの設定:MCP クイックスタートガイド
- Claude Desktop のインストール:ダウンロード
VS Code での使用方法
以下を VS Code の設定(JSON)に追加してください。
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "pinelabs_client_id",
"description": "Pine Labs Client ID"
},
{
"type": "promptString",
"id": "pinelabs_client_secret",
"description": "Pine Labs Client Secret",
"password": true
}
],
"servers": {
"pinelabs": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.pinelabs.com/mcp",
"--header",
"X-Client-Id:${input:pinelabs_client_id}",
"--header",
"X-Client-Secret:${input:pinelabs_client_secret}"
]
}
}
}
}
VS Code の MCP サーバーについて詳しくは、エージェントモードのドキュメントを参照してください。
認証
MCP サーバーは、Pine Labs が発行した Client ID と Client Secret の認証情報を使用して認証を行います。
Note: ローカル環境へのデプロイでは、CLI 引数または環境変数を使用して認証情報を渡せます。リモートサーバーでは、認証情報は HTTP ヘッダーとして渡されます。
ローカル MCP サーバー
実行環境を完全に制御できるよう、独自のインフラストラクチャに MCP サーバーをデプロイします。
前提条件
- Python 3.12+
- Docker(任意。コンテナ化されたデプロイに使用)
- Git
Windows へのインストール(Chocolatey)
Windows マシンに MCP サーバーを導入する最も簡単な方法は、Chocolatey を使用することです。このパッケージは、Python 3.10+ を依存関係としてインストールする薄いラッパーで、その後 PyPI から pinelabs-mcp-server をインストールし、PATH に pinelabs-mcp のシムを登録します。
choco install pinelabs-mcp
インストールを確認します。
pinelabs-mcp --help
stdio 経由でサーバーを実行します。
pinelabs-mcp stdio --client-id <your-client-id> --client-secret <your-client-secret> --env uat
MCP クライアントの設定(Claude Desktop / Cursor / VS Code)
choco install の実行後、MCP クライアントが pinelabs-mcp のシムを使用するように設定します。
{
"mcpServers": {
"pinelabs": {
"command": "pinelabs-mcp",
"args": ["stdio", "--env", "uat"],
"env": {
"PINELABS_CLIENT_ID": "<your-client-id>",
"PINELABS_CLIENT_SECRET": "<your-client-secret>"
}
}
}
}
アンインストールするには:
choco uninstall pinelabs-mcp
パブリック Docker イメージの使用(推奨)
公式の Pine Labs Docker イメージを直接使用します。ビルド手順は不要です。
Note: 特定のバージョンを固定するには、以下の設定で
pinelabs/mcp:latestをpinelabs/mcp:<version-tag>(例:pinelabs/mcp:v1.0.0)に置き換えてください。
Claude Desktop での使用方法
以下を claude_desktop_config.json に追加してください。
{
"mcpServers": {
"pinelabs": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"PINELABS_CLIENT_ID",
"-e",
"PINELABS_CLIENT_SECRET",
"-e",
"PINELABS_ENV",
"pinelabs/mcp:latest"
],
"env": {
"PINELABS_CLIENT_ID": "<your-client-id>",
"PINELABS_CLIENT_SECRET": "<your-client-secret>",
"PINELABS_ENV": "prod"
}
}
}
}
<your-client-id> と <your-client-secret> を Pine Labs の認証情報に置き換えてください。
- Claude Desktop での MCP サーバーの設定:MCP クイックスタートガイド
- Claude Desktop のインストール:ダウンロード
VS Code での使用方法
以下を VS Code の設定(JSON)に追加してください。
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "pinelabs_client_id",
"description": "Pine Labs Client ID"
},
{
"type": "promptString",
"id": "pinelabs_client_secret",
"description": "Pine Labs Client Secret",
"password": true
}
],
"servers": {
"pinelabs": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"PINELABS_CLIENT_ID",
"-e",
"PINELABS_CLIENT_SECRET",
"-e",
"PINELABS_ENV=prod",
"pinelabs/mcp:latest"
],
"env": {
"PINELABS_CLIENT_ID": "${input:pinelabs_client_id}",
"PINELABS_CLIENT_SECRET": "${input:pinelabs_client_secret}"
}
}
}
}
}
VS Code の MCP サーバーについて詳しくは、エージェントモードのドキュメントを参照してください。
Cursor での使用方法
{
"mcpServers": {
"pinelabs": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"PINELABS_CLIENT_ID",
"-e",
"PINELABS_CLIENT_SECRET",
"-e",
"PINELABS_ENV=prod",
"pinelabs/mcp:latest"
],
"env": {
"PINELABS_CLIENT_ID": "<your-client-id>",
"PINELABS_CLIENT_SECRET": "<your-client-secret>"
}
}
}
}
<your-client-id> と <your-client-secret> を Pine Labs の認証情報に置き換えてください。
Docker からビルドする(代替方法)
リポジトリをクローンし、Docker イメージをローカルでビルドします。
git clone https://github.com/plural-pinelabs/pinelabs-online-mcp.git
cd pinelabs-online-mcp
docker build -t pinelabs-mcp-server:latest .
ビルド後、上記の設定で pinelabs/mcp:latest を pinelabs-mcp-server:latest に置き換えてください。
ソースからビルドする
Docker を使用せず、ソースから直接サーバーを実行します。
# Clone the repository
git clone https://github.com/plural-pinelabs/pinelabs-online-mcp.git
cd pinelabs-online-mcp
# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate # macOS/Linux
# .venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
# Run the server (stdio mode)
python -m cli.pinelabs_mcp_server.main stdio \
--client-id <your-client-id> \
--client-secret <your-client-secret> \
--env prod
起動したら、ローカルプロセスに接続するよう MCP クライアントを設定してください。VS Code の場合の例:
{
"mcp": {
"servers": {
"pinelabs": {
"command": "python",
"args": [
"-m",
"cli.pinelabs_mcp_server.main",
"stdio"
],
"env": {
"PINELABS_CLIENT_ID": "<your-client-id>",
"PINELABS_CLIENT_SECRET": "<your-client-secret>",
"PINELABS_ENV": "prod"
}
}
}
}
}
設定
環境変数
| 変数 | 必須 | デフォルト | 説明 |
|---|---|---|---|
PINELABS_CLIENT_ID | はい | -- | API 認証用の Pine Labs クライアント ID |
PINELABS_CLIENT_SECRET | はい | -- | API 認証用の Pine Labs クライアントシークレット |
PINELABS_ENV | いいえ | uat | 対象環境:uat または prod |
LOG_LEVEL | いいえ | INFO | ログの詳細度:DEBUG、INFO、WARNING、ERROR |
LOG_FILE | いいえ | stderr | ログ出力ファイルのパス |
READ_ONLY | いいえ | false | 読み取り専用ツールに制限します(書き込み操作を無効にします) |
TOOLSETS | いいえ | all | 有効にするツールセットをカンマ区切りで指定します |
コマンドラインフラグ
python -m cli.pinelabs_mcp_server.main <transport> [options]
Transports:
stdio Standard I/O transport (for MCP clients)
http HTTP transport (for web-based access)
Options:
--client-id Pine Labs client ID
--client-secret Pine Labs client secret
--env Environment: uat, prod (default: uat)
--log-file Path to log file
--log-level Log level: DEBUG, INFO, WARNING, ERROR
--read-only Only register read-only tools
--toolsets Comma-separated list of toolsets to enable
HTTP-only options:
--host Host to bind to (default: 0.0.0.0)
--port Port to listen on (default: 8000)
サーバーのデバッグ
トラブルシューティング用に詳細なログを出力するには、--log-level DEBUG フラグを使用し、必要に応じて --log-file を指定してください。
python -m cli.pinelabs_mcp_server.main stdio \
--client-id <ID> --client-secret <SECRET> \
--log-level DEBUG --log-file ./debug.log
よくある質問
Q: 金額はパイサで指定する必要がありますか?
A: いいえ。金額はルピーで指定します(例:INR 500 の場合は 500)。パイサへの換算は不要です。
Q: どの環境がサポートされていますか?
A: サーバーは uat(デフォルト)と prod の環境をサポートしています。PINELABS_ENV または --env で設定してください。
Q: 利用可能なツールを制限できますか?
A: はい。書き込み操作を無効にするには --read-only フラグを使用するか、特定のツールセットを有効にするには --toolsets を使用してください(例:--toolsets payment_links,orders)。
Q: API リファレンスの全文はどこで確認できますか? A: Pine Labs Developer Documentation で API リファレンスの全文を確認できます。
キーワード
Pine Labs、Pine Labs Online、Plural、Plural Online、ペイメントゲートウェイ、オンラインペイメントゲートウェイ、チェックアウトゲートウェイ、ペイメントチェックアウト、オンラインチェックアウト、ホステッドチェックアウト、決済ページ、決済、オンライン決済、デジタル決済、決済処理、決済の受付、決済の回収、決済インテグレーション、ゲートウェイインテグレーション、決済 API、決済 API、チェックアウト API、ゲートウェイ API、UPI、カード、クレジットカード、デビットカード、ネットバンキング、ウォレット、EMI、カードレス EMI、サブスクリプション、継続課金、注文、注文決済、決済の作成、決済の開始、決済の処理、決済リンク、MCP サーバー、Model Context Protocol、AI 決済自動化、エージェント型決済、QR コード決済、決済オーケストレーション、加盟店 API、取引レポート、フィンテック、SDK
ライセンス
このプロジェクトは Apache 2.0 ライセンスのもとでライセンスされています。ライセンス条項の全文については、LICENSE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。