Gridzen Verification

Gridzen Developer Kit 0.6.1

ホスト型の開発者向けインターフェースは、英語、スペイン語、簡体字中国語に加えてベトナム語にも対応しています：https://gridzen.ai/developers/?lang=vi 。UI の言語を切り替えても、ライブチェックや対象国が有効になるわけではありません。UI 言語のメンテナンスを参照してください。

タスクに適した直接連携または GridZen を選択 · 本番環境とコストのチェックリスト

サインアップなしですぐに開始

GridZen のインスタントトライアルを開くと、アカウント、API キー、承認なしで、合成されたサインアップ時の電話番号確認と本人確認オンボーディングの応答を実行できます。成功、拒否、利用不可の各シナリオでは、上流への呼び出しは行われず、実在する人物の確認も行われません。エージェントは、仮想環境に mcp==2.3.0 と httpx==0.28.1 をインストールして、別途用意されたキー不要のトライアル MCPを利用できます。

テスト記録を保持し、サプライヤーのサンドボックスからのコールバックを受け取るには、確認済みの加盟店サンドボックスアカウントを接続してください。本番環境へのアクセスは機能ごとに異なります。条件を満たすルートでは範囲を限定した実環境トライアルを利用できる場合がありますが、利用できないままのルートもあります。認証済みの機能条件を確認してください。公開価格を確認しても、有料購入が有効になるわけではありません。このドキュメントの更新によって、PyPI または公式 MCP Registry のバージョンが変更されることはありません。

198 の国・地域に関する調査、本人確認連携プランナー、5 種類の合成結果、HTTP SDK、ローカル MCP サーバー、6 つの Skills を収録しています。**ライブプロバイダーは有効になっていません。実在する人物の本人確認は行われません。**調査スナップショットの日付は2026-10-07です。出典リンクとファイルハッシュも記載しています。

中文指南 · Guía en español

実行可能なタスクガイドと配布物

顧客のタスク	ガイド	実行可能なコード
初回の本人確認オンボーディング	ガイド	配信フィクスチャ
登録時の電話番号確認の範囲	ガイド	4 分岐の例
コールバックの欠落または遅延	ガイド	復旧フィクスチャ
本人確認から事業許可まで	ガイド	セルフホスト可能な n8n フィクスチャ

中国語とスペイン語の記事ファイル · デモ動画 · Smithery の掲載ページ。

公開サンプルは合成データです。承認済みの価格と製品ごとの利用可否は https://gridzen.ai/pricing/ に掲載されています。ライブ決済は引き続き無効です。公開 MCP ツールに本人確認書類や認証情報を送信せずに、承認済みのパイロットをリクエストしてください。

チェック単位のプランと有効化要件 · JSON

試す

公開プレイグラウンド：https://gridzen.ai/developers/

gridzen-developer-kit.zip をダウンロードして展開し、次の手順を実行します。

python3 -m venv .venv
. .venv/bin/activate
python -m pip install './gridzen-developer-kit[mcp]'
gridzen coverage --country ID --capability bank_account_match
gridzen plan --country ID --event payout
gridzen simulate --country ID --capability bank_account_match --scenario timeout
python gridzen-developer-kit/examples/payout.py

Python 3.11 以降。CLI と MCP は同梱のオフラインカタログとフィクスチャを使用します。Python HTTP クライアントとサンプルは公開サンドボックスを呼び出します。依存関係はインストール時にのみダウンロードされます。API リファレンス：https://gridzen.ai/developers/api/openapi.json 。

MCP

MCP クライアントにローカルの stdio サーバーを登録します。インストール済みの実行ファイルの絶対パスを使用してください。設定構文はクライアントによって異なります。一般的な mcpServers 設定は次のとおりです。

{"mcpServers":{"gridzen":{"command":"/absolute/path/to/.venv/bin/gridzen-mcp","args":[]}}}

ツール：get_coverage、plan_verification、create_sandbox_verification、get_sandbox_verification、explain_result。いずれもローカルの調査データまたは合成フィクスチャのみを対象とし、読み取り専用／冪等の注釈が付いています。公開調査／サンドボックス用 MCP エンドポイント：https://gridzen.ai/developers/mcp（Streamable HTTP、アカウントや API キーは不要）。同じ 5 つのツールを備え、ライブプロバイダーはありません。リモートでの使用では、ドキュメントに記載された引数が Gridzen に送信されます。ローカル stdio はデフォルトでオフラインです。制限：クライアントアドレスあたり毎分 120 件、全体で毎分 600 件のリクエスト。超過した場合は Retry-After を含む HTTP 429 が返されます。

Skills

skills/ から各ディレクトリを、互換性のあるエージェントのプロジェクトまたはユーザーのスキルディレクトリにコピーします。各エントリーポイントは SKILL.md です。references/ ディレクトリも必ず保持してください。マーケットプレイスへの掲載や自動登録を意味するものではありません。

