Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Surface contracts: API behavior evidence, x402 pre-payment check, MCP server preflight
选择你使用的 AI 应用,然后复制设置。
通过 1/3 项检查 · 你的提问会经过开发者的服务器(penny-surface-contract.penny-mcamp.workers.dev) · ✓ 命令已检查 2026年11月13日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 2 分钟
不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
CustomizeConnectors
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
Surface Contract: platform API behavior and x402 pre-payment checkshttps://penny-surface-contract.penny-mcamp.workers.dev/mcp在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add
+ConnectorsSurface Contract: platform API behavior and x402 pre-payment checks
用 Surface Contract: platform API behavior and x402 pre-payment checks 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Surface Contract: platform API behavior and x402 pre-payment checks,或回答中出现 Surface Contract: platform API behavior and x402 pre-payment checks 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
能否连接 ChatGPT 取决于方案
完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页
Plugins+Add custom MCP server
输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin
Surface Contract: platform API behavior and x402 pre-payment checkshttps://penny-surface-contract.penny-mcamp.workers.dev/mcp开启新聊天,输入前先从插件列表中选择 Surface Contract: platform API behavior and x402 pre-payment checks
用 Surface Contract: platform API behavior and x402 pre-payment checks 告诉我你能帮我做什么,然后做一件给我看✓ 如果 ChatGPT 说正在使用 Surface Contract: platform API behavior and x402 pre-payment checks,或回答中出现 Surface Contract: platform API behavior and x402 pre-payment checks 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Claude Code · 约 2 分钟
不需要密钥,不用安装程序
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
claude mcp add --transport http --scope user surface-contract https://penny-surface-contract.penny-mcamp.workers.dev/mcp应能看到 Surface Contract: platform API behavior and x402 pre-payment checks 在列表中并显示已连接
用 Surface Contract: platform API behavior and x402 pre-payment checks 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Surface Contract: platform API behavior and x402 pre-payment checks,或回答中出现 Surface Contract: platform API behavior and x402 pre-payment checks 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 2 分钟
不需要密钥,不用安装程序
用 Surface Contract: platform API behavior and x402 pre-payment checks 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Surface Contract: platform API behavior and x402 pre-payment checks,或回答中出现 Surface Contract: platform API behavior and x402 pre-payment checks 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 2 分钟
不需要密钥,不用安装程序
用 Surface Contract: platform API behavior and x402 pre-payment checks 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Surface Contract: platform API behavior and x402 pre-payment checks,或回答中出现 Surface Contract: platform API behavior and x402 pre-payment checks 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看
通过网页连接的应用使用的地址
https://penny-surface-contract.penny-mcamp.workers.dev/mcpJSON 设置在下方“开发者专用”中
Claude Code
claude mcp add --transport http --scope user surface-contract https://penny-surface-contract.penny-mcamp.workers.dev/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"surface-contract": {
"url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"surface-contract": {
"type": "http",
"url": "https://penny-surface-contract.penny-mcamp.workers.dev/mcp"
}
}
}这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
工具名称和描述与服务器在 2026年11月12日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
list_surface_contractsList the platform surface contracts published in Penny's free registry, with claim counts.
get_surface_contractGet the machine-readable surface contract for a platform host (read/write semantics, pending states, rate limits, limits, idempotency, pagination completeness, data portability), each claim carrying its evidence and its verification status.
verify_surfaceRun the anonymous conformance checks for a contract now and return verified / failed / unknown / manual / unsupported per claim.
contribute_discrepancyReport a platform behaviour that contradicts a published claim, or a new claim, with evidence. One-line call: POST /v1/contribute with {contractId, kind, statement, evidence[], reporter, observedAt}. Stored as pending; a published contract is never changed without independent ver
get_integration_recipeGet a plain-text integration recipe for a platform: the order of operations to use it, and a guard clause for every behaviour we measured going wrong, each naming the contract claim behind it. Derived from the contract, so it cannot drift from it.
preflight_mcp_server 看起来像是对 AI 下的指令Run the anonymous MCP handshake against ANY https MCP endpoint you name, right now, and get back a verdict (open / refused / unreachable / initialize-transport-error), the shape of any refusal body, whether the server is stateful (sets Mcp-Session-Id), how many tools tools/list r
prepay_checkCheck an x402 route BEFORE you pay it. GET /v1/prepay?url= makes ONE unpaid GET with no payment header and no credential, and returns one row: the measured HTTP status, the parsed x402 v2 challenge (scheme / network / asset / amount / payTo), whether that challenge is schema-vali
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月15日
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 3 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
GitHub 仓库最后更新于–,最新版本(2026.10.22)于24天前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
同一分类中有:Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
仓库中没有找到 README