casemargin-mcp-server

CaseMargin MCP サーバー

CaseMargin MCP サーバーは、サポートケースの推論ツールを提供します。ケースの構造化された概要を生成し、エスカレーションの準備状況を、MCP 互換の AI クライアント（Claude Desktop、Claude Code、Cursor など）から確認できます。ヘルプデスクのデータレイヤーの上位で動作します。Zendesk やその他のチケット管理システムからチケットを読み取ることはありません。チケットの内容を渡すと、casemargin.com を稼働させているものと同じ AI による構造化分析を返します。

ツール

generate_case_brief

サポートチケットのスレッドから、構造化されたケース概要を生成します。評価、これまでに試したこと、現在の状況、推奨される次のステップを返します。

入力： ticket_content（文字列）— メッセージや内部メモなど、貼り付けるかパイプで渡すチケットスレッド全体です。10～50,000 文字です。

出力（構造化 JSON）：

{
  "quick_scan": {
    "assessment": "…what this case is about and how serious it is…",
    "next_step": "…the single action the receiving agent should take now…",
    "status": "Waiting on customer"
  },
  "full_brief": {
    "current_problem": "…symptoms, blockers, business impact…",
    "actions_taken": ["action → outcome", "…"],
    "key_context": "…customer plan, history, logs, error codes…"
  },
  "metadata": {
    "input_length": 4210,
    "brief_length": 1250,
    "compression_ratio": 0.3
  }
}

check_escalation_readiness

サポートチケットを L2 にエスカレーションする準備ができているか分析します。準備状況のスコア（0～100）、項目別の内訳、L2 から想定される質問、不足している項目を返します。

入力： ticket_content（文字列）— 評価するチケットのメモです。10～20,000 文字です。

出力（構造化 JSON）：

{
  "overall_score": 62,
  "readiness": "borderline",
  "dimensions": {
    "problem_clarity": { "score": 80, "note": "…" },
    "troubleshooting_evidence": { "score": 55, "note": "…" },
    "business_impact": { "score": 40, "note": "…" },
    "next_action": { "score": 70, "note": "…" },
    "billing_defensibility": { "score": 65, "note": "…" }
  },
  "predicted_l2_questions": ["…", "…"],
  "missing_items": ["…", "…"]
}

インストール

事前のインストールは不要です。初回実行時に npx がパッケージを取得します。これを claude_desktop_config.json に追加して、Claude Desktop を再起動してください。

{
  "mcpServers": {
    "casemargin": {
      "command": "npx",
      "args": ["-y", "casemargin-mcp-server"],
      "env": {
        "CASEMARGIN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor と Claude Code でも、それぞれの設定ファイルで同じ形式の設定を使用します。設定ファイルは、macOS では ~/Library/Application Support/Claude/、Windows では %APPDATA%\Claude\ にあります。ウィンドウを閉じるだけでなく、アプリを終了して再起動してください。設定はプロセスの起動時に読み込まれます。

API キーは任意です。キーがなくても、概要の生成は IP ごとの匿名利用枠で実行されます。無料キー（毎月 8 件の概要）を casemargin.com/signup で取得できます。エスカレーション準備状況の確認は無料で、キーは不要です。キーなしで実行するには、env ブロック全体を削除してください。

MCP Registry では com.casemargin/casemargin-mcp-server として、npm でも公開されています。

ソースから実行する

サーバーを変更する場合にのみ必要です。

git clone https://github.com/Casemargin/casemargin-mcp-server.git
cd casemargin-mcp-server
npm install
npm run build

次に、command を node に、args をビルド済みの dist/index.js の絶対パスに設定してください。

使用例

「このチケットでは何が起きていますか？」

チケットスレッドを AI クライアントに貼り付け、何が起きているのか尋ねます。

あなた： このチケットでは何が起きていますか？

月曜日から約 30 分ごとに VPN が切断されるとお客様から報告がありました。ルーターを再起動し、クライアント v4.2 を再インストールしましたが、問題は続いています。ファイアウォールのログでは、DHCP リースが 30 分ごとに更新されています。お客様は Premium SLA を利用しており、CFO に影響が出ています。金曜日までに解決しなければエスカレーションすると伝えました……

Claude は generate_case_brief を呼び出し、構造化された概要を返します。

概要 — Premium SLA のアカウントで、幹部にも影響している VPN の繰り返し切断です。30 分ごとの DHCP リース更新との関連が見られ、緊急度は中～高です。 次のステップ： 影響を受けているスコープの DHCP リース時間を延長し、切断がリース更新に連動しているか確認します。 状況： 対応中です。

……さらに、現在の問題、すでに実施した対応（それぞれの結果を含む）、重要な背景情報の詳細な内訳も返します。

「このチケットはエスカレーションできる状態ですか？」

あなた： このチケットは L2 にエスカレーションできる状態ですか？

（同じスレッドを貼り付けます）

Claude は check_escalation_readiness を呼び出し、内訳とともにスコアを返します。

62/100 — 境界線上です。 問題の明確さは高い（80）一方、トラブルシューティングの証拠は乏しく（55）、パケットキャプチャやクライアントログが添付されていません。また、業務への影響は述べられているものの、定量化されていません（40）。エスカレーションの前に、L2 は「切断時点の VPN クライアントログには何が記録されていますか？」、「ネットワークを変えてもユーザーに同じ問題が発生しますか？」と尋ねるでしょう。

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

このサーバーはネットワーク呼び出しを行い、環境変数を読み取るため、サプライチェーンスキャナーでは両方が検出されます。SECURITY.md に全容を記載しています。外部接続先は1つ、環境変数は2つで、ファイルシステム、サブプロセス、動的コード、インストールスクリプト、テレメトリーには一切アクセスしません。

事前に知っておいていただきたい点が2つあります。マシンから送信されるのは、ツールに渡した ticket_content だけです。それ以外は何も収集されず、生のチケットテキストがサーバー側に保存されることもありません。また、API キーはリクエストヘッダーとして送信されるため、CASEMARGIN_API_URL がループバック以外の https ではない接続先を指している場合、サーバーはキーを暗号化せずに送信することなく、起動を拒否します。

リリースは npm provenance を使用して GitHub Actions から公開されるため、tarball の取得元がこのリポジトリであることを検証できます。

npm audit signatures

CaseMargin について

CaseMargin は、生のサポートチケットを構造化されたケース概要に変換し、次のエージェントが数分ではなく数秒で状況を把握できるようにします。ウェブアプリ、Zendesk 連携、無料のエスカレーション準備スコアツールは casemargin.com でご利用いただけます。