Esheria Regulatory Intelligence

Esheria CLI And MCP

Esheria Regulatory Pack API 用のインストール可能なコマンドラインツールおよび MCP ツールです。

明示的に公開されたパックを対象とする、世界各地の引用付き規制情報です。 現在の対応状況を確認し、対象の法域とパックを選択して、CLI、Python、 MCP のワークフロー全体で引用、バージョン、制限事項、トレース ID を 維持できます。Esheria が提供するのは規制情報であり、法律上の助言ではありません。

このパッケージでは、次の 2 つのコマンドを利用できます。

esheria --help
esheria-mcp --help
esheria mcp serve --help

バージョン 1.2.2 は、一般公開されている本番環境向けの安定版リリースです。esheria Python パッケージで配布される CLI、Python クライアント、MCP ソフトウェアは Apache License 2.0 の下でライセンスされています。ホスト型 API／MCP へのアクセス、規制データ、サービスの出力、Esheria の商標は Apache-2.0 のライセンス対象ではありません。これらは引き続き、Esheria Terms of Service、Privacy Policy、および該当する顧客契約に準拠します。正確な範囲については LICENSE と NOTICE をご確認ください。

CLI クイックスタート

1. Esheria ダッシュボードでデータ API トークンを作成します。
2. コマンドをインストールします。pipx を使うとコマンドラインツールをプロジェクトの依存関係から分離できるため、おすすめです。

pipx install esheria

pipx を使用しない場合は、通常の pip を使います。

python3 -m pip install esheria

3. シェルを設定します。一度だけテストする場合は、これらをターミナルに入力します。設定を維持するには、~/.zshrc、~/.bashrc、またはシェルのプロファイルに追加します。

export ESHERIA_API_BASE_URL="https://api.esheria.ai"
export ESHERIA_API_KEY="<client-api-key>"

PowerShell の場合：

$env:ESHERIA_API_BASE_URL = "https://api.esheria.ai"
$env:ESHERIA_API_KEY = "<client-api-key>"

ESHERIA_API_KEY が設定されていない場合は、ESHERIA_API_TOKEN も別名として使用できます。

API キーをコミットしないでください。CLI と MCP サーバーは、環境変数またはコマンドラインフラグから認証情報を読み取り、診断出力では API キーの値をマスキングします。環境変数の使用をおすすめします。--api-key はシェル履歴やオペレーティングシステムのプロセス一覧から見える可能性があります。

4. API に接続できることを確認します。

esheria --version
esheria health --format json
esheria ready --format json

5. パックを一覧表示して domain_pack_id を選択し、そのパック ID をパック固有のコマンドに渡します。

esheria packs list --format json
export ESHERIA_PACK_ID="UK-DATA-PROTECTION-PRIVACY"
esheria packs inspect "$ESHERIA_PACK_ID" --format json
esheria packs versions "$ESHERIA_PACK_ID" --format json
esheria packs diff "$ESHERIA_PACK_ID" --format json
esheria packs change-events "$ESHERIA_PACK_ID" --format json
esheria obligations list "$ESHERIA_PACK_ID" --limit 3 --format json
esheria penalties list "$ESHERIA_PACK_ID" --limit 5 --format json
esheria legal-review audit "$ESHERIA_PACK_ID" --limit 5 --format json

出力フラグは、グローバルまたは末端のコマンドに指定できます。

esheria --format json packs list
esheria packs list --format json

コマンドツリー全体を確認するには、esheria --help と <group> --help を使います。上記の読み取りワークフローに加え、CLI にはソース監視操作、グラフのカバレッジ／再構築操作、ワークスペースのスコープに限定した顧客ライフサイクルコマンド、ワークスペース／トークン／請求の管理コマンドも含まれています。

ワークスペース、トークン、請求に関するコマンドには管理トークンが必要です。ダッシュボードで通常作成するトークンと OAuth コネクタートークンには regulatory:read のみが付与されています。状態を変更する規制関連ワークフローには、monitoring:write、graph:write、customer:write のいずれか 1 つ以上を持つ、明示的に作成されたオペレーターデータトークンが必要です。regulatory:read だけでは拒否されます。例：

esheria tokens create \
  --name "Monitoring operator" \
  --scope regulatory:read \
  --scope monitoring:write \
  --pack UK-DATA-USE-AND-ACCESS

セルフサービスによるワークスペース、トークン、請求、サブスクリプションの管理には、引き続きダッシュボードの使用をおすすめします。オペレータートークンは短期間のみ有効にし、必要なスコープとパックの利用権限だけを付与してください。

CLI と MCP サーバーはカタログ優先です。ユーザーはパックを一覧表示してから、使用するパック ID を明示してツールを呼び出します。ESHERIA_DEFAULT_PACK_ID はクライアント側で任意に設定できる設定であり、サーバー側の法域デフォルトではありません。

CLI は API の対応状況ラベル、制限事項、引用、トレース ID を報告します。後続のワークフローでもこれらを維持してください。公開済みパックは、法令コーパス全体のうちレビュー済みの一部のみを表している場合があります。また、評価器によるゲート付きの主張検証は、すべてのパックで利用できるわけではありません。Esheria の出力は規制情報であり、法律上の助言や有資格の弁護士による助言の代わりではありません。

