Kaidn

Kaidn MCP

Kaidn の不正検知スコアリング API 用 Model Context Protocol サーバーです。

平易な英語で不正を調査できます — 「この登録がブロックされた理由は？」、「このデバイスはほかに何にアクセスした？」、「今朝のレビューキューには何が入っている？」

• スコアだけでなく、根拠も示します。 すべての理由に、その根拠となる生の数値が含まれているため、モデルは判定を推測するのではなく、説明できます。
• デフォルトでは読み取り専用です。 オプトインしない限り、テナントのデータは変更されません。
• クォータで保護されています。 エージェントがループしても、10 分で 1 か月分の利用枠を使い切ることはありません。
• どのクライアントでも利用できます。 MCP はオープンプロトコルです。ローカルでは stdio、リモートやホスト型エージェントでは Streamable HTTP を使用できます。

要件

Node.js 18 以降、およびKaidn ダッシュボードの API キーが必要です。

はじめに

まず、使用するクライアントで Kaidn MCP サーバーをインストールします。標準設定は、ほとんどのツールで利用できます。

{
  "mcpServers": {
    "kaidn": {
      "command": "npx",
      "args": ["@kaidn/mcp@latest"],
      "env": { "KAIDN_API_KEY": "your_key" }
    }
  }
}

claude mcp add kaidn --env KAIDN_API_KEY=your_key -- npx @kaidn/mcp@latest

code --add-mcp '{"name":"kaidn","command":"npx","args":["@kaidn/mcp@latest"],"env":{"KAIDN_API_KEY":"your_key"}}'

Configuration

優先順位： CLI フラグは環境変数より優先されます。

API キーを環境変数でのみ指定するのは意図的です。フラグで渡したキーは、プロセス一覧やシェルの履歴に漏洩します。

トランスポート

HTTP+SSE は意図的に含めていません。2025-03-26 仕様で非推奨となり、2026 年 6 月に終了するためです。

Streamable HTTP

npx @kaidn/mcp@latest --http --port 8765

ステートレスです。リクエストごとに新しいサーバーが起動し、呼び出し元どうしで共有されるものはありません。そのため、予期しない問題なくロードバランサーの背後に配置できます。GET /health は認証不要なので、オーケストレーターはトークンを保持せずに稼働状況を確認できます。

Docker

docker build -t kaidn-mcp .

# stdio — behaves like the npx invocation
docker run -i --rm -e KAIDN_API_KEY=your_key kaidn-mcp

# HTTP — for remote agents
docker run --rm -p 8765:8765 \
  -e KAIDN_API_KEY=your_key \
  -e KAIDN_MCP_TRANSPORT=http \
  -e KAIDN_MCP_HOST=0.0.0.0 \
  -e KAIDN_MCP_HTTP_TOKEN=your_token \
  kaidn-mcp

マルチステージビルドを使用し、権限のない node ユーザーとして実行し、ヘルスチェックを備えています。

セキュリティ

サーバーは API キーを保持します。 サーバーに接続できる人は誰でもクォータを消費できるため、デフォルト設定は慎重にしてあり、ガードは警告を出すのではなく、フェイルクローズで動作します。

• 127.0.0.1 にバインドし、より広いインターフェースでの起動を拒否します。 ただし、KAIDN_MCP_HTTP_TOKEN が設定されている場合を除きます。アカウントを気付かれないまま公開するのではなく、理由を説明して停止します。
• デフォルトでは読み取り専用です。 add_to_list と label_outcome は --allow-writes を指定した場合にのみ利用できます。
• set_config と forget_subject は、どのモードでも公開されません。 前者は今後のすべてのイベントの判定をひそかに変更し、後者は取り消し不能な GDPR に基づく消去です。どちらも人間が確認できるダッシュボードで行うべき操作です。
• プロセスごとにクォータ上限があります。 残りの予算は、コストが発生するレスポンスごとに報告されます。上限を超える予約は一部だけ消費するのではなく、完全に拒否されます。
• キーがツールの境界を越えることはありません。 パラメーター、出力、エラーのいずれにも含まれません。

ツール

すべてのツールの動作を決める要素は 2 つです。クォータを消費するか、そして何かを変更するかです。

読み取り専用 — デフォルトで利用可能

¹ エンティティが device_id の場合は無料です。エンリッチメントのコストが発生するのはメールアドレスまたは IP の場合のみです。

変更を加えるツール — --allow-writes が必要

使用例

ツールは連鎖して使えるように設計されています。以下は、そのために構築されたワークフローです。

朝のトリアージ

あなた： 夜の間に何が起きて、何に対応する必要がありますか？

