Erstan Agent Tools Beta

AIコーディングエージェント向けの一時的なErstan Beta統合です。このリポジトリは、ベータユーザーをErstanの分離されたQA環境に接続する1つの広範なプラグインをパッケージ化し、AgentとSkillの構築、レビュー、最適化、実行の操作、および承認済みワークスペースコンテンツの操作に関する焦点を絞った指示を提供します。

ベータ環境: このプラグインのデータとOAuth許可は本番環境とは分離されています。ワークスペースが移行されたら、本番用のerstanプラグインをインストールしてください。このリポジトリはその後廃止されます。

このプラグインにはErstan APIキーは含まれていません。各ユーザーはAIホストを通じてOAuthでhttps://api-qa.erstan.com/v1/mcpにサインインします。Erstanのサーバー側ベータアクセスポリシーがアクセス境界のままです。リポジトリの可視性は製品アクセスを許可するものではありません。

含まれるもの

• erstan-agent-builder — Agentグラフの作成、修正、検証、テスト、公開。

• erstan-agent-optimizer — 既存のAgentを取得し、最小のバージョン対応最適化提案を生成。

• erstan-agent-review — Agent定義のレビューと、永続的な証拠に基づく実行の診断。

• erstan-run-operator — 公開済みAgentの起動と、待機、承認、トレースの安全な処理。

• erstan-skill-manager — 完全なバージョン管理されたErstan Skillパッケージの管理。

• erstan-skill-optimizer — 完全なワークスペースSkillパッケージを取得し、ビジネスルール、ファイル、アクションメタデータを失わずに最適化。

• erstan-work-manager — 承認済みのタスク、プロジェクト、ドキュメント、フォルダ、ファイルの操作。

概念的なagent:optimizeおよびskill:optimize操作は、$erstan-agent-optimizerおよび$erstan-skill-optimizer Skillとして配布されます。これらはnpm CLIコマンドではありません。デフォルトでは、証拠に基づくローカル提案と検証結果で停止します。更新、ライブAgentプレビュー、公開にはそれぞれ個別の明示的な承認が必要です。

Related MCP server: mcp-testing-tools

権限モデル

接続がアクセスできる内容の真実の源泉はErstanです。ユーザーは接続済みアプリ、ワークスペーススコープ、許可されたツールファミリー、プロジェクトまたはチームの許可リスト、およびErstan側の承認ポリシーを設定 > 接続済みアプリで管理します。

初期認証は推奨されるビルドプロファイルにデフォルト設定されます。これにはエージェントの表示、エージェントの構築、エージェントの実行、エージェントの公開、および読み取り専用の実行の表示、作業の表示、ドキュメントの表示、ファイルの表示権限が含まれます。タスク、ドキュメント、ファイルへの書き込みは許可されません。読み取り専用アクセスにはレビューを使用してください。書き込みには、該当する作業の管理、ドキュメントの編集、またはファイルの編集権限を持つカスタムを使用するか、フルアクセスを選択してください。

ユーザーは設定 > 接続済みアプリで接続を管理および取り消します。アクセスの削減は直接反映されます。権限の拡大やより広いプロファイルへの変更には、バックグラウンドエージェントが自身の許可を拡張できないように、明示的なOAuth再認証が必要です。

Claude、Codex、ChatGPT、または別のMCPホストがローカル接続セッションとその独自の確認コントロールを所有します。ホストはアクセスを絞り込んだり、追加の確認を要求したりできますが、Erstanが拒否した権限を付与することはできません。Erstanで接続を取り消すと、それを使用するすべてのホストセッションで無効になります。

この2層モデルにより、権限は理解しやすくなります:

1. Erstanが許可される最大のデータとアクションを決定します。

2. AIホストがその境界内でアクションを呼び出すかどうかを決定します。

Codexへのインストール

erstan-beta@erstan-betaはプラグイン名@マーケットプレイス名を意味します。アカウントIDやシークレットではありません。