HTTP SDK

from gridzen_developer.client import Gridzen
client = Gridzen()
plan = client.plan('ID', 'payout')
result = client.simulate('ID', 'bank_account_match', 'not_found')
assert result['status'] == 'inconclusive'
assert result['verified'] is False

ドキュメントに記載された国／イベント／機能／シナリオのフィールドのみ受け付けます。サンドボックスに本人確認番号、銀行口座、書類、認証情報を送信しないでください。シミュレーション ID はフィクスチャを示すものであり、一意なトランザクション識別子ではありません。合成マッチングによって実在するユーザーや支払いを承認することはできません。調査結果は、Gridzen の提供状況や商用利用の許可とは別のものです。

リポジトリのチェックアウト：ローカルサービスとチェック

python -m pip install '.[test,server]'
python -m pytest -q
python scripts/check_mcp.py
uvicorn gridzen_developer.server:app --host 127.0.0.1 --port 8030

本番環境では、localhost:8030 で独立したコンテナを使用し、/developers/ の配下でのみプロキシします。deploy/compose.yml と deploy/developers.conf を参照してください。このプロキシファイルを削除してコンテナを停止すれば、プレビューをロールバックできます。既存の API および Agent Company のスタックは別個のものです。

リポジトリのチェックアウト：配布物のビルド

python scripts/build_downloads.py は、許可リストに基づいて開発キットと Skills の ZIP を作成します。再帰的なダウンロード用パッケージから、テスト、デプロイ用ファイル、非公開の認証情報、およびこのスクリプト自体を除外します。python scripts/build_catalog.py <repo>/docs/research/identity-verification/2026-10-07 は、公開用の調査データを更新します。メインリポジトリのレポートファイルが引き続き出典となります。

公開配布

ソース：https://github.com/immurray/gridzen-developer-kit 。Skills をインストールします：

npx skills add immurray/gridzen-developer-kit

GitHub からタグ付けされた Python/MCP リリースをインストールします（Python 3.11 以降と Git が必要です）：

python -m pip install "gridzen-developer-kit[mcp] @ git+https://github.com/immurray/[email protected]"

PyPI 0.6.0 は公開済みで、検証済みです。python -m pip install gridzen-developer-kit でインストールします。公開およびインストールの証拠については、リリーストラッカーを参照してください。

リモートクライアントの設定（一般的な JSON。クライアントの構文は異なる場合があります）：

{"mcpServers":{"gridzen":{"type":"http","url":"https://gridzen.ai/developers/mcp"}}}

Claude Code の場合：claude mcp add --transport http gridzen https://gridzen.ai/developers/mcp。 Cursor の場合：MCP 設定にリモート URL を追加します。ポータブルな Agent Plugins には、同梱の plugin.json と mcp.json を使用します。ポータブルなトランスポート識別子は streamable-http です。マーケットプレイスへの登録審査は、互換性とは別個のものです。

オリジナルのコードと Skills：MIT。調査の出典および第三者の権利については、NOTICE.mdを参照してください。サポート：[email protected] 。

マーケットプレイスでの提供状況

ソース、リリースのダウンロード、公式 MCP Registry のエントリー、および 6 つの Skills.sh ページは公開されています。Docker カタログへの申請は審査待ちです。正確な状況と残っているプラットフォームごとの手順については、公開状況一覧を参照してください。

6 つのバンドル済みスキル（0.6.0）

python -m pip install gridzen-developer-kit を実行すると、CLI、stdio MCP の依存関係、および 6 つすべてのスキルディレクトリがインストールされます。バージョン 0.6.0 は PyPI で公開されています。クリーンインストール、CLI、stdio MCP、および 6 つのバンドル済みスキルディレクトリすべての動作を確認済みです。MCP の追加依存関係をインストールする必要はありません。

gridzen coverage --country MX
gridzen skills
gridzen-mcp

gridzen-mcp をクライアントの stdio サーバーとして接続するか、リモートエンドポイント https://gridzen.ai/developers/mcp を使用してください。gridzen skills を実行すると、インストール済みのディレクトリが表示されます。スキルを有効にするには、ディレクトリを丸ごとコピーして、アシスタントに設定されているスキルディレクトリに配置してください。wheel をインストールしても、クライアントのスキルが自動的に有効になることはありません。

既存の select/integrate/explain スキルも引き続き利用できます。バージョン 1.0.0 で、以下のオフラインワークフローを追加しました：mexico-pilot-scoper、payout-policy-designer、provider-rights-readiness。それぞれに MIT、README、完全なレスポンスフィクスチャ、エージェント受け入れプロンプトが含まれています。これらはサードパーティへの呼び出しを行わず、実際の検証、法的承認、規制上の結論を与えるものではありません。