ホスト型 MCP

本番環境の MCP では、ホスト型の Esheria エンドポイントを使用します。

https://mcp.esheria.ai/mcp

通常の顧客オンボーディングには、このエンドポイントを使用してください。ユーザーのマシンにローカルの Python、uvx、仮想環境、パッケージの検索を用意する必要がありません。

Claude Directory のホストでは OAuth を使用します。その他のエージェントホストでは、ダッシュボードで作成した Esheria データトークンをベアラートークンまたは X-API-Key として送信します。ホスト型 MCP サーバーは初期化前に認証情報をイントロスペクションし、その認証情報を使って Regulatory Pack API を呼び出すため、課金、パックの利用権限、トレース ID、公開済みのものに限定する動作が一元管理されます。無効な認証情報および管理専用の認証情報では、ツールを列挙できません。

Codex MCP

Codex が読み取れる場所にトークンを設定します。

export ESHERIA_API_KEY="<client-api-key>"

~/.codex/config.toml を編集して、次の項目を追加します。

[mcp_servers.esheria]
url = "https://mcp.esheria.ai/mcp"
bearer_token_env_var = "ESHERIA_API_KEY"

Codex を再起動し、esheria_health、esheria_ready、esheria_list_packs を呼び出します。

ローカル MCP フォールバック

ローカル開発の場合、またはリモート MCP URL をサポートしていないエージェントホストの場合は、stdio サーバーを自分で実行できます。

esheria-mcp serve --stdio

オペレーター専用の HTTP トランスポートコマンド：

ESHERIA_API_BASE_URL="https://api.esheria.ai" \
  esheria-mcp serve --http --host 127.0.0.1 --port 8081 --path /mcp

本番環境にはすでに https://mcp.esheria.ai/mcp がデプロイされています。エンドユーザーはこのコマンドを実行しないでください。

ホスト型 OAuth プロファイルでは、ヘルス、レディネス、パックの検出、義務、適用可能性、クレームの検証、バージョン、差分、変更イベント、申告カレンダー、証拠、罰則、監査メタデータ、関係性の照会、エクスポート、引用コンテキストを扱う、読み取り専用の20ツールカタログが公開されます。通常の API データトークンでは、読み取りまたは読み取りに類する安全なツールが29個公開されます。オペレーターデータトークンでは、monitoring:write、graph:write、および／または customer:write で許可された変更操作のみが追加され、最大で37ツールすべてを利用できます。すべての変更操作には confirm=true も必要です。OAuth Directory セッションは引き続き読み取り専用です。

ホスト型サービスは、公式 MCP SDK と最新の Streamable HTTP を使用します。成功したツール呼び出しでは、上限付き JSON がテキストコンテンツと structuredContent に反映され、trace_id と mcp の切り詰めメタデータが含まれます。大規模なエクスポートを完全な形で取得する場合は、API または CLI を使用してください。

リモート MCP URL をサポートしていないホストに限り、stdio を使用してください。

[mcp_servers.esheria]
command = "uvx"
args = ["--from", "esheria", "esheria-mcp", "serve", "--stdio"]
env = { ESHERIA_API_BASE_URL = "https://api.esheria.ai", ESHERIA_API_KEY = "<client-api-key>" }

Claude Code

インストール済みのバージョンで利用できる場合は、Claude Code のリモート MCP 設定を使用してください。

• URL：https://mcp.esheria.ai/mcp
• 認証：Bearer <client-api-key>

お使いの Claude Code のバージョンがローカルの stdio MCP サーバーのみをサポートしている場合は、ターミナルから次のフォールバックを一度実行します。

claude mcp add --scope user --transport stdio \
  --env ESHERIA_API_BASE_URL=https://api.esheria.ai \
  --env ESHERIA_API_KEY=<client-api-key> \
  esheria -- uvx --from esheria esheria-mcp serve --stdio

次に、以下を実行します。

claude mcp list

Claude Code を起動または再起動し、Esheria MCP ツールを使用するよう指示します。

Claude Desktop

インストール済みのバージョンで利用できる場合は、Claude Desktop のリモート MCP 設定を使用してください。

• URL：https://mcp.esheria.ai/mcp
• 認証：Bearer <client-api-key>

お使いの Claude Desktop のバージョンがローカルの stdio MCP サーバーのみをサポートしている場合は、以下のフォールバックを使用してください。

Claude Desktop の MCP 設定ファイルを開きます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

次のオブジェクトを追加またはマージします。

{
  "mcpServers": {
    "esheria": {
      "command": "uvx",
      "args": ["--from", "esheria", "esheria-mcp", "serve", "--stdio"],
      "env": {
        "ESHERIA_API_BASE_URL": "https://api.esheria.ai",
        "ESHERIA_API_KEY": "<client-api-key>"
      }
    }
  }
}

ファイルを保存した後、Claude Desktop を再起動します。