Postcept

@postcept/mcp

AI エージェントの成果検証を行う Postcept を MCP ツールとして公開する、Model Context Protocol サーバーです。

エージェントが高リスクの操作（返金、サブスクリプションの解約、サポートチケットの解決など）を行った後、verify_* ツールを呼び出して、操作が実際に記録システム（Stripe、Zendesk など）で完了したことを確認し、署名付きの完了レシートを取得します。「完了」は単なる申告ではなく、証明になります。

このサーバーは、稼働中の Postcept HTTP API を薄くラップしたものです。Postcept API キー以外の認証情報は保持せず、システム・オブ・レコードに対する検証は読み取り専用です。

設定

変数	必須	デフォルト	備考
POSTCEPT_API_KEY	はい	なし	verifications:write を持つ Postcept API キー（pcpt_sk_...）です。
POSTCEPT_BASE_URL	いいえ	https://api.postcept.com	セルフホストまたはステージング API を指定します。

Postcept ダッシュボードの API キー から API キーを作成します。

Claude Desktop / Claude Code での使用

{
  "mcpServers": {
    "postcept": {
      "command": "npx",
      "args": ["-y", "@postcept/mcp"],
      "env": { "POSTCEPT_API_KEY": "pcpt_sk_..." }
    }
  }
}

ツール

ツール	目的
verify_refund	申告された返金を検証します（存在、金額・通貨・顧客の一致、重複の有無）。
verify_cancellation	サブスクリプションが実際に解約されたことを検証します。
verify_ticket	サポートチケットが想定された状態にあることを検証します。
get_verification	過去の検証と、その署名付きレシートを ID で取得します。
reconcile_verification	過去の検証を、稼働中のシステム・オブ・レコードと照合して再検証します。
verified_completion_rate	組織の検証済み完了率を取得します。

すべての verify_* ツールは test: true を受け付け、決定論的なサンドボックスコネクターに対して実行できます（検証済み完了率からは除外されます）。これにより、エージェントは稼働中のシステム・オブ・レコードを使わずに一連のフロー全体を試せます。

verified 以外の結果（incomplete、duplicated、mismatched、policy_failed）は、作業が完了していないことを意味します。不足を明らかにし、復旧してください。

設計上、アドバイザリーです

MCP では検証の呼び出しをエージェントが行うため、開発、デモ、またはエージェントの判断がすでに信頼されているワークフローに適した統合方法です。これはアドバイザリーです。エージェントは呼び出しを省略したり、誤った識別子を渡したり、結果を無視したりできます。

重大な影響を伴う操作では、エージェントの外部で判断を強制してください。ワークフローまたはオーケストレーターが Postcept API（または SDK の guard()）を自ら呼び出し、顧客に何かを通知する前に safe_to_claim_complete の値に応じて処理を分岐します。するとエージェントは、自ら判断するのではなく、許可された結果を受け取ります。どちらのパターンも同じ API と同じレシートを使い、異なるのは分岐の決定者です。

開発

pnpm --filter @postcept/mcp build       # compile to dist/
pnpm --filter @postcept/mcp typecheck
POSTCEPT_API_KEY=pcpt_sk_... node dist/index.js   # stdio server