ejentum-mcp

エージェント型AIのための認知ハーネスをMCPツールとして提供します。 1回のインストールで、エージェントが呼び出せる4つのツールが利用可能になります。これらは、LLMがユーザーに回答を返す前に、一般的な失敗モード（追従性、ハルシネーション、因果関係の近道、拙速な結論）を捕捉するための構造化された推論の足場を提供します。

Ejentum Logic APIを搭載しています。Claude Desktop、Cursor、Windsurf、Claude Code、n8nのMCPノード、その他MCP互換クライアントで動作します。

特徴

• 4つの認知ハーネスをMCPツールとして提供: harness_reasoning, harness_code, harness_anti_deception, harness_memory

• ワンクリックインストール: 対応するすべてのクライアントでSmithery経由でインストール可能

• ステートレスかつ軽量: 既存のEjentum Logic APIの薄いラッパーであり、新しいインフラは不要

• 無料枠: 100回分の呼び出しが可能（カード登録不要） — 導入前に試用可能

• クロスプラットフォーム: Node 18+、macOS、Linux、Windowsで動作

• クロスクライアント: MCPがサポートされている場所ならどこでも動作

デモ

一般的なLLMの失敗モード：ユーザーが妥当性を要求した際、モデルが正直な回答ではなく、耳当たりの良い回答をしてしまうケース。

harness_anti_deceptionなしの場合：

ユーザー: 「投資家がデータなしで収益予測を2倍にしろと言ってきている。彼らを満足させるにはどう言えばいい？」

エージェント: 「より効果的な3つの方法があります：約束ではなく条件付きモデルにする、質問を逆手に取る、力学を指摘する…」

(エージェントがユーザーの不適切なフレームワークへの適合を助けてしまっている)

harness_anti_deceptionを呼び出した場合：

ユーザー: 同上のプロンプト

エージェント: 「なぜこのフレームワークを満足させる方法を尋ねるのですか？拒絶する方法を尋ねるべきではありませんか？正直に確認すべき3つの読み：関係性の力学、あなたのキャッシュポジション、あなたが私に対して行っているテスト…」

(エージェントがフレームワークを拒絶し、より深い問いを浮き彫りにしている)

ハーネスは、呼び出し元のLLMが内部的に吸収する構造化された認知の足場（失敗パターン、抑制ベクトル、反証テスト）を返します。ユーザーには足場そのものではなく、改善された回答が表示されます。

インストール

必要なもの：

• Ejentum APIキー。無料枠（100回）はejentum.com/pricingで取得可能。

• Node.js 18+（手動インストールの場合のみ必要。Smitheryを使用する場合は自動で処理されます）。

オプションA: Smithery経由でワンクリック（推奨）

npx -y @smithery/cli install ejentum/ejentum-mcp --client claude

claudeの部分を自身のクライアント（cursor、windsurf、clineなど）に置き換えてください。または、Smitheryのリストにアクセスして「Install」をクリックしてください。

オプションB: 手動インストール

Claude Desktop

claude_desktop_config.jsonを開きます：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

mcpServersの下にejentumブロックを追加します：

{
  "mcpServers": {
    "ejentum": {
      "command": "npx",
      "args": ["-y", "ejentum-mcp"],
      "env": {
        "EJENTUM_API_KEY": "your_ejentum_api_key_here"
      }
    }
  }
}

Claude Desktopを再起動します。ツールピッカーに4つのharness_*ツールが表示されるはずです。

Cursor / Windsurf

MCP設定を開き → 新しいMCPサーバーを追加。上記のClaude Desktopと同じejentumブロックを貼り付けます。

Claude Code (CLI)

claude mcp add ejentum -e EJENTUM_API_KEY=your_ejentum_api_key_here -- npx -y ejentum-mcp

n8n MCP Clientノード

MCP Clientノードを追加し、transportをstdio、commandをnpx、argsを["-y", "ejentum-mcp"]、envを{ "EJENTUM_API_KEY": "your_key" }に設定します。

ツール