codex plugin marketplace add erstanai/erstan-agent-tools-beta
codex plugin add erstan-beta@erstan-beta

新しいCodexセッションを開き、/pluginsを使用してインストールを確認し、プロンプトが表示されたらerstan-beta MCPサーバーに接続して、ブラウザでのサインインを完了します。プラグインはplugins/erstan-beta/.mcp.jsonのリモートサーバー設定を使用します。

Claude Codeへのインストール

claude plugin marketplace add erstanai/erstan-agent-tools-beta
claude plugin install erstan-beta@erstan-beta

/reload-pluginsを実行し、次に/mcpでerstan-betaに接続してOAuthを完了します。Claude CodeがリモートMCP認証を開始します。プラグインはユーザーにベアラートークンやAPIキーの貼り付けを求めません。

Claude Cowork / Desktopへのインストール

カスタマイズ > プラグイン > プラグインを参照を開き、マーケットプレイスを追加を選択して、次を入力します:

https://github.com/erstanai/erstan-agent-tools-beta

Erstan Betaをインストールし、プロンプトが表示されたらブラウザでのサインインを完了します。プラグインは標準のClaude Chat画面ではなく、Claude CoworkとClaude Codeで利用できます。

更新または削除

ホストのプラグインブラウザを使用して、Erstan Betaを更新、無効化、またはアンインストールします。ローカルプラグインを削除しても、既存のErstan OAuth許可は取り消されません。許可の確認または取り消しは、Erstanの設定 > 接続済みアプリで行います。

公開されたバージョンとチェックサムはGitHub Releasesから入手できます。

ChatGPTおよびその他のホスト

この一時的なベータリポジトリは、ユニバーサルなChatGPTおよびCodexプラグインディレクトリに提出されていません。意図的に.app.jsonを含んでいません。OpenAIアプリマッピングでは、公開時に割り当てられた実際の登録済みplugin_asdk_app...またはasdk_app_...識別子を使用する必要があります。配布境界については公開を参照してください。

他のMCPクライアントは以下に直接接続できます:

https://api-qa.erstan.com/v1/mcp

デプロイされたサーバーは、標準準拠のOAuthディスカバリーと認証を公開する必要があります。この配布には静的キーのフォールバックはありません。

ローカルでの検証

要件: Node.js 20以降、Python 3、およびオプションでネイティブバリデーター用のClaude Code。

npm run verify
python C:/Users/<you>/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/erstan-beta
python C:/Users/<you>/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/erstan-beta/skills/erstan-agent-builder
claude plugin validate .

plugins/erstan-beta/skills配下の各ディレクトリに対して、スキルバリデーターを1回実行します。CIはリポジトリ所有のリリース検証ツールを実行します。ネイティブのCodex、Skill、Claudeバリデーターは、その可用性とスキーマがそれぞれのホストによって所有されているため、必須のリリースゲートのままです。

本番からの同期

ベータ配布は、明示的なIDとエンドポイント変換を伴うレビュー済みの本番チェックアウトから派生しています。ローカルでは、次を実行します:

npm run sync:production -- --source ../erstan-agent-tools

このコマンドは本番のSkillとアセットをコピーし、プラグインメタデータを整合させ、個別のerstan-beta IDを維持し、ホストされたMCPエンドポイントをhttps://api-qa.erstan.com/v1/mcpに書き換えます。手動の本番配布の同期 GitHub Actionsワークフローは同じ変換を実行し、結果を検証して、レビュー用のプルリクエストを開きます。ベータリリースの公開やマージは行いません。後でより高いプレリリース番号が必要な場合にのみ--versionを渡してください。バージョンは本番バージョンのプレリリースのままでなければなりません。

ツールキットの分離

このリポジトリは、小さくインストール可能なエンドユーザー向け配布です。メンテナー向けCLIユーティリティとオフライン診断フィクスチャは、別のerstan-agent-toolkitリポジトリに属し、プラグインリリースにコピーしてはなりません。

ライセンス

Apache License 2.0。LICENSEを参照してください。