StableOps Agent Payments MCP 服务器

中文文档

一个基于 stdio 的 Model Context Protocol (MCP) 服务器，允许代理配置和运行 StableOps Agent Payments，同时私钥、助记词、KMS 凭据和审批权限仍由用户掌控。

安装与运行

需要 Node.js 20 或更高版本。

设置期间仅提供管理密钥：

STABLEOPS_API_KEY=sk_sandbox_... \
STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true \
STABLEOPS_AGENT_KEY_OUTPUT_FILE=/protected/absolute/path/stableops-agent-key \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

管理模式默认为只读。仅当设置了 STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true 时才会注册变更类工具；管理进程绝不暴露开放世界的发现或支付执行功能。一次性 Agent Key 密钥绝不会返回给模型。服务器在签发前保留 0600 目标权限，如果存储失败，会自动撤销新签发的密钥。

钱包配对工具仅返回用户必须签名的确切消息。没有任何工具接受私钥、助记词或 KMS 凭据。用户在自己的钱包中签名，仅返回签名。

日常运行时使用，请移除管理密钥，并使用受限的 Agent Key 加上用户操作的签名者 sidecar：

STABLEOPS_AGENT_KEY=ak_sandbox_... \
STABLEOPS_SIDECAR_URL=http://127.0.0.1:8789 \
STABLEOPS_SIDECAR_TOKEN=... \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

管理模式和运行时模式互斥。当同时设置 STABLEOPS_API_KEY 和 STABLEOPS_AGENT_KEY 时，服务器拒绝启动。运行时模式仅暴露发现、预算、预览、受控购买和支付对账工具；它无法更改策略或批准自己的支付。

Related MCP server: BotWallet MCP Server

安全模型

• 服务器绝不接受或存储钱包私钥、助记词或 KMS 凭据。

• 用户必须在服务器之外签署钱包所有权证明。

• 运行时支付只能调用用户操作的受限签名者 sidecar，绝不能调用任意签名端点。

• 未知来源、未知收款方以及超阈值支付需要在 StableOps 中进行人工审批。

• 每次新购买都需要稳定的 idempotency_key；不确定的结算必须与原始意图进行对账。

• 每次购买都必须使用绑定到确切 URL、最高报价和审计上下文的 preview_token；购买工具不接受替换 URL。

• 预览令牌是进程本地的。MCP 重启后，请重新预览原始确切 URL，并使用新令牌继续；API 会验证存储在意图上的完整 URL 哈希。

• 超过 256 KiB 的响应可作为短期 MCP 资源使用；所有内联摘要均标记为不可信的外部内容。

文档

查看完整指南：https://stableops.dev/en/docs/agent-payments/quickstart

许可证

Apache-2.0