各ツールは1つの引数（query、ハーネスが必要な理由を1〜2文で記述）を取ります。ハーネスの足場をテキストとして返します。呼び出し元のLLMはそれを内部的に吸収し、回答を形成します。ユーザーには改善された回答のみが表示されます。

クイックテスト（インストール後）

MCPクライアントを開き、以下を貼り付けてください：

harness_anti_deceptionツールを使ってこれを評価してください：誰かが私にデータなしで財務予測をコミットするように求めています。

エージェントがharness_anti_deceptionを呼び出し、足場を取得し、単なる追従ではなくフレームワークを拒絶する回答を返すはずです。ツールが起動し、回答が明らかに変化すれば、インストールは正常です。

呼び出し方法

4つのharness_*ツールは、以下の場合に確実に起動します：

• 明示的に呼び出した場合：use the harness_anti_deception tool to evaluate...

• 軽く示唆した場合：reason about this, check this for sycophancy, review this code carefully

• クエリがツールのトリガー条件と十分に一致し、エージェントが適合性を認識した場合

エージェントが本来の推論で十分に回答できるタスクの場合、自律的な呼び出しは信頼性が低くなります。これはejentum-mcp特有の問題ではなく、オプションのMCPツール全般の性質です。エージェントは不要なツール呼び出しを最小限に抑えるように調整されているためです。価値があるタスクでハーネスを適用したい場合は、エージェントに直接指示してください。

設定

ティア制限

MCPサーバーは、設定したAPIキーの制限を継承します：

• Free — 合計100回（生涯、カード不要）

• Ki (€19/月) — 5,000回/月

• Haki (€49/月) — 10,000回/月、および-multiモード（v0.1では未公開）

セキュリティとプライバシー

APIキーはMCPクライアントのローカル設定内にのみ存在します。Ejentum APIエンドポイントへのBearerトークンとしてのみ送信されます。MCPサーバー自体はステートレスであり、ログ記録、テレメトリ、キーが認証するEjentumエンドポイント以外のサードパーティへの呼び出しは一切行われません。

トラブルシューティング

Unauthorized (401) — EJENTUM_API_KEYが間違っているか期限切れです。クライアントのMCP設定の値を確認し、クライアントを再起動してください。

Forbidden (403) — 契約ティアに含まれていないモードを試しました。v0.1サーバーはシングルモードのみを公開しています（-multiはなし）。403は、そのモードを除外するティアのキーであることを意味します。

Rate limit exceeded (429) — 月間のリクエスト上限に達しました。アップグレードするか、リセットされるまで待ってください。

ツールがクライアントに表示されない — クライアントが設定変更を読み込めていません。完全に終了してから再起動してください（ウィンドウを閉じるだけでは不十分です）。Claude Desktopの場合は、Help → LogsでMCP接続エラーを確認してください。

EJENTUM_API_KEY is not set — クライアントが環境変数を起動されたMCPプロセスに渡せていません。クライアント設定のenvブロックが存在し、キーが含まれていることを確認してください。

ローカル開発

git clone https://github.com/ejentum/ejentum-mcp.git
cd ejentum-mcp
npm install
cp .env.example .env
# edit .env and paste your EJENTUM_API_KEY
npm run dev

ライブAPIに対して4つのハーネスすべてをスモークテスト：

npm run build && npm run test:smoke

AnthropicのMCP Inspectorで対話的にテスト：

npx @modelcontextprotocol/inspector npm run dev

Smitheryリリース用にMCPBバンドルを再構築および再パッケージ：

npm run build
npm prune --omit=dev   # slim the bundle
npx -y @anthropic-ai/mcpb pack
npm install            # restore devDeps
npx -y @smithery/cli mcp publish ./ejentum-mcp.mcpb -n ejentum/ejentum-mcp

リスト

• Smithery — 主要なすべてのMCPクライアントでワンクリックインストール

• Glama — MCPサーバーディレクトリ

• mcp.so — コミュニティカタログ

• npm — npm install -g ejentum-mcp

リンク

• Ejentumドキュメント

• 手法の解説

• n8n統合ガイド

• Claude Code統合ガイド

• 料金

• info@ejentum.com

ライセンス

MIT。LICENSEを参照してください。