アシスタントの設定（v0.6.0）

python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade gridzen-developer-kit
gridzen setup --client all --project .
gridzen setup --client all --project . --apply

--client を使用すると、Codex、Claude Code/Desktop、Cursor、VS Code/Copilot、Copilot CLI、Gemini CLI、Cline、Roo Code、OpenCode を設定できます。セットアップではデフォルトでプレビューが表示され、既存の無関係な設定は保持されます。変更する設定はバックアップされ、Gridzen の設定やスキルファイルに相違がある場合は処理を中止します。クライアントのグローバル設定は変更されません。ネイティブクライアントではワークスペースの信頼が必要です。Desktop と Cline では MCP を手動でインポートする必要があります。Desktop では個別にアップロードできる ZIP が 6 つ生成されます。クライアント別の手順と実際の互換性を示すエビデンスを参照してください。設定の準備は、モデルの受け入れや実際の検証を意味するものではありません。

ホスト型 MCP の集計帰属情報

ホスト型の呼び出しでは、顧客数ではなく、成功したツール呼び出しを集計します。既存の合計は変更されません。ホスト型サービスでは、UTC の日付、ツール名、1 つのソースカテゴリ、件数を記録します。リクエスト引数やクライアントアドレスは保存しません。過去の呼び出しとラベルのない呼び出しは引き続き unknown として扱われます。ローカルの stdio はデフォルトでオフラインです。

ループバックで公開されたサービスへの明示的な受け入れテストのリクエストには、X-Gridzen-Purpose: internal_test を設定できます。転送されたクライアントヘッダーがなく、設定されたローカルピアからのリクエストのみが internal_test に分類されます。パブリックリバースプロキシでは、X-Real-IP を上書きする必要があります。公開リクエストで指定されたラベルは self_reported_test としてのみ扱われます。ラベルのない公開リクエストは、認証済みの外部顧客からのものではありません。GRIDZEN_MCP_LOCAL_TEST_PEERS のデプロイ設定は、コンテナゲートウェイと一致させる必要があり、公開クライアントのアドレスを含めてはなりません。ソース別件数には、既存の 90 日間の保持期間とフェイルオープン動作が適用されます。このホスト型の変更によって、新しい PyPI バージョンが公開されたり、実稼働のプロバイダーが有効になったりすることはありません。

顧客タスクと任意のフィードバック（0.6.0）

gridzen plan --country US --event onboarding --task signup_phone
gridzen plan --country US --event onboarding --task identity_onboarding
gridzen plan --country US --event onboarding --task identity_onboarding --stage production
python examples/customer_tasks.py
gridzen feedback --task signup_phone --country US --outcome blocked --blocker missing_workflow_step --output task-summary.json
# Only after choosing to share:
gridzen feedback --input task-summary.json --share

電話番号インテリジェンスは、OTP や所有者の検証ではありません。本人確認フィクスチャは、ホスト型の書類確認やライブネスセッションではありません。ペイアウト照合は、実際に有効なルートのないプロトタイプのままです。プロバイダー向けインテークスキルは、プロバイダー運用や BYO 用であり、すべての顧客に必須の手続きではありません。

リモート API では、技術的な失敗も含め、固定されたタスク／機能／国／ステージ／エラーカテゴリを 90 日間集計します。引数、本人確認データ、認証情報、生のチャット内容、ユーザー単位の追跡情報は保存しません。ローカルのフィードバックはデフォルトで無効です。明示的にオプトインすると、CLI と stdio MCP はカテゴリのみのイベントを自動的にアップロードします。静的スキルの閲覧は観測されません。任意のフィードバックには明示的な同意が必要で、固定カテゴリのみが含まれ、未検証の自己申告エビデンスとして扱われます。ランダムなレシート ID の SHA-256 ハッシュは、30 日間の再試行重複排除のために 30 日間保持されます。ID 自体は保存されません。カウンターはデータベースごとに、1 日あたり 10,000 件のリクエスト、500 件のサマリーに制限されます。履歴がない場合やオフラインでの利用状況は不明です。リクエスト数は、ユニークな顧客数ではありません。

オプションのローカル自動フィードバック（0.6.0）

gridzen telemetry status
# Run only after reading and agreeing to category-only automatic sharing:
gridzen telemetry enable --consent
gridzen plan --country US --event onboarding --task signup_phone
# Send one queued event per invocation after reconnecting:
gridzen telemetry flush
# Disable future uploads and clear the pending queue:
gridzen telemetry disable

