Gridzen Verification

Gridzen Developer Kit 0.6.1

托管开发者界面支持越南语，以及英语、西班牙语和简体中文：https://gridzen.ai/developers/?lang=vi 。界面语言不会启用实时检查或扩大国家/地区覆盖范围。请参阅 界面语言维护。

为你的任务选择直接集成或 GridZen · 生产与成本清单

无需注册，立即开始

打开 GridZen 即时试用，无需账户、API 密钥或审批，即可运行模拟注册手机号和身份验证入门响应。成功、拒绝和不可用场景不会调用上游，也不会验证真实人员。Agent 可以使用独立的免密钥试用 MCP，在虚拟环境中安装 mcp==2.3.0 和 httpx==0.28.1 即可使用。

如需保存测试记录并接收供应商沙盒回调，请连接经过验证的商户沙盒账户。生产访问权限因能力而异：符合条件的路由可能提供有限的真实试用，其他路由则仍不可用。请阅读经过身份验证的能力条件；已公布的价格不会启用付费购买。本次文档更新不会更改 PyPI 或官方 MCP Registry 的版本。

涵盖 198 个国家/地区的研究、验证集成规划器、五种模拟结果、HTTP SDK、本地 MCP 服务和六个 Skills。**未启用任何实时服务商。不会验证任何真实人员。**研究快照日期为 2026-10-07，附有来源链接和文件哈希。

中文指南 · 西班牙语指南

可运行的任务指南与分发

客户任务	指南	可运行代码
首次身份验证入门	指南	交付夹具
注册手机号边界	指南	四分支示例
缺失或延迟的回调	指南	恢复夹具
从验证到业务权限	指南	可自托管的 n8n 夹具

中文和西班牙语文章文件 · 演示视频 · Smithery 列表。

公开示例均为模拟内容。已批准的价格和各产品可用情况发布于 https://gridzen.ai/pricing/；实时付款仍处于禁用状态。[申请已批准的试点](https://gridzen.ai/console/pilot)，请勿向公开 MCP 工具发送身份文件或凭据。

按次检查计划和启用要求 · JSON

试用

公开 Playground：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 密钥）。该端点提供相同的五种工具，且不连接任何实时提供方。远程使用会将文档中说明的参数发送至 Gridzen；本地 stdio 默认离线运行。限制：每个客户端地址每分钟 120 个请求，全局每分钟 600 个请求；超出限制时会返回 HTTP 429 和 Retry-After。

Skills

将 skills/ 中的各个目录复制到兼容的 Agent 项目或用户技能目录中。每个入口文件均为 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 插件， 请使用打包的 plugin.json 和 mcp.json；可移植传输标识符 为 streamable-http。是否获准进入市场与是否兼容是两回事。

原始代码和 Skills：MIT。研究来源溯源和第三方权利： NOTICE.md。支持邮箱：[email protected] 。

市场上架情况

源代码、发行版下载、官方 MCP Registry 条目和六个 Skills.sh 页面均已公开。Docker 目录提交正在等待审核。准确状态和平台待办事项请参阅发布记录。

六个内置 Skill（0.6.0）

python -m pip install gridzen-developer-kit 会安装 CLI、stdio MCP 依赖项和全部六个 Skill 目录。0.6.0 版本已发布到 PyPI；已验证全新安装、 CLI、stdio MCP 和全部六个内置 Skill 目录。无需额外安装 MCP 依赖项。

gridzen coverage --country MX
gridzen skills
gridzen-mcp

将 gridzen-mcp 连接为客户端的 stdio 服务，或使用远程端点 https://gridzen.ai/developers/mcp。gridzen skills 会列出已安装的目录； 将完整目录复制到助手配置的 Skills 目录即可激活。安装 wheel 不会自动激活客户端的 Skills。

现有的 select/integrate/explain Skills 仍可使用。新增离线工作流，版本为 1.0.0：mexico-pilot-scoper、payout-policy-designer 和 provider-rights-readiness。每个 Skill 都包含 MIT、README、完整的响应样例和 Agent 验收提示词。它们不会调用第三方服务，也不代表已获得实际验证、法律批准或监管结论。

配置助手（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 条目或 Skill 文件。不会修改任何客户端的全局设置。原生客户端需要工作区信任；Desktop 和 Cline 需要手动导入 MCP。Desktop 会生成六个可单独上传的 ZIP 文件。参见针对各客户端的说明和实际兼容性证据。准备配置不等于模型验收或实际验证。

托管 MCP 汇总归因

