mcpField
C
codex-gateway

codex-gateway

github.com/codex-data数据与数据库0367 次安装2 周前更新
代码仓库

关于 codex-gateway

codex-gateway 是在 Supergraph API 返回 402 时使用 Codex Machine Payment Protocol 的 Agent 技能，指导客户端无需 API 密钥、按 GraphQL 查询付费。

主要功能

  1. 01402 挑战响应流程
  2. 02无需 API 密钥的逐查询付费
  3. 03处理支付回执
  4. 04仅支持 GraphQL 查询

适用场景

  1. 01收到 402 响应后重试查询
  2. 02无需 API 密钥认证访问 Codex 数据

MCP 相关

该技能用于 Codex GraphQL API 的支付访问，未说明 MCP 功能。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/codex-data/skills --skill codex-gateway

安装后在 Claude Code 中输入/codex-gateway确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
gotchas.md
mpp-flow.md
rules/
wallets.md

详细介绍

Codex Machine Payment Protocol（MPP）

当 Codex Supergraph 返回 402 Payment Required 响应时，请使用此技能。MPP 挑战流程支持按查询付费，无需 API key。若需更高用量，可在 dashboard.codex.io/signup 获取 API key（入门套餐仅需一次性支付 $1 激活费，无持续费用）——详情请参阅 docs.codex.io。

HTTP endpointhttps://graph.codex.io/graphql
Credential headerAuthorization: Payment <base64url-credential>

工作原理

  1. 发送 GraphQL 查询（不附带凭证）。
  2. 服务返回 402 Payment Required，并附带 WWW-Authenticate: Payment ... 挑战。
  3. 客户端解决一个挑战，然后使用 Authorization: Payment <credential> 重试。
  4. 服务返回 GraphQL 数据和 Payment-Receipt 标头。

限制

  • 仅限查询。 在 MPP 模式下，变更和订阅会返回 403。
  • 如果同时提供了有效的 API key 或 bearer token，则优先使用 API 身份验证。

规则

  • 切勿打印原始凭证。
  • MPP 仅用于 query 操作。
  • 构造任何查询之前，请先阅读下方的 references/query-templates.md，了解正确的 GraphQL 架构。不要猜测查询或字段名称。

参考资料

文件用途
../codex-supergraph/references/query-templates.mdGraphQL 查询架构和示例——构造查询前请先阅读
../codex-supergraph/references/gotchas.md常见查询失败原因
references/gotchas.mdMPP 特有的失败原因
rules/wallets.md钱包设置：tempo wallet/request（Tempo）
references/mpp-flow.md身份验证矩阵、挑战详情、错误代码

链接

评论

支持 Markdown