モデルはget_statsを呼び出して過去24時間の状況を把握し、次にtriage_queueでreviewにあるイベントを確認し、さらに最も問題のあるイベントについてexplain_eventを呼び出します。読み込む必要のあるダッシュボードではなく、根拠付きの優先順位リストが得られます。

「この顧客がブロックされたのはなぜですか？」

あなた： イベントevt_8f21cです。顧客から、誤ってブロックされたと連絡がありました。

explain_eventは、検出されたすべてのチェックとその生の証拠を返します。一致したデータセンターのASN、同じデバイスを共有するアカウント数、速度のカウントなどです。顧客への回答や、ルールが誤っていて調整が必要だと判断するのに十分な情報が得られます。

1つのシグナルから調査を広げる

あなた： 194.x.x.xは単発の事象ですか、それとも組織的な動きの一部ですか？

investigate_entityは、そのIPのエンリッチメント情報とネットワーク評価に加えて、そのIPが含まれる最近のすべてのイベントを返します。同じデバイスIDが繰り返し出現しているなら、偶然ではなく組織的な動きです。

ルールを変更する前に確認する

あなた： 速度の重みを下げた場合、何がブロックされなくなりますか？

get_configで現在の重みを確認し、verdict: "block"を指定したlist_eventsで、現在検出されているものを表示します。モデルは、重みを下げようとしているチェックに依存する項目を特定できます。

エラー処理

失敗は例外ではなく、読みやすいメッセージを含むツールエラーとして返されるため、モデルはそれに対処できます。

エラーにAPIキーが含まれることはありません。

トラブルシューティング

クライアントにツールが表示されません。 クライアントのMCPログで起動時の行を確認してください。標準エラー出力にkaidn-mcp: ready (stdio, …)と表示されていれば、サーバーは起動しており、問題はクライアント側にあります。何も表示されない場合は、通常、npxでパッケージを解決できなかったか、Nodeのバージョンが18未満です。

起動後、すぐに終了します。 ほとんどの場合、KAIDN_API_KEYが設定されていません。標準エラー出力にメッセージが表示されますが、標準エラー出力を隠すクライアントもあるため、ターミナルで実行して確認してください。

add_to_listとlabel_outcomeが見つかりません。 設計どおりの動作です。これらのツールには--allow-writesが必要です。

set_configとforget_subjectが見つかりません。 こちらも設計どおりの動作で、どのモードでも利用できません。SECURITY.mdを参照してください。

HTTPモードを起動できません。 ベアラートークンを設定せずに、ループバック以外にバインドしています。プロセスがAPIキーを保持しているため、ガード機能が動作しています。

すべての処理が遅いです。 エンリッチメントチェックでは、ライブの上流サービスへの呼び出しが行われます。get_stats、list_events、explain_event、triage_queueは無料で高速です。履歴を確認する場合は、これらを優先してください。

クライアントとは別にサーバーを確認する：

node dist/index.js --help                 # no key required
KAIDN_API_KEY=your_key npm start          # should print a ready line

サポート

• バグと機能リクエスト： GitHubの課題
• セキュリティ： [email protected] — SECURITY.mdを参照してください
• プライバシーとデータの取り扱い： PRIVACY.md
• APIについて： kaidn.io

ソースから実行する

git clone https://github.com/Kaidn-io/kaidn-mcp.git
cd kaidn-mcp
npm install
npm run build
npm test

claude mcp add kaidn --env KAIDN_API_KEY=your_key -- node /absolute/path/to/kaidn-mcp/dist/index.js

クライアントを使わずに起動を確認するには：

KAIDN_API_KEY=your_key npm start

標準エラー出力に kaidn-mcp: ready (stdio, read-only, quota ceiling 100) と表示され、 その後は標準入力を待ちます。これが MCP トランスポートなので、何も表示されないのは正常です。

エビデンスが重要な理由

Kaidn のエンジンはルール優先で、説明可能です。それぞれの理由には、その根拠となる未加工の数値が含まれています。単なるスコアではモデルが推論する材料になりませんが、エビデンスが付いた checks[] があれば、説明する材料になります。これが、explain_event が役立つものになるか、単なる飾りになるかの違いです。

ルールが判断し、モデルが語ります。

プロジェクト

• CONTRIBUTING.md — ここに含める内容と、変更によって損なってはならない保証
• SECURITY.md — 報告方法、脅威モデル、既知の制限事項
• PRIVACY.md — 通過するデータ、保存されるデータ、保存されないデータ
• CODE_OF_CONDUCT.md

ライセンス

MIT