Paybond CLI logo

Paybond CLI

認証する

Paybond CLI は、サンドボックスログイン、ガードレールのひな型生成、MCP設定、診断、JSON自動化まで備えた、安全なエージェント支出フローをターミナルから構築できるツールです。TypeScript と Python で同じコマンドツリーと出力契約に対応します。

Paybond CLI preview

ターミナルから安全なエージェント支出を

Paybond CLI は、ターミナルファーストのツールとして、コマンドラインから安全なエージェント支出フローを構築できます。サンドボックスログイン、ガードレールのひな型生成、MCP 設定、診断、機械可読な自動化を、1 つの共有コマンドツリーでカバーします。

TypeScript と Python のパッケージは整合性を保つように設計されており、エージェントと運用担当者は、実行環境に関係なく同じコマンド、JSON エンベロープ、終了コード契約を利用できます。ドキュメントでは、この CLI を、有償 API、ベンダーアクション、または決済ステップをワークフローが呼び出す前に、課金対象ツールのガードレールを追加するための標準的な入口として位置づけています。

セットアップフローはサンドボックスから始まり、テナントスコープの認証情報を使用し、最初の連携では実際の決済レールよりもガードレールに重点を置きます。そこから CLI はホスト設定を生成し、doctor チェックで経路を検証し、JSON 出力によるスクリプト利用をサポートできます。

主な機能

サンドボックスログイン

ガードレールや MCP コマンドを実行する前に、テナントスコープのサンドボックス認証情報で一度だけ認証します。ログインフローはサンドボックスの `PAYBOND_API_KEY` を `.env.local` に書き込み、出力ではキーの識別情報をマスクします。

ワンコマンドのガードレール

`paid-tool-guard` プリセットを使って `paybond-init` で最初の有料ツール連携をひな型生成します。生成されるヘルパーは、ツールを実装するのではなく、アプリケーション所有のツールハンドラーをラップします。

MCP のセットアップと検証

対応クライアント向けの MCP ホスト設定を生成し、接続ポイントとして `PAYBOND_ENV_FILE` を維持します。ドキュメントには Codex と JSON ベースのクライアント向けのインストールコマンドとホスト設定の例が含まれます。

診断チェック

`doctor` および関連診断を実行して、エージェントが本番の支出経路に到達する前に設定のずれを検出します。エージェント設定ガイドでは、認証情報、プリンシパル検索、MCP 起動、ツール一覧の検証を推奨しています。

JSON 自動化

スクリプトや CI 向けに機械可読な JSON エンベロープを使用し、安定した出力と TypeScript / Python パッケージ間で同期された終了コードを利用します。これにより、CLI は対話的なターミナル利用だけでなく自動化にも適しています。

一般的なワークフロー

  • リポジトリに有料ツールのガードレールを追加する

    コーディングエージェントが有料ツールを呼び出す前に支出制御を追加する必要があります。CLI は、ライブのワークフローを試す前に、サンドボックスログイン、ガードレールのひな型生成、検証までリポジトリを案内します。

  • ランタイム間でエージェントセットアップを標準化する

    運用担当者は、TypeScript と Python の両方で動作する 1 つのセットアップ経路を求めています。共有コマンドツリーと JSON 契約により、両方のランタイムでセットアップと自動化を標準化できます。

  • コーディングエージェント向けに MCP アクセスを準備する

    チームは、エージェントを実行する前に MCP クライアントを接続し、設定を検証する必要があります。CLI はホスト設定を生成し、`PAYBOND_ENV_FILE` を指し示し、エンドツーエンドの経路検証を支援できます。

  • CI でセットアップとチェックを自動化する

    ビルドまたは自動化ジョブには機械可読な出力が必要です。CLI の JSON エンベロープと一貫した終了コードにより、人間向けテキストを解析せずにスクリプトや CI パイプラインで利用できます。

Pros and Cons

Pros

  • ログイン、ガードレールのひな型生成、MCP インストール、診断、自動化を 1 つの CLI にまとめています。
  • TypeScript と Python を同じコマンドツリーと JSON 契約で揃えています。
  • 初期の連携では実際の送金を避けるサンドボックスファーストのセットアップを採用しています。
  • スクリプト、CI、エージェント自動化向けに機械可読な JSON 出力を提供します。
  • `doctor --agent` や MCP インストール検証などの検証手順がドキュメント化されています。

Cons

  • 最初の連携経路はサンドボックス専用で、ライブの決済レールは初期のひな型には含まれていません。
  • ソースには製品ページ上の完全なコマンドリファレンスが示されていないため、一部の詳細はドキュメントにあります。
  • MCP サーバーの起動は引き続きホスト設定または `npx` に依存しており、ログイン手順に完全に組み込まれているわけではありません。

FAQ

TypeScript と Python の両方が必要ですか?

いいえ。ドキュメントによると、TypeScript か Python のどちらかを選べばよく、どちらも同じ `paybond` コマンドツリーと JSON 契約を提供します。

完全なコマンドリファレンスはどこで確認できますか?

CLI の契約ドキュメントが、フラグ、サブコマンド、JSON エンベロープ、そして 2 つのランタイム間の整合性保証の参照元です。

CLI は MCP サーバーとどのように関係しますか?

CLI は MCP ホスト設定のインストールと検証を行います。MCP サーバー自体は、ログイン後に `npx` またはホストの stdio 設定を通じて別途起動されます。

コーディングエージェントの一般的なセットアップ手順は何ですか?

`paybond login` またはログイン用パッケージのエントリポイントを使ってサンドボックスの `PAYBOND_API_KEY` を `.env.local` に書き込み、その後 `paybond mcp install` でホスト設定を生成し、`paybond doctor --agent` でセットアップを検証します。

Paybond CLI は有料プランに紐づいていますか?

ドキュメントでは、Free Developer はサンドボックス専用で、Starter が最初の有料本番プランとされています。Team、Business、Enterprise では、より高い上限、超過オプション、より広い制御が追加されます。

Quick Facts

Category
Developer Tool
Primary use
ターミナルからの安全なエージェント支出と有料ツールのガードレール
Runtimes
TypeScript and Python
Install options
Node 用の npx または Python パッケージのインストール
Pricing
Free Developer はサンドボックス専用; Starter が最初の有料本番プラン
Source domain
paybond.ai