無効にしている場合、ローカル CLI／MCP からネットワークへの呼び出しは発生しません。同意は OS ユーザーごとに保存され、プロジェクトに黙って追加されることはありません。イベントに含まれるのは、文書化されたカテゴリ、ISO 国コード、イベントごとにランダムに生成されるレシートのみで、会話、個人識別情報、認証情報、ユーザー ID、プロジェクト ID は含まれません。フィードバックに失敗しても、ツールの実行には影響しません。ローカルキューは最大 1,000 件／30 日分に制限されます。再接続時、または flush の実行時に、キューにあるイベントを 1 件ずつ、HTTP タイムアウト 1 秒で再試行します。アップロードされるのは自己申告による利用状況であり、認証済みの顧客情報や、検証の完了を示すものではありません。バックグラウンドデーモンはインストールされません。Skill を読むだけでは観測されません。同意後、エージェントが固定カテゴリのタスク概要を明示的に記録できます。

キューに保存されたローカルイベントは 30 日後に期限切れとなり、次回の登録または flush 時に削除されます。日次集計ではサーバーの受信日を使用します。遅れてアップロードされたデータは、その日に作業が行われたことの証明にはなりません。

オーナー承認制の別個の顧客向けパイロット

公開中の 0.6.0 キットと 5 つの公開ツールは、引き続きリサーチ／合成データ用ツールです。基本的なサインアップ電話番号の有効性確認と、ホスト型の個人向け本人確認オンボーディングを提供する別個のホスト型パイロットでは、顧客からの申し込みを受け付けています：申し込み、統合ガイド、公開されている対象範囲。

申し込みを送信しても、本番環境が有効になることはありません。オーナーによるサプライヤーの権利、下流の契約、機能、リクエスト上限、有効期限の承認が必要です。使用するのは、無償利用枠が確認された場合に限られます。本番パイロットには、専用のダウンロード可能な MCP クライアントと加盟店 API キーがあります。公開リサーチ用 MCP に書類、顔画像、プロバイダーのキーを送信しないでください。基本的な電話番号の有効性確認では、OTP や所有権は確認できません。

実際の基本的な電話番号チェックと、過去の「承認済み」オペレーター本人確認セッションの取得は、稼働中の顧客 API／MCP を通じて検証済みです。新しいセッションでの本人による完了と、それに伴う実際の最終 Webhook は、まだ検証されていません。オペレーターによるテスト、ダウンロード、自己申告による関心は、顧客の需要を示すものではありません。このドキュメントの更新によって、PyPI パッケージや Registry のバージョンが変更されることはありません。

匿名トライアル、無料のサンドボックスアカウント、統合アシスタントを見つけるには、gridzen start --task identity_onboarding --lang en を使用してください。gridzen start はネットワークへの呼び出しを行いません。アカウントの進捗測定は、コンソールで個別に任意の同意を求めます。サンドボックスを完了しても、実在の人物の本人確認にはなりません。実際の支払いは引き続き無効です。

顧客タスクを完了する

• 本人確認オンボーディング：3 つの結果と申し込みに関する判断
• 電話番号チェック：有効性、所有権、確認不可の結果
• 遅延したコールバックから復旧する
• 検証を販売者の権限に紐付ける
• 実行可能な SQLite 配信例
• インポート可能な n8n フィクスチャワークフロー

これらは合成データを使った統合例です。実際の本人確認、本番環境での Webhook 配信、顧客による採用、支払いを証明するものではありません。匿名の応答トライアルやローカルの例を利用するのに、アカウントは必要ありません。

既存の 6 つのスキルをプロジェクトにインストールします。

npx skills add immurray/gridzen-developer-kit --skill '*' --agent codex --copy -y

codex の代わりに、サポート対象のエージェントを選択してください。インストール互換性があるからといって、すべてのエージェントがこれらのスキルを実行または推奨したことを示すわけではありません。

既存のメキシコ SPEI 支払い証跡

更新済みの GitHub チェックアウトまたは開発者向け ZIP で（既存の PyPI リリースにはまだこのタスクが含まれていません）、gridzen plan --country MX --event payout --task mx_cep_existing_payment --stage production を使って、個別の認証済み CEP 試行を確認してください。公開ツールは引き続き調査／合成データ専用です。ライブ機能の利用条件 ではマーチャントキーが必要です。取引の詳細やキーを公開ツールに送信しないでください。オフラインで実行可能な例 はネットワーク接続を行いません。CEP は元の XML、独立した署名、想定される取引との厳密な照合を保持します。過去の名称は、現在の本人確認や口座管理権限を証明するものではありません。送金は作成されず、有料チェックアウトは引き続き無効です。

メキシコの本人確認と受取人名の照合

タスク、料金の境界、費用ゼロの統合例 では、初回の口座紐付け、口座変更、例外の確認について説明しています。14 MXN の見積もりでは本番環境での呼び出しは有効になりません。認証済みの機能応答を確認してください。公開 MCP と Skills は引き続き調査／合成データ専用です。

サインアップせずに、本人確認／口座照合結果の例をオフラインで実行します。