pp-mercury

Mercury — Printing Press CLI

前提条件：CLI をインストールする

このスキルは mercury-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。macOS/Linux ではデフォルトで $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

   npx -y @mvanhorn/printing-press-library install mercury --cli-only
   

2. 確認します：mercury-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールが失敗した場合（Node がない、オフラインなど）は、Go による直接インストールに切り替えてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/payments/mercury/cmd/mercury-pp-cli@latest

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

固有の機能

これらの機能は、この API のほかのツールでは利用できません。

• workflow payment-plan — 支払いまたは送金の書き込みを実行する前に、本文、冪等性キー、ドライランコマンド、実行コマンドを含む読み取り専用の承認プランを作成します。

  エージェントは資金を移動せずに、正確な書き込みコマンドを準備できます。

  mercury-pp-cli workflow payment-plan --kind transfer --source-account-id acct_src --destination-account-id acct_dst --amount 25 --agent
  

• workflow archive — 対応する Mercury リソースをローカルの SQLite ストアに同期し、オフライン検索や分析に利用できるようにします。

  API 呼び出しを減らし、エージェントが再現可能なコンテキストを利用できるようにします。

  mercury-pp-cli workflow archive --agent
  

• agent-context — エージェントや MCP ホスト向けに、機械可読なコマンドメタデータを出力します。

  自律的なコマンド選択を改善し、コンテキストの無駄を減らします。

  mercury-pp-cli agent-context --agent
  

コマンドリファレンス

account — 銀行口座を管理します

• mercury-pp-cli account <accountId> — ID で口座を取得します

accounts — 銀行口座を管理します

• mercury-pp-cli accounts — ページネーションされた口座の一覧を取得します。カーソルベースのページネーションに対応しており、limit、order、start_after などを指定できます。

ar — 売掛金を管理します

• mercury-pp-cli ar cancel-invoice — 請求書をキャンセルします。この操作は取り消せません。
• mercury-pp-cli ar create-customer — 組織に新しい顧客を作成します
• mercury-pp-cli ar create-invoice — 組織に新しい請求書を作成します
• mercury-pp-cli ar delete-customer — 顧客を削除します。この操作は取り消せません。
• mercury-pp-cli ar get-attachment — ダウンロード URL を含む添付ファイルの詳細を取得します
• mercury-pp-cli ar get-customer — ID で指定した顧客の詳細を取得します
• mercury-pp-cli ar get-invoice — ID で指定した請求書の詳細を取得します
• mercury-pp-cli ar get-invoice-pdf — 指定した請求書の PDF ファイルをダウンロードします。レスポンスには Content-Disposition ヘッダーが含まれ、次のように設定されます。
• mercury-pp-cli ar list-customers — ページネーションされた顧客の一覧を取得します。カーソルベースのページネーションに対応しており、limit、order、start_after などを指定できます。
• mercury-pp-cli ar list-invoice-attachments — 指定した請求書のすべての添付ファイルの一覧を取得します
• mercury-pp-cli ar list-invoices — ページネーションされた請求書の一覧を取得します。カーソルベースのページネーションに対応しており、limit、order、start_after などを指定できます。
• mercury-pp-cli ar update-customer — 既存の顧客を更新します
• mercury-pp-cli ar update-invoice — 既存の請求書を更新します

books — 組織の帳簿を管理します

• mercury-pp-cli books delete-agent-coa-template — 特定の勘定科目表テンプレートを削除します。
• mercury-pp-cli books delete-agent-ledger-template — エージェント所有の勘定科目表テンプレート内にある既存の元帳を削除します。
• mercury-pp-cli books delete-journal-entries — 仕訳を一括削除します
• mercury-pp-cli books get-agent-coa-template — 特定の勘定科目表テンプレートの詳細を取得します。
• mercury-pp-cli books get-agent-coa-templates — すべてのデフォルトおよびエージェント所有の勘定科目表テンプレートのページ分割された一覧を取得します。これらのテンプレートは次の用途に使用できます...
• mercury-pp-cli books get-journal-entries — すべての仕訳を一覧表示します
• mercury-pp-cli books get-journal-entry — 仕訳を取得します
• mercury-pp-cli books post-agent-coa-templates — 新しいエージェント所有の勘定科目表テンプレートを作成します。これらのテンプレートは、新しい Books インスタンスの作成時に使用できます...
• mercury-pp-cli books post-agent-ledger-templates — エージェント所有の勘定科目表テンプレート内に新しい元帳を作成します。
• mercury-pp-cli books post-journal-entries — 複数の仕訳を作成します
• mercury-pp-cli books put-agent-ledger-template — エージェント所有の勘定科目表テンプレート内にある既存の元帳を更新します。
• mercury-pp-cli books put-journal-entries — 仕訳を一括更新します

