Wathba

Wathba Agent 插件

面向 AI 编码 Agent 的官方 Wathba（وثبة） 插件。 它将 Codex、ChatGPT 桌面应用、Claude Code 和其他 Agent Plugins 客户端连接到 Wathba 托管的 MCP 服务，并添加一段简短的技能说明，告知 Agent 如何使用它。支付、OTP/SMS、KYC、ZATCA 电子发票和物流功能通过 Wathba 接入你的应用；该插件不会处理 API 密钥，成员通过浏览器登录（OAuth）。

环境	分支	安装 ID	MCP 服务
生产环境	main	wathba@wathba	https://api.wathba.sa/mcp
开发环境	dev-marketplace（由 dev 构建）	wathba-dev@wathba-development	https://apidev.wathba.sa/mcp

安装

Claude Code

/plugin marketplace add wathba-org/wathba-plugin
/plugin install wathba@wathba

要使用开发环境，请添加 wathba-org/wathba-plugin#dev-marketplace， 并安装 wathba-dev@wathba-development。然后运行 /mcp，选择 Wathba 服务并登录。要自动获取更新，请打开 /plugin，进入 Marketplaces，选择该市场并启用自动更新。

Codex 和 ChatGPT 桌面应用

codex plugin marketplace add wathba-org/wathba-plugin
codex plugin add wathba@wathba

要使用开发环境，请添加 --ref dev-marketplace 并安装 wathba-dev@wathba-development。从应用的 Plugins 页面安装会启动登录； 在终端中，运行 codex mcp login wathba（或 wathba-dev）。Codex 会在启动时检查市场更新。

任何其他 MCP 客户端

使用上表中的远程 MCP 服务 URL，并采用 Streamable HTTP 传输；客户端会自行发现 Wathba 的 OAuth 设置。Claude （web、Desktop 和 Cowork）及 ChatGPT 可将其作为自定义连接器使用。请使用插件或直接连接二者之一，不要同时使用，否则每个 Wathba 工具都会出现两次。

此代码仓库的工作方式

plugins/、.claude-plugin/、.agents/ 和 contract.json 下的内容 都不是手动编辑的。它们由两个来源生成：

• plugin.config.json：身份信息、来源、版本、品牌和列表文案。
• src/：共享技能（src/skills/wathba/SKILL.md）、图标，以及 dev 分支的 README。

scripts/sync.mjs 会为每个环境构建一个市场，并强制执行打包规则：身份信息、路径、每个包恰好一个 MCP 服务且不含标头或作用域、环境隔离、不得包含凭据、技能的工具列表，以及图标哈希。

工作流	时间	执行内容
validate	每个 PR、推送到 main 或 dev 时，以及每周	生成器规则、版本规则，然后将两个构建版本安装到临时的 Claude Code 和 Codex 主目录中，最后检查实时 OAuth 元数据
publish-dev	推送到 dev 时	构建开发市场、验证并将其发布到 dev-marketplace 分支
drift	每天	检查两个环境的实时 OAuth 元数据，并在不再匹配时创建议题
release	在 main 上创建 v* 标签时	创建包含插件 ZIP 的 GitHub 发布版本，然后创建 MCP Registry 条目

这些包不包含作用域。授权由 Wathba 服务决定：每个连接都会获得完整的 Agent 访问权限，授权页面会准确说明允许的操作。

修改插件

与平台一样，变更会先进入 DEV，之后再进入生产环境。

1. 从 dev 创建分支，并编辑 plugin.config.json 或 src/。
2. 运行 node scripts/sync.mjs check。
3. 向 dev 提交拉取请求。合并后，publish-dev 会以 <version>-dev.<run> 的版本将其发布给 DEV Agent。此处无需升级版本号。 所有者必须审核：此变更会影响 DEV 成员的 Agent。

contract.json 列出了技能中提及的 Wathba 工具。平台的 CI 会读取该文件；如果后端变更会移除或重命名其中任一工具，CI 就会失败。

发布生产版本

匹配的 Wathba 平台版本发布到生产环境后再进行推广，这样技能就不会提及生产服务尚未提供的工具。

1. 创建从 dev 到 main 的拉取请求，提高 plugin.config.json 中的 version。如果更改了软件包但版本号相同，CI 会拒绝，因为 Claude Code 只有在版本号变更时才会更新。合并该拉取请求：生产环境安装会从 main 获取更新。
2. 为合并提交打上 v<version> 标签并推送该标签。release.yml 会检查标签、配置和软件包是否一致，将插件 ZIP、server.json 和校验和附加到 GitHub 发布版本，然后在所有者批准 registry 环境后，将 server.json 发布到官方 MCP Registry。

生产环境热修复应通过单独的拉取请求（并提高 version）合并到 main；随后立即将 main 合并回 dev。

listing/ 存放 Anthropic 和 OpenAI 目录所需的材料。

验收

docs/acceptance/ 记录真实的主机使用流程（登录、读取、项目创建、重放、恢复、更新、回滚）。只有在有记录的运行结果后，才会将主机列为受支持。

许可证

Apache-2.0