托管调用按成功的工具调用次数计数，而非按客户计数。现有总数保持不变。托管服务会记录 UTC 日期、工具名称、一个来源类别和计数；绝不持久化请求参数或客户端地址。历史调用和未标注的调用仍归类为 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 或所有权验证。身份样例不等于托管的文档/活体检测会话。付款匹配仍是原型，不存在已启用的实际渠道。服务提供商接入 Skill 适用于服务提供商运营/BYO，并非通用的客户门槛。

远程 API 会将固定的任务/能力/国家/阶段/错误类别计数并保留 90 天，其中包括技术故障。它们不会存储参数、身份数据、凭据、原始聊天内容或逐用户跟踪信息。本地反馈默认关闭。明确选择加入后，CLI 和 stdio MCP 会自动上传仅含类别的事件。读取静态 Skills 不会留下可观测记录。可选反馈需要明确同意，仅包含固定类别，且属于未经验证的自我报告证据。系统会保留随机回执 ID 的 SHA-256 哈希 30 天，用于 30 天重试去重；不会存储 ID 本身。每个数据库的计数器上限为每天 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 不会发起网络请求。用户同意状态按操作系统用户保存，不会悄悄添加到项目中。事件仅包含已记录的类别、ISO 国家/地区代码和每个事件随机生成的回执，不包含对话、身份字段、凭据、用户 ID 或项目 ID。反馈失败不会导致工具执行失败。本地队列最多保存 1,000 个事件，保留 30 天；重新连接或执行 flush 时会重试一个排队事件，HTTP 超时时间为 1 秒。上传内容是自我报告的使用情况，并非经过身份验证的客户或已完成的验证。不会安装后台守护进程。单纯阅读 Skill 不会留下可观测记录；用户同意后，Agent 可以明确记录固定类别的任务摘要。

本地排队事件在 30 天后过期，并会在下次入队或执行 flush 时移除。每日汇总按服务器收到事件的日期统计；延迟上传不能证明工作是在该日期完成的。

单独的所有者批准客户试点

已发布的 0.6.0 套件及其五个公开工具仍是研究/合成工具。另有一个托管试点，接受客户申请，用于基本注册手机号有效性检查和托管式个人身份登记：申请、集成指南、公开范围。

提交申请不会激活生产服务。所有者必须批准供应商权限、下游协议、能力、请求限额和到期时间；仅使用已确认的免费额度。生产试点使用单独下载的 MCP 客户端和商户 API 密钥。请勿向公开研究 MCP 发送证件、人脸或提供商密钥。基本手机号有效性检查不提供 OTP 或所有权验证。

已通过实时客户 API/MCP 验证真实的基本手机号检查，以及检索历史上已批准的运营方身份会话。新会话的人为完成流程及其最终真实 Webhook 尚未验证。运营方测试、下载和自我报告的兴趣都不代表客户需求。此文档更新不会更改 PyPI 包或 Registry 版本。

使用 gridzen start --task identity_onboarding --lang en 查找匿名试用、免费沙盒账户和集成助手。gridzen start 不会发起网络请求。账户进度测量需要单独选择是否同意，且此项为可选；完成沙盒流程并不能验证真实人员。真实付款仍处于禁用状态。

完成客户任务

• 身份登记：三种结果和申请决定
• 手机号检查：有效性、所有权和不可用结果
• 恢复延迟的回调
• 将验证绑定到卖家权限
• 可运行的 SQLite 交付示例
• 可导入的 n8n 示例工作流

这些是合成的集成示例。它们不能证明真实身份、生产环境中的 Webhook 交付、客户采用情况或付款。匿名响应试用和本地示例均无需账户。

将现有的六个技能安装到项目中：

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

请选择受支持的 Agent，而不要使用 codex。安装兼容性并不能证明所有 Agent 都已执行或推荐这些技能。

现有墨西哥 SPEI 付款凭证

在更新后的 GitHub checkout 或开发者 ZIP 中（现有 PyPI 版本尚未包含此任务），使用 gridzen plan --country MX --event payout --task mx_cep_existing_payment --stage production 发现独立的 CEP 身份验证试用版。公共工具仍仅用于研究／合成数据。实时能力条件 要求商户密钥；请勿向公共工具发送交易详情或密钥。可运行的离线示例 不会发起网络调用。CEP 保留原始 XML、独立签名以及与预期交易的精确绑定；历史名称不能证明当前身份或账户控制权。不会创建转账；付费结账仍处于禁用状态。

墨西哥身份与受益人姓名比对

任务、定价边界和零成本集成示例 涵盖首次账户绑定、账户变更和异常审核。14 MXN 的报价不会启用生产调用；请查看经过身份验证的能力响应。公共 MCP 和 Skills 仍仅用于研究／合成数据。

离线运行身份／账户结果示例，无需注册。