cards — カードを管理します

• mercury-pp-cli cards create — 新しいバーチャルカードを発行します。
• mercury-pp-cli cards get — ID を指定して、特定のカードの詳細を取得します。
• mercury-pp-cli cards list — カードのページ分割された一覧を取得します。
• mercury-pp-cli cards update — カードのニックネームまたは利用限度額を更新します。

categories — 経費カテゴリを管理します

• mercury-pp-cli categories create-category — 組織用の新しいカスタム経費カテゴリを作成します。
• mercury-pp-cli categories list — 組織で利用できるすべてのカスタム経費カテゴリのページ分割された一覧を取得します。カーソルベースの...

credit — クレジット口座を管理します

• mercury-pp-cli credit — 組織のすべてのクレジット口座の一覧を取得します。

events — API イベントを管理します

• mercury-pp-cli events get — すべてのイベントを取得します
• mercury-pp-cli events get-eventid — ID でイベントを取得します

organization — 組織情報

• mercury-pp-cli organization — EIN、正式な事業名、DBA など、組織に関する情報を取得します。

recipient — 支払先を管理します

• mercury-pp-cli recipient get — ID を指定して、特定の支払先の詳細を取得します
• mercury-pp-cli recipient update — 特定の支払先の情報を編集します

recipients — 支払先を管理します

• mercury-pp-cli recipients create — 支払いを行うための新しい支払先を作成します
• mercury-pp-cli recipients get — すべての支払先のページ分割された一覧を取得します。ページネーションにはカーソルパラメーター（start_after、end_before）を使用します。
• mercury-pp-cli recipients list-attachments — 組織内のすべての支払先に関する税務書類添付ファイルのページ分割された一覧を取得します。使用...

request-send-money — 送金リクエストを管理します

• mercury-pp-cli request-send-money get-send-money-approval-request — ID で送金承認リクエストを取得します
• mercury-pp-cli request-send-money list-send-money-approval-requests — 認証済み組織の送金承認リクエストのページ分割された一覧を取得します。フィルタリングに対応...

safes — SAFE（Simple Agreement for Future Equity）リクエストを管理します

• mercury-pp-cli safes get-request — ID を指定して、特定の SAFE リクエストを取得します。
• mercury-pp-cli safes get-requests — 組織のすべての SAFE（Simple Agreement for Future Equity）リクエストを取得します。

statements — 口座明細をダウンロードします

transaction — 取引を管理します

• mercury-pp-cli transaction get-by-id — IDで単一の取引を取得します。添付ファイル、小切手画像などを含む取引の詳細情報を返します。
• mercury-pp-cli transaction update — 既存の取引のメモやカテゴリーを更新します。既存のデータを消去するには、null値を使用します。

transactions — 取引を管理します

• mercury-pp-cli transactions — すべての口座にわたる取引のページ分割された一覧を取得します。日付範囲などによる高度なフィルタリングに対応しています。

transfer — 資金移動を管理します

• mercury-pp-cli transfer — 同じ組織内の2つの口座間で資金を移動します。預金口座間の資金移動に対応しています。

treasury — 財務口座と取引を管理します

• mercury-pp-cli treasury — 認証済みの組織に関連付けられたすべての財務口座のページ分割された一覧を取得します。カーソルを使用します。

users — 組織のチームメンバーを管理します

• mercury-pp-cli users get — すべてのユーザーを取得します
• mercury-pp-cli users get-userid — IDでユーザーを取得します

webhooks — Webhookを管理します

