InFlow — agentic MPP (Machine Payments Protocol) / x402 payments from your machine. について
InFlowは、エージェント向けのサービス発見、登録、決済を行うコマンドラインクライアント兼MCPサーバーです。ODPでサービスを見つけ、AEPでアクセスを確立し、MPPまたはx402で保護されたエンドポイントに支払います。認証情報は暗号化されたローカル保管庫に保存されます。
主な機能
- 01ODPによるサービスと提供内容の発見
- 02AEPによるサービスアクセスの確立
- 03MPPまたはx402による保護エンドポイントへの支払い
- 04暗号化されたローカル保管庫で認証情報を管理
- 05エージェントスキルとMCPサーバーの提供
活用シーン
- 01サービスや実行可能なアクションの検索
- 02サービスへの登録と認証情報の管理
- 03MPPまたはx402保護エンドポイントの確認と支払い
- 04MCP統合アシスタントへのコマースワークフロー提供
MCP 対応
InFlowのバイナリにはMCPサーバーが含まれ、`inflow --mcp`で起動します。プラグインはエージェントスキルとともにこれを同梱し、MCPクライアントから発見、登録、決済のワークフローを利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
19掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| clientName | string | いいえ | デバイス認証中にユーザーに表示されるエージェントまたはアプリ名。 |
| interval | number | いいえ | インラインポーリング間隔(秒)。0 の場合は検証 URL と後続コマンドのヒントをすぐに返します。正の値の場合は、デバイスフローが終了するまでポーリングします。 |
| maxAttempts | number | いいえ | ポーリング回数の上限です。0 は無制限を意味します(--timeout による制限を除く)。 |
| timeout | number | いいえ | ポーリング期限(秒)。 |
詳細
inflow
InFlowは、エージェントによるディスカバリー、オンボーディング、決済のためのコマンドラインクライアントです。
エージェントはODPを通じてサービスやオファリングを見つけ、AEPを通じてサービスへのアクセスを確立し、MPPまたはx402を通じて保護されたエンドポイントの料金を支払います。人間はMCP統合アシスタントまたはInFlow CLIから同じワークフローを利用できます。
初めての方は、packages/cli/README.mdのコマンドリファレンスから始めてください。auth、ODPディスカバリー、x402およびmppのコマンドグループ、グローバルフラグ、エージェント向け(--format)の表示形式について説明しています。
エージェントホストにインストールする場合は、サーフェスごとのガイドをご覧ください。
docs/development/surfaces-and-testing.md。
インストール
InFlowは、署名済みのネイティブアプリケーションとして配布されています。npmパッケージは互換性に関する案内であり、コマンドの実行、MCPの起動、認証情報の管理は行いません。
一般公開されているインストール方法は、Apple SiliconおよびIntel搭載Mac、Windows x64およびARM64、Linux ARM64およびAMD64に対応しています。Homebrew、ホステッドインストーラー、WinGet、GitHub Releaseからの直接ダウンロードでは、各プラットフォーム向けの署名済みネイティブアプリケーションがインストールされます。
Homebrew Cask
brew tap inflowpayai/tap
brew install --cask inflow
inflow --version
Homebrewでアップグレードまたはアンインストールします。
brew upgrade --cask inflow
brew uninstall --cask inflow
ホステッドインストーラー
macOS、Debian/Ubuntu、Fedora/RHELの場合:
curl -fsSL https://inflowcli.ai/install.sh | bash
macOSでは、インストーラーが現在のアーキテクチャを選択し、チェックサム、コード署名、Gatekeeperのチェックを検証してから、InFlow.appを~/.local/share/inflowにインストールし、inflowを~/.local/binにリンクします。Linuxでは、OpenPGP署名済みリリースマニフェストとパッケージのチェックサムを検証してから、対応するDebianまたはRPMのシステムパッケージをインストールします。
インストーラーを再実行すると、最新のGitHub Releaseにアップグレードできます。アンインストールするには、次を実行します。
curl -fsSL https://inflowcli.ai/install.sh | bash -s -- --uninstall
Windowsでは、Windows Installerの昇格プロンプトを承認できるユーザーとしてPowerShellを実行します。
irm https://inflowcli.ai/install.ps1 | iex
PowerShellインストーラーはx64またはARM64を選択し、MSIのチェックサム、Authenticodeの状態、発行元を検証してから、Windows Installerを通じてパッケージをインストールします。再実行するとアップグレードできます。暗号化されたボールトデータを保持したままアンインストールするには、次を実行します。
$env:INFLOW_UNINSTALL = '1'
try { irm https://inflowcli.ai/install.ps1 | iex } finally { Remove-Item Env:INFLOW_UNINSTALL }
互換性シェルのエンドポイントは、macOS、Linux、Git BashのようなWindows環境で、プラットフォーム用インストーラーに処理を委譲します。
curl -fsSL https://inflowcli.ai/cli | bash
WinGet
winget install --id InFlowPayAI.InFlow --exact
WinGetでアップグレードまたはアンインストールします。
winget upgrade --id InFlowPayAI.InFlow --exact
winget uninstall --id InFlowPayAI.InFlow --exact
直接ダウンロード
パッケージのバージョンに合った成果物を、inflowpayai/inflow-cli の GitHub リリースからダウンロードします。
- Apple Silicon 搭載 Mac 用の
inflow-<version>-darwin-arm64.zip - Intel Mac 用の
inflow-<version>-darwin-x64.zip - Windows ARM64 用の
inflow-<version>-windows-arm64.msi - Windows x64 用の
inflow-<version>-windows-x64.msi
zip には InFlow.app が含まれています。実行ファイルはアプリバンドル内の InFlow.app/Contents/MacOS/inflow にあります。
Linux リリースには、ARM64 および AMD64 の Debian パッケージ、RPM パッケージ、スタンドアロンアーカイブが含まれています。Debian パッケージと RPM パッケージは、Linux のセキュリティモデルで必要となるシステムボルトサービスをインストールします。
Windows MSI パッケージは、コマンドラインアプリケーションとオンデマンドのボルトサービスをインストールします。Windows はインストール前に Authenticode 署名と発行元を検証します。
認証情報ボルトを初期化する
認証情報を扱うコマンドは、暗号化されたローカル InFlow ボルトを使用します。人が操作するターミナルで初期化またはロック解除してください。
inflow vault unlock
PIN またはパスフレーズはターミナルからのみ読み取られます。MCP 引数、コマンドラインフラグ、環境変数、構造化されたエージェント入力ではありません。inflow vault status、inflow vault lock、inflow vault policy の実行に、ロック解除要素は必要ありません。
エージェントスキル
このリポジトリでは、インストール可能な 3 つのエージェントスキルを公開しています。
| スキル | 用途 |
|---|---|
agentic-discovery | ODP を通じてサービスとオファリングを検索し、コレクションを閲覧して、アクションを解決します。 |
agentic-enrollment | AEP サービスに登録し、サービスの認証情報を管理します。 |
agentic-payments | MPP または x402 で保護されたエンドポイントを調査し、支払いを行います。 |
Skills CLI を使って 3 つすべてをインストールします。
npx skills add inflowpayai/inflow-cli
InFlow バイナリには、同じプレイブックが組み込まれています。--skill は、スキルを直接インストールできないエージェントホスト向けにプレイブックを表示します。スキルはインストールしません。
inflow --skill agentic-discovery
inflow --skill agentic-enrollment
inflow --skill agentic-payments
このリポジトリは、プラグイン対応ホスト向けのインストール可能なプラグイン(スキルと MCP サーバーをバンドル)としても提供されています。
-
Claude Code — マーケットプレイスを追加してから、プラグインをインストールします。
/plugin marketplace add inflowpayai/inflow-cli /plugin install inflow@inflowここで
inflowpayai/inflow-cliは GitHub リポジトリのスラッグです。マーケットプレイス、プラグイン、バイナリはいずれもinflowという名前なので、インストール対象はinflow@inflowです。 -
Cursor / Codex — ホストにこのリポジトリを指定します。ホストはそれぞれ
.cursor-plugin/marketplace.json、.agents/plugins/marketplace.json、.codex-plugin/plugin.jsonを検出します。
どの場合も、プラグインにはスキルと inflow MCP サーバー(.mcp.json)がバンドルされています。デフォルトの MCP エントリは inflow --mcp を実行します。MCP サーバーを使用する前に、署名済みのネイティブバイナリをインストールしてください。
最初のエージェント型コマースのフロー
購入者側の CLI ワークフローでは、通常の InFlow アカウントを使用します。支払いを受け付けるサービス運営者には、別途 Seller アカウントと、対応する Node.js seller SDK が必要です。
# Human-controlled setup
inflow vault unlock
inflow auth login
# Discover Services and Collections, then inspect a Service
inflow directory search plants --source odp
inflow inspect https://service.example
# Establish access when the Service requires enrollment
inflow aep enroll https://service.example
# Inspect and pay the protected endpoint selected from an ODP Action
inflow mpp inspect https://service.example/actions/purchase
inflow mpp pay https://service.example/actions/purchase
3 つのプロトコルレイヤーは、すべてのリクエストで必須というわけではなく、組み合わせて使用できます。ODP は Service、Offering、実行可能な Action を特定します。必要に応じて、AEP により Service へのアクセスを確立します。選択したエンドポイントが支払いチャレンジを返した場合、MPP または x402 で支払いを完了します。必要なレイヤーがまだわからない場合は、inflow inspect から始めてください。
リンク済みカードで支払うには、販売者のオファーに応じて、通常の Instrument 支払いまたはVIC 利用枠を使った MPP CARDを選択してください。カードと利用枠は InFlow ダッシュボードで管理します。どちらの方法でも、選択したカードまたはメインカードを使用し、InFlow USD ウォレット残高は使用しません。
公開 OpenAPI ディスカバリーでは、ログインは不要です。
inflow directory search --source openapi
inflow openapi operations list https://parallelmpp.dev/openapi.json
inflow openapi operations get https://parallelmpp.dev/openapi.json --method POST --path /api/search
Directory の結果にある service.source.url を OpenAPI コマンドに渡してください。オペレーションの詳細を読み取っても、オペレーションは実行されず、支払いも発生しません。Collection の結果の場合は、--collection-id <collection.id> を追加して、選択されたオペレーションを一覧表示します。プロバイダーの正確なオペレーションタグで絞り込むには、--tag <tag> を使用してください。どちらのフィルターも指定しない場合は、ドキュメント全体が一覧表示されます。
inflow openapi operations prepare に同じオペレーションセレクターと --data または --parameters を指定すると、リクエストを送信せずにプレビューできます。複数のサーバーが提示されている場合は、明示的に選択する必要があります。認識された認証情報はマスキングされますが、通常のリクエストデータは引き続き表示されます。詳細は準備のリファレンスをご覧ください。
inflow openapi operations call に同じ入力を指定すると、オペレーションを送信できます。提示された有料オペレーションは、送信せずに MPP/x402 コマンドの案内を返します。予期しない 402 レスポンスが返された場合も、支払いは行わずに停止します。レスポンスの出力と、明示的な認証/支払いの引き継ぎについては、呼び出しのリファレンスをご覧ください。
セキュリティとローカルデータ
- OAuth トークン、API キー、Agent Enrollment Protocol の認証情報は、ローカルの SQLite ボールトで暗号化されます。
- ボールトデーモンが受け付けるのは、認証済みのローカル InFlow クライアントのみです。また、公開するのは参照先を正確に指定したシークレット操作であり、支払い、ネットワーク、署名、コマンド実行の操作は公開しません。
- デーモンはクライアントを認証し、クライアントはリクエストを送信する前にデーモンを認証します。
- ボールトのロック解除要素を入力できるのは、人間が操作するターミナルのみです。ボールトがロックされている間、エージェントと MCP の実行は安全側に停止します。
- macOS では、署名済みアプリケーションの ID を使用します。Windows では、Authenticode 署名済みのアプリケーション ID と Windows サービス ID を使用します。Linux パッケージはシステムサービスをインストールし、実行ファイル、ソケット、ピア、テナント、パッケージの各 ID を検証します。
inflow auth logoutとinflow vault resetは、ローカルの認証情報とボールトの状態を削除します。パッケージをアンインストールしても、プラットフォーム固有の消去操作を明示的に実行しない限り、暗号化されたボールトデータは保持されます。
InFlow は、認証済み API リクエスト、ユーザーが要求した販売者リソースへのリクエスト、および GitHub Release のバージョン確認(通知目的)を送信します。バージョン確認を無効にするには、NO_UPDATE_NOTIFIER=1 を設定します。確認のタイムアウトは 2 秒で、認証情報は送信されません。
アップグレードとトラブルシューティング
Homebrew でインストールした場合は brew upgrade --cask inflow、WinGet でインストールした場合は
winget upgrade --id InFlowPayAI.InFlow --exact を実行してアップグレードします。ホスト型インストールの場合は、各プラットフォームのインストーラーを再実行してください。CLI
は、署名済みの新しいリリースを報告する場合がありますが、API が VERSION_UNSUPPORTED を返さない限り処理を続行します。
エージェントまたは MCP ツールからボルトがロックされていると報告された場合は、ターミナルで自分で inflow vault unlock を実行してから、操作を再試行してください。PIN やパスフレーズをプロンプトや MCP ツールの入力欄に貼り付けないでください。
認証と環境の状態を確認するには inflow auth status --format json を、ローカルのボルトとデーモンを確認するには inflow vault status を実行してください。ホスト固有の MCP トラブルシューティングについては、サーフェスのインストールとテストガイドを参照してください。
開発
これは pnpm + Turborepo のモノレポです。Node >= 24.15.0 が必要です。
pnpm install
pnpm build
pnpm test
その他の便利なタスク:
pnpm typecheck
pnpm lint
pnpm typedoc
pnpm changeset
リリースの自動化
本番リリースでは、macOS、Windows、Linux のアーティファクトに署名して検証してから、変更不能な GitHub Release を公開し、Homebrew を更新して WinGet の提出マニフェストを生成する、単一のアトミックなネイティブワークフローを使用します。ワークフローのモード、プラットフォームの認証情報、署名の順序、復旧手順については、ネイティブリリースガイドを参照してください。
パッケージ
@inflowpayai/inflow(packages/cli) — 公開されているバイナリであり、InFlow を統合するすべての人向けのエントリーポイントです。inflow-core上の薄いレンダリングシェルです。コマンドの詳細については、packages/cli/README.mdを参照してください。@inflowpayai/inflow-core(packages/core) — バイナリを支えるヘッドレス InFlow クライアントです。各コマンドグループに、プロトコルの基本機能とコマンド形式の操作の両方を備えた拡張ハンドル(inflow.auth、inflow.user、inflow.balances、inflow.depositAddresses、inflow.subscriptions、inflow.x402、inflow.mpp)を提供し、どちらも機能させるためのヘルパー(サニタイズ、ポーリング、セラープローブ)も含みます。現在はワークスペース内部向けです。実行可能なスクリプトについては、packages/core/examples/を参照してください。
ドキュメント一覧
- CLI コマンドリファレンス - コマンド、フラグ、出力仕様、エラー。
- ヘッドレスクライアント - CLI が使用するプログラム向けインターフェース。
- エージェント向けサーフェス - スキル、プラグイン、MCP の設定。
- ネイティブリリースガイド - プラットフォームインストーラー、署名、リリースの復旧。
リポジトリ
https://github.com/inflowpayai/inflow-cli
ライセンス
MIT — Copyright (c) 2025-2026 Jarwin, Inc.
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。