Hejdar

hejdar-mcp

Hejdar の MCP サーバー — AI エージェント向けのランタイムポリシー適用機能です。

このサーバーは、hejdar_evaluate を MCP ツールとして公開します。MCP 対応のエージェント（Claude、ChatGPT、Cursor、カスタムエージェント）は、アクションを実行する前に、組織のポリシーで許可されているかを確認するために呼び出せます。

この MCP サーバーは、Hejdar API（POST /v1/evaluate）を呼び出す薄いラッパーです。ポリシーに関するロジックは含まれておらず、すべての判断は Hejdar 組織に設定されているポリシーに基づきます。

クイックスタート

1. インストール

pip install hejdar-mcp

または、uvx で直接実行します。

uvx hejdar-mcp

2. API キーを取得

app.hejdar.com で登録し、設定 → API Keys から API キーを作成します。

3. MCP クライアントを設定

Claude Desktop

Claude Desktop の設定ファイルに追加します（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）。

{
  "mcpServers": {
    "hejdar": {
      "command": "uvx",
      "args": ["hejdar-mcp"],
      "env": {
        "HEJDAR_API_KEY": "hejdar_sk_your_key_here"
      }
    }
  }
}

Claude Code

Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "hejdar": {
      "command": "uvx",
      "args": ["hejdar-mcp"],
      "env": {
        "HEJDAR_API_KEY": "hejdar_sk_your_key_here"
      }
    }
  }
}

直接実行（stdio）

export HEJDAR_API_KEY=hejdar_sk_your_key_here
hejdar-mcp

はじめに

1. インストールします：pip install hejdar-mcp または uvx hejdar-mcp
2. API キーを取得します — [email protected] までお問い合わせいただくか、hejdar.com にアクセスしてください
3. MCP クライアントを設定します（上記の設定例を参照）

ツール：hejdar_evaluate

エージェントのアクションを、組織のセキュリティポリシーに照らして評価します。

入力：

パラメーター	型	必須	説明
action_type	string	はい	READ、WRITE、DELETE、TRANSFER、EXECUTE のいずれかです（Hejdar API に合わせて、UPDATE は WRITE の別名として受け付けられます）
resource	string	はい	対象リソース。例：customer_database
agent_name	string	いいえ	呼び出し元エージェントの名前。例：hr-assistant
context	object	いいえ	任意のメタデータ（department、user_id、reason など）

出力：

{
  "decision": "DENY",
  "policy_id": "pol_abc123",
  "reason": "Deletion of customer data requires manager approval",
  "risk_level": "HIGH"
}

decision は ALLOW、DENY、WOULD_DENY のいずれかです。

システムプロンプトのパターン

最良の結果を得るには、エージェントのシステムプロンプトに次の内容を追加してください。

You have access to the hejdar_evaluate tool. Before performing any action
that reads, writes, deletes, transfers data, or executes commands on
external systems, you MUST call hejdar_evaluate first.

If hejdar_evaluate returns DENY or WOULD_DENY, do NOT proceed with the
action. Instead, inform the user that the action was blocked by policy
and include the reason provided.

環境変数

変数	必須	デフォルト	説明
HEJDAR_API_KEY	はい	—	Hejdar API キー
HEJDAR_API_URL	いいえ	https://api.hejdar.com	API のベース URL（セルフホスト用）

セキュリティ

• API キーは環境変数からのみ読み込まれ、ハードコードされたり、ツールの入出力に含まれたりすることはありません
• API に転送する前に、すべての入力を検証してサニタイズします
• エラーレスポンスから内部情報、API キー、スタックトレースが漏れることはありません
• すべての API 呼び出しで TLS を強制します

開発

git clone https://github.com/ARKALDA/hejdar-mcp.git
cd hejdar-mcp
pip install -e ".[dev]"
pytest

ライセンス

MIT