GRAFOMEM CGR Capture

grafomem-cgr

コーディングエージェントが自身の判断と、その結果を記録できるMCP サーバーです。 ご利用のGRAFOMEM Cloudテナントに記録します。

モデルは今記録し、後で評価する方式です。エージェントが誤る可能性のある判断を下すたびに、「このデプロイは安全」「このスキャンに問題はない」「このレビューでの指摘は妥当」といった判断を記録します。後に実際の結果が明らかになった時点で、その結果を記録します。両者は、ユーザーが指定するwork_item_idで結び付けられます。こうして、判断とその結果を、帰属先を明確にした追記専用の記録として蓄積します。

このパッケージが担うのは、記録の部分だけです。テナントに書き込みますが、スコアの計算、提供、表示は行いません。

cgr.cosign.v1検証ツール（オプション）

記録クライアントに加えて、このパッケージにはcgr.cosign.v1二者間連署エンベロープのリファレンス検証ツールも含まれています。grafomem_cgr.cosign_verify.verify(record, registry, ledger, trusted_issuers)は、docs/cgr/cgr-cosign-v1-spec.md §8（決定0010および0011による改訂）を実装しています。trusted_issuersは必須です（§8.2aの発行者ピン留め）。発行者のキー ID のコレクションを指定します。デフォルト値はなく、すべてを信頼する方法もありません。省略するか空のセットを渡すと、レコードが自己申告した発行者を信頼せず、拒否します。これは2つ目の独立したリファレンス実装です（1つ目はJS版の@gns-foundation/cgr-verifyです）。どちらも、conformance/cgr-cosign-v1/にある同じ28個のベクトル適合性コーパスに対し、判定の不一致ゼロで合格しています。追加機能を指定して依存関係をインストールしてください。

pip install grafomem-cgr[verify]      # rfc8785 + cryptography

記録機能はこの検証ツールに依存しません。追加機能は検証専用です。

対象外

• 記録時にスコアを算出せず、セッションにスコアを読み戻すこともありません。
• エージェントの安全性を高めたり、何かを制限したりするものではありません。ブロック、承認、阻止は行いません。
• コンプライアンス、監査、セキュリティ製品ではありません。
• GRAFOMEM Cloudのスコアリングは、現在、単一のディメンションで行われます。domainに関係なく、すべての判断／認定は1つのディメンションでスコアリングされます。指定したdomainは判断ごとに永続的に保存されるため（下記参照）、後から帰属先を確認できますが、現時点では個別にスコアリングされません。

要件

GRAFOMEM Cloudアカウントが必要です。無料プランで十分です。想定される利用量は1日あたり数件の判断です。管理対象の判断は、プラン上で実際の利用量として計上される点にご注意ください。サーバーの起動時に現在の利用量が表示されるため、予想外の請求は発生しません。

インストールと設定

コマンドを1つ実行し、環境変数を設定するだけです。リポジトリのチェックアウトや起動スクリプトは不要です。

Claude Code：

claude mcp add grafomem-cgr --scope user \
  --env GRAFOMEM_CGR_TENANT_KEY=sk_your_api_key \
  --env GRAFOMEM_CGR_TENANT=your_tenant_id \
  --env GRAFOMEM_CGR_ROLE_KEYS_JSON='{"cc-builder@acme":"<64-hex public key>"}' \
  -- uvx grafomem-cgr

または、JSON 設定を読み込む任意のMCPクライアント：

{
  "mcpServers": {
    "grafomem-cgr": {
      "command": "uvx",
      "args": ["grafomem-cgr"],
      "env": {
        "GRAFOMEM_CGR_TENANT_KEY": "sk_your_api_key",
        "GRAFOMEM_CGR_TENANT": "your_tenant_id",
        "GRAFOMEM_CGR_ROLE_KEYS_JSON": "{\"cc-builder@acme\":\"<64-hex public key>\"}"
      }
    }
  }
}

環境変数

変数	必須	意味
GRAFOMEM_CGR_TENANT_KEY	はい	テナントのX-API-Keyです。耐久性ガードにはdecisions:readが必要です。
GRAFOMEM_CGR_TENANT	はい	このキーの解決先として想定するテナント ID です。キーの解決先が異なる場合、すべての書き込みが拒否されます。
GRAFOMEM_CGR_ROLE_KEYS_JSON	いずれか一方	ロールハンドルから公開agent_keyへの対応付けを、JSON でインライン指定します。
GRAFOMEM_CGR_ROLE_KEYS	次の2つのうちいずれか	同じ対応付けを、JSON ファイルへのパスで指定します。
GRAFOMEM_CGR_FORBIDDEN_TENANTS	いいえ	誤ってピン留めされている場合でも、常に拒否するテナント ID をカンマ区切りで指定します。本番テナントをここに設定してください。
GRAFOMEM_API	いいえ	ベース URL です。デフォルトはhttps://api.grafomem.comです。

