Postcept

Name: Postcept
Author: Postcept

本地服务

github.com/PostceptAI 与智能体114 周前更新

代码仓库

关于 Postcept

Postcept 是面向 Agent 和团队的 MCP 服务，用于核实高风险操作是否真正完成。它对照系统记录检查结果并返回签名回执，而非仅依赖 Agent 的完成声明。

主要功能

01核实退款、取消订阅和工单状态
02查询并重新核验历史结果
03查看 Verified Completion Rate
04通过确定性测试连接器运行检查
05返回签名完成回执

适用场景

01报告退款完成前先进行核实
02对照记录检查订阅是否已取消
03确认支持工单达到预期状态
04根据实时记录重新核验先前结果

MCP 相关

该服务将 Postcept 的结果核验 API 暴露为 MCP 工具。核验以只读方式查询系统记录；Agent 可自行决定是否调用，因此该集成仅提供建议性验证。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @postcept/mcp

需要配置的环境变量

POSTCEPT_API_KEY密钥Postcept API key

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@postcept/mcp0.3.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
test	boolean	否	沙盒模式：使用确定性模拟连接器而非实时权威数据系统进行验证。沙盒验证不计入您的已验证完成率。
agent_id	string	是	执行操作的 Agent 的标识符。
currency	string	否	ISO 4217 币种代码，例如 usd。
customer	string	是	退款所属客户的 ID 或电子邮箱。
charge_id	string	否	退款适用的扣款，例如 ch_1P09x。
connector	enum	否	要检查的支付记录系统。默认为 stripe。stripe \| zendesk \| gorgias \| intercom \| shopify \| hubspot \| front \| servicenow \| salesforce \| netsuite
refund_id	string	否	Agent 创建的退款 ID，例如 re_4md82k。
amount_cents	integer	是	以最小货币单位（美分）表示的退款金额，例如 $120.00 对应 12000。
operation_id	string	是	Agent 操作的稳定 ID，在重试和交接期间保持不变。
idempotency_key	string	否	可选的 Postcept 幂等键：使用相同键重复调用时，将返回原验证结果，而不会创建重复项。

详细介绍

@postcept/mcp

一个 Model Context Protocol 服务，可将 Postcept——面向 AI Agent 的结果验证服务，作为 MCP 工具提供。

Agent 执行高风险操作（退款、取消订阅、解决支持工单）后，会调用 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 keys 下创建 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，以便使用确定性沙盒连接器运行测试（不会计入你的已验证完成率）。这样，Agent 无需连接实时记录系统，也能完整体验整个流程。

非 verified 的结果（incomplete、duplicated、mismatched、policy_failed）表示工作尚未完成。指出缺口并进行补救。

设计上采用建议性机制

MCP 将验证调用交由 Agent 执行，因此它适用于开发、演示，以及已信任 Agent 判断的工作流。这种机制仅提供建议：Agent 可以跳过调用、传入错误标识符，或忽略结果。

对于影响重大的操作，应在 Agent 之外强制执行决策。工作流或编排器自行调用 Postcept API（或 SDK 的 guard()），并在任何面向客户的操作发生前，根据 safe_to_claim_complete 进行分支处理。随后，Agent 接收已获准的结果，而不是自行决策。这两种模式使用相同的 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

支持 Markdown

登录后评论