agent-receipts-mcp

agent-receipts

AI エージェントの行動を証明しましょう。

2026 年 8 月 2 日、EU AI Act の高リスク AI システムに対する記録保持義務が適用されました。これには、自動イベント記録（第 12 条）、導入者によるログの 6 か月以上の保管（第 26 条）、および最大 1,500 万ユーロまたは全世界の売上高の 3％の罰則が含まれます。監査人、規制当局、取引相手から問われるのは、簡単なことです。

「あなたの AI エージェントはこれを承認しました。実際に何をしたのか、そして記録が誰にも編集されていないことを証明してください。」

通常のログファイルでは答えられません。ログを所有する人なら誰でも編集できるからです。agent-receipts は、影響の大きいエージェントのアクションすべてに、暗号署名付きのタイムスタンプ付きレシートを発行します。誰でもオフラインで検証でき、コンプライアンス担当者にそのまま渡せる署名付き監査バンドルもエクスポートできます。

レシートが証明すること

• 何がいつ起きたか — アクションの種類、概要、実行者、主体、ISO 8601 タイムスタンプ
• 改ざんされていないこと — 正規化 JSON に対する Ed25519 署名。1 文字でも変更すると検証に失敗します
• 削除されていないこと — レシートは、各ボールト内で単調増加するシーケンス番号とともにハッシュチェーン化されます。すべての監査エクスポートで、欠落（削除）とチェーンの破損を自動的に検出します
• データを公開せずに — ハッシュのみを使うプライバシー保護。ペイロードは SHA-256 でフィンガープリント化され、直ちに破棄されます。保存も送信もされません

監査に必要なやり取りに対応

export_audit_bundle は、コンプライアンスで実際に必要とされるものを生成します。指定期間内のすべてのレシート、改ざん検出レポート（シーケンスの欠落、チェーンの破損）、署名用公開鍵、バンドル全体に対するマニフェスト署名です。保持期間は自由に管理できます。ボールトはローカルの SQLite ファイルなので、第 26 条（またはお客様のポリシー）で求められる期間、保管できます。

私たちを信頼する必要はありません。 バンドルに含まれる CLI を使い、ピン留めした公開鍵でレシートをオフラインで検証できます。アカウントもネットワーク接続も不要で、このサービスが明日も存在することに依存しません。これにより、証拠が長期間有効に保たれます。

クイックスタート（MCP — ローカル、無料）

// Claude Desktop / Claude Code / any MCP client
{
  "mcpServers": {
    "agent-receipts": {
      "command": "npx",
      "args": ["-y", "agent-receipts-mcp"],
      "env": { "AGENT_RECEIPTS_DATA": "<where-to-keep-the-vault>" }
    }
  }
}

Node.js >= 22.13 が必要です（組み込みの node:sqlite を使用し、ネイティブ依存関係はありません）。 ワンクリックでの導入をご希望ですか？Releases から .mcpb バンドルを入手し、Claude Desktop で開いてください。

ツール	エージェントが呼び出すタイミング
issue_receipt	影響の大きいアクションの直後。署名付きレシートを返します。
verify_receipt	別のエージェントまたはシステムが提示したレシートを信頼する前。
export_audit_bundle	指定期間の監査証跡を人から求められたとき。
get_service_info	オフライン検証用にピン留めする公開鍵を取得するとき。

クイックスタート（HTTP API）

npm install && npm run build
npm run serve        # http://localhost:8787

# 1. Create a vault (returns your API key — shown once)
curl -X POST localhost:8787/v1/vaults -d '{"name":"acme-compliance"}'

# 2. Issue a receipt after an agent action
curl -X POST localhost:8787/v1/receipts \
  -H "Authorization: Bearer ark_..." \
  -d '{"action_type":"invoice.approved","summary":"Approved INV-1042 for EUR 1,250",
       "payload":{"invoice":"INV-1042","amount":1250},"actor":"agent:ap-bot@acme"}'

# 3. Anyone can verify — no auth
curl -X POST localhost:8787/v1/verify -d '{"receipt":{...}}'

# 4. Export a signed audit bundle for the compliance officer
curl "localhost:8787/v1/export?from=2026-01-01" -H "Authorization: Bearer ark_..."

マシンによる検出用のサービスマニフェスト：GET /.well-known/agent-receipts.json。

オフライン検証

npx -y -p agent-receipts-mcp agent-receipts-verify receipt.json --pubkey <base64-spki-der>
# exit 0 = authentic, exit 1 = invalid/tampered

レシート形式（agent-receipts/v1）

{
  "schema": "agent-receipts/v1",
  "id": "rcpt_...",
  "vault_id": "vlt_...",
  "sequence": 42,                      // monotonic per vault; gaps = deletion evidence
  "issued_at": "2026-07-15T12:34:56.789Z",
  "action": {
    "type": "invoice.approved",
    "summary": "Approved invoice INV-1042 for EUR 1,250",
    "actor": "agent:ap-bot@acme",      // optional
    "principal": "acme-gmbh",          // optional
    "context": { "jurisdiction": "EU" } // optional
  },
  "payload_hash": "sha256:...",        // or null; contents never stored
  "prev_receipt_hash": "sha256:...",   // hash chain to the previous receipt
  "key_id": "key_...",
  "public_key": "<base64 SPKI DER>",   // embedded for offline verification
  "signature": "<base64 Ed25519 over canonical JSON of everything above>"
}

正規化には JCS 方式を採用しています。キーは辞書順に並び、空白は含みません。 JSON Schema は docs/receipt.schema.json にあります。

EU AI Act との対応（参考情報）

義務	agent-receipts による支援
第 12 条 — 自動イベント記録	影響の大きいアクションごとに issue_receipt を実行。タイムスタンプ、実行者、追跡可能なチェーンを記録
第 26 条 — ログを 6 か月以上保管	お客様の判断で保持できるローカルボールト。引き継ぎ用の署名付き export_audit_bundle
トレーサビリティ／完全性	Ed25519 署名、ハッシュチェーン、削除検出、オフライン検証

法的助言ではありません。 お客様のシステムが「高リスク」に該当するか、何を記録する必要があるかは、顧問弁護士にご相談ください。agent-receipts は証拠を保全するためのインフラを提供します。

ステータスとロードマップ

• コア機能：ハッシュチェーンと Ed25519 による発行／検証／エクスポート
• MCP stdio サーバー + HTTP API + オフライン検証用 CLI + MCPB バンドル
• 領収書ごとの料金設定に対応したホスト型ボルト
• RFC 3161／透明性ログへのタイムスタンプのアンカリング
• 鍵のローテーションと複数鍵の検証

MIT ライセンス。