• mercury-pp-cli webhooks create — イベント通知を受け取る新しいWebhookエンドポイントを登録します
• mercury-pp-cli webhooks delete — Webhookエンドポイントを削除します
• mercury-pp-cli webhooks get — 組織のすべてのWebhookエンドポイントのページ分割された一覧を取得します。ステータスによるフィルタリングに対応しています。
• mercury-pp-cli webhooks get-webhookendpointid — IDで特定のWebhookエンドポイントの詳細を取得します
• mercury-pp-cli webhooks update — 既存のWebhookエンドポイントの設定を更新します。連続して発生したために無効化されたWebhookは……

適切なコマンドを見つける

何をしたいかはわかっていても、どのコマンドを使えばよいかわからない場合は、CLIに直接尋ねてください。

mercury-pp-cli which "<capability in your own words>"

whichは、自然言語での機能に関する問い合わせを、このCLIの厳選された機能インデックスから最適なコマンドに対応付けます。終了コード0は少なくとも1つの候補が見つかったことを示し、終了コード2は確実な候補がないことを示します。その場合は--helpを使うか、より具体的な問い合わせをしてください。

認証の設定

アクセストークンを保存します。

mercury-pp-cli auth set-token YOUR_TOKEN_HERE

または、環境変数MERCURY_BEARER_AUTHを設定します。

mercury-pp-cli doctorを実行して、設定を検証します。

エージェントモード

任意のコマンドに--agentを追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdoutにJSONを出力し、エラーはstderrに出力します

• フィルタリング可能 — --selectでフィールドを絞り込みます。ドット区切りのパスはネストした構造をたどり、配列では各要素を走査します。出力の多いAPIでコンテキストを小さく保つうえで重要です。

  mercury-pp-cli account mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-runで、リクエストを送信せずに内容を表示します

• オフライン対応 — 同期／検索コマンドは、利用可能な場合にローカルのSQLiteストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 明示的な再試行 — 既存の作成対象を成功として扱う場合にのみ--idempotentを使用し、削除対象が存在しない場合に成功として扱う場合にのみ--ignore-missingを使用します

レスポンスエンベロープ

ローカルストアまたはAPIからデータを読み取るコマンドは、出力を出所を示すエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには.resultsを解析し、ライブデータかローカルデータかを確認するには.meta.sourceを参照してください。人間が読めるN results (live)の概要は、stdoutが端末の場合にのみstderrに出力されます。パイプやエージェントで利用する場合、stdoutには純粋なJSONが出力されます。

エージェントからのフィードバック

このCLIについて気になる点に気づいた場合（エージェントが気づいた場合も含む）、記録してください。

mercury-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
mercury-pp-cli feedback --stdin < notes.txt
mercury-pp-cli feedback list --json --limit 10

記録は~/.mercury-pp-cli/feedback.jsonlにローカル保存されます。MERCURY_FEEDBACK_ENDPOINTが設定され、かつ--sendが渡されるか、MERCURY_FEEDBACK_AUTO_SEND=trueに設定されない限り、POSTされることはありません。デフォルトの動作はローカル保存のみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1行で記録してください。積み重ねることで効果が生まれるのは、その部分です。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力に加えて（または標準出力の代わりに）、指定したシンクに送られるため、エージェントはコマンド結果をパイプで手動転送せずに振り分けられます。サポートされているシンクは3種類です。

シンク	動作
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルを作成してリネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポート対象の一覧を示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを標準エラー出力に記録します。

名前付きプロファイル

プロファイルは、呼び出しごとに再利用できるフラグ値の保存セットです。スケジュールされたエージェントが毎回同じ設定で同じコマンドを実行する場合に使用します。これは HeyGen の「Beacon」パターンです。

mercury-pp-cli profile save briefing --json
mercury-pp-cli --profile briefing account mock-value
mercury-pp-cli profile list --json
mercury-pp-cli profile show briefing
mercury-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context は、実行時に情報を調べるエージェントがプロファイルを検出できるよう、すべてのプロファイルを available_profiles の下に一覧表示します。

終了コード

コード	意味
0	成功
2	使用方法エラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待機して再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → mercury-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照してください
3. それ以外 → 直接使用（--agent を指定して CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/payments/mercury/cmd/mercury-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add mercury-pp-mcp -- mercury-pp-mcp
   

3. 検証します：claude mcp list

直接使用

1. インストール済みか確認します：which mercury-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の固有の機能とコマンドリファレンスから選びます。
3. --agent フラグを指定して実行します。

   mercury-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：mercury-pp-cli <command> --help。