ロールキー

ロールハンドル（cc-builder@acme）は、判断の帰属先となる ID です。そのagent_keyは安定した**Ed25519公開鍵（64桁の16進数）**で、レコードが対象として結び付ける相手を表します。ロールごとに1つ生成してください。

openssl genpkey -algorithm Ed25519 -out cc-builder.pem
openssl pkey -in cc-builder.pem -pubout -outform DER | tail -c 32 | xxd -p -c 64

秘密鍵は保管してください。このバージョンでは使用せず、公開鍵のみに結び付けますが、判断ごとの所有証明は今後のセキュリティ強化として予定されています。秘密鍵を保持していれば、その ID が自分のものであることを証明できます。

ツール

cgr_record_decision — 判断を記録します。

arg
work_item_id	任意に選ぶ安定した結合キー（PR 番号、タスク ID、実行 ID）
agent_handle	設定済みのロールハンドルのいずれか
domain	deploy-verification | security-scan | adversarial-review
decision	certify | reject
verifiability_tag	judgment（デフォルト）| rule
reason_code, reason_text	任意
agent_confidence	任意。受け付けられますが、まだ保存されません — 以下を参照

agent_confidence は前方互換性のためにツールスキーマで受け付けられますが、現在、判断記録には書き込まれません。保存されることを前提にしないでください。

スコアを動かすのは judgment + certify のみです。rule による判断は決定論的で、評判への影響はありません — 正直にタグ付けしてください。

cgr_record_outcome — 結果を記録します。

arg
work_item_id	判断時に使用したものと同じ結合キー
result	結果ラベル。例：deploy_succeeded、ci_failed、vuln_found、review_confirmed
source	任意の来歴文字列

認識されない result は意図的に何もしません。 推測で解決するのではなく、判断は保留のままです — 判断を誤って解決すると、記録が恒久的に損なわれます。対応するラベルは次のとおりです。deploy_succeeded、deploy_healthy、ci_passed、migration_applied、merge_landed、pr_merged、scan_clean、no_vuln_confirmed、review_confirmed、finding_correct、bug_confirmed（成功）；deploy_failed、deploy_rolled_back、migration_failed、ci_failed、merge_reverted、vuln_found、secret_found、review_refuted、finding_wrong、bug_not_real（失敗）。

安全性の特性

• テナントの固定。 テナントを事前に指定します。この固定は起動時に適用され、各判断の応答で API が実際に解決したテナントと再照合されます — キーがローテーションされたり、誤って指定されたりしても、気付かないうちに別の場所へ書き込まれることはありません。
• 拒否リスト。 GRAFOMEM_CGR_FORBIDDEN_TENANTS に指定したテナントは明示的に拒否されます。
• キーの管理。 呼び出し元はロールのハンドルを選び、サーバーがそのロールのキーを挿入します。ツール呼び出しで任意のキーを指定したり、別のテナントを対象にしたりすることはできません。
• フェイルオープン。 サーバーの設定に誤りがある場合、サーバーはゼロ以外の終了コードで終了し、読み込まれません。セッションはブロックされずに続行され、ツールは登録されません。拒否されたツール呼び出しは、MCP サーバーをクラッシュさせるのではなく、通常のツール出力としてエラーを返します。
• ドメインの永続性。 domain は専用フィールドとして送信され、各判断についてサーバー側で、暗号化されず CGr から読み取り可能な判断 parameters 内の cgr_domain として保存されます — クライアント側のログではなく、署名済みの判断記録に保存されます。selftest には永続性ガードが含まれており、書き込んだ判断を再読み込みし、cgr_domain が往復していなければ、ドメインのない判断を黙って記録するのではなく、明確なエラーを出して中断します。

CLI

grafomem-cgr                 # run the stdio MCP server (the default)
grafomem-cgr setup           # register your role identities on the tenant (idempotent)
grafomem-cgr selftest --handle cc-builder@acme --domain deploy-verification

selftest は、判断 → 永続性ガード → 結果 → スコア読み取りの一連の流れを一度実行し、変化とメーターを表示します。サーバーをセッションに組み込む前に実行してください。

リンク

• grafomem.com · docs.grafomem.com
• ソース · 問題

MIT ライセンスです。