Wathba

Wathba エージェントプラグイン

AI コーディングエージェント向けの公式 Wathba (وثبة) プラグインです。 Codex、ChatGPT デスクトップアプリ、Claude Code、その他の Agent Plugins クライアントを、Wathba がホストする MCP サーバーに接続し、その使い方をエージェントに伝える短いスキルを追加します。決済、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 に移動し、マーケットプレイスを選択して Enable auto-update を選びます。

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 内のファイルは、手作業では編集しません。以下の 2 つのソースから生成されます。

• plugin.config.json：ID、オリジン、バージョン、ブランディング、掲載文。
• src/：共通スキル（src/skills/wathba/SKILL.md）、アイコン、dev ブランチ用 README。

scripts/sync.mjs は環境ごとに 1 つのマーケットプレイスをビルドし、パッケージング規則を適用します。規則には、ID、パス、ヘッダーやスコープのないパッケージごとに 1 つの MCP サーバー、環境の分離、認証情報の不使用、スキルのツールリスト、アイコンのハッシュが含まれます。

ワークフロー	実行時期	内容
validate	すべての PR、main または dev へのプッシュ、毎週	ジェネレーターの規則とバージョン規則を確認し、両方のビルドを一時的な Claude Code と Codex のホームにインストールしてから、稼働中の OAuth メタデータを確認します
publish-dev	dev へのプッシュ	開発用マーケットプレイスをビルドして検証し、dev-marketplace ブランチに公開します
drift	毎日	両環境の稼働中 OAuth メタデータを確認し、一致しなくなった場合は Issue を作成します
release	main の v* タグ	プラグイン ZIP を含む GitHub リリースを作成し、続いて MCP Registry に登録します

パッケージにスコープは含まれません。許可する権限は Wathba サーバーが決定します。接続ごとにエージェントへの完全なアクセス権が付与され、同意ページにはその権限で可能なことが正確に表示されます。

プラグインを変更する

プラットフォームと同様に、変更はまず DEV に反映され、その後に本番環境へ反映されます。

1. dev からブランチを作成し、plugin.config.json または src/ を編集します。
2. node scripts/sync.mjs check を実行します。
3. dev にプルリクエストを作成します。マージされると、publish-dev が <version>-dev.<run> として DEV のエージェントに公開します。この段階ではバージョンを上げる必要はありません。DEV メンバーのエージェントに反映されるため、オーナーによるレビューが必要です。

contract.json には、スキルで名前を挙げている Wathba のツールが記載されています。プラットフォームの CI はこれを読み込み、バックエンドの変更でツールが削除または改名される場合は失敗します。

本番リリース

対応する Wathba プラットフォームのリリースが本番環境に反映された後にのみ昇格してください。これにより、スキルが本番サーバーでまだ提供されていないツールを挙げることを防げます。

1. dev から main へのプルリクエストを作成し、plugin.config.json の version を引き上げます。Claude Code はバージョンが変わった場合にのみ更新するため、同じバージョンのままパッケージを変更すると CI に拒否されます。マージしてください。本番環境へのインストールでは、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