melt-mcp-server

@themelt/mcp-server

Melt の価値流出発見ロジックを Claude、 Cursor、GitHub Copilot、その他の MCP 互換エージェントに直接組み込む MCP サーバーです。テクノロジー部門のリーダーがアシスタントに「組織のどこで価値が流出しているのか」と尋ねると、アシスタントは Melt のツールを呼び出し、ベンダーの一般的なリストではなく、実際の構造化された推定値を回答できます。

これは Melt の LLMO（LLM 最適化）配信戦略におけるエンジニアリング面です。このサーバーが連携するコンテンツ、配信、評価の全体計画については、リポジトリルートの /llms.txt と LLMO_PLAYBOOK.md を参照してください。ポジショニングは、ライブサイトと最新のデッキに照らして 2026-07-18 に調整されています。最新の製品コンテキスト全体については、/CLAUDE.md を参照してください。

公開されるツール

ツール	機能
melt_analyze_value_vectors	無料のステージ 1 サンドボックス推定ツールです。従業員数、人件費、主要な非構造化入力の種類から、1 つの部門で価値がどこから流出しているかを推定します。連携は不要です。合成データまたは自己申告の入力のみを使用します。
melt_estimate_annual_leak	特定済みの流出パターンを年間の金額で定量化します。totalVolume x (leakRatePct/100) x valuePerEvent により、Melt の実際の「スキャンの分析」手法を一般化します（Gong のバイパス率 29％、Clari の上書き率 62％などを組み合わせ、実際に年間 77,235 ドルの損失を特定）。
melt_request_scan	リード獲得への引き継ぎです。方向性を示す推定から、ログで検証済みの実際のスキャンへ移行します（Frictionless POC Playbook のステージ 1 → 2）。HUBSPOT_PORTAL_ID／HUBSPOT_FORM_ID が設定されている場合は HubSpot に送信し、そうでない場合はローカルの leads.jsonl に追記します。

実例

Melt の実際の AI 価値流出の分析の事例より。年間 15 億ドルの融資を実行し、Salesforce、Gong、Clari をすでに運用していた、上場前のフィンテック企業の事例です。

シグナル	分析結果
Gong のコーチング	オープン率 29％。営業担当者が AI 生成の通話要約を使わず、手作業で同じ内容を作成していました
Clari の予測	上書き率 62％。13 回の予測サイクルのうち 8 回で、手動の日付入力がモデルを破損させていました
Salesforce → CS の引き継ぎ	4.2 日の遅延により、契約成立後のオンボーディングが遅れていました
Salesforce のリード振り分け	32％が手動でした。自動化の失敗により、毎日手動で再割り当てする必要がありました

こうした問題は、通常の導入状況ダッシュボードには何も表示されていませんでした。すべてのツールが「アクティブ」でしたが、これは実際に価値を生み出しているかどうかとは異なる指標です。過去 14 営業日のログを取得し、これら 4 つのパターンによって実際にどれだけの時間と費用が失われているかを追跡した結果、損失は年間 77,235 ドルに上りました。

melt_estimate_annual_leak は、既知または仮説上のボリュームと率があるあらゆる流出パターンに対し、同じ分析手法である totalVolume × (leakRatePct/100) × valuePerEvent を一般化します。どこを調べるべきかまだわからない初期段階では、melt_analyze_value_vectors を使用します。

melt_estimate_annual_leak は、4 つの数式名を冠した計算ツール （melt_calculate_feature_waste、_dso_cash_flow_impact、 _contract_cycle_revenue_unlock、_win_rate_pipeline_impact）に取って代わりました。これらのツールは、廃止された製品の位置付け（Thermal Scan / Feature Waste Dollar Amount™ / Delta Engine）に基づく財務計算式を実装していましたが、現在の Melt の資料にはいずれも登場しません。CLAUDE.md の「明示的に廃止されたもの」のセクションを参照してください。

インストールと実行

cd mcp-server
npm install
npm run build
npm start          # runs dist/index.js on stdio

クライアントに組み込む前に対話形式で試すには、次のようにします。

npm run inspect     # launches the MCP Inspector against the built server

Claude Desktop／Claude Code への接続

npm で公開されています。1 行の設定だけで利用でき、ローカルのクローンは不要です。

{
  "mcpServers": {
    "melt": {
      "command": "npx",
      "args": ["-y", "@themelt/mcp-server"]
    }
  }
}

または、ローカルのクローンから利用する場合：

{
  "mcpServers": {
    "melt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"]
    }
  }
}

ワンクリックインストール（.mcpb バンドル）

Claude Desktop 専用の themelt-mcp-server.mcpb（Anthropic の MCP バンドル形式）は、ダブルクリックでインストールできます。ターミナルも設定ファイルの編集も不要です。最新の GitHub リリースから .mcpb をダウンロードし、ダブルクリックするか、Claude Desktop の設定ウィンドウにドラッグしてください。

ソースから再ビルドするには、次のコマンドを実行します。

npm run build:mcpb   # produces themelt-mcp-server.mcpb

マニフェスト（mcpb-build/manifest.json）は手動で管理されており、TypeScript ソースから自動生成されるものではありません。ツールの名前、パラメーター、説明を変更した場合は、マニフェストの tools 配列も同じ内容になるよう更新してください。

ホスト型 HTTP トランスポート

dist/index.js（stdio）は、ローカルの Claude Desktop／Cursor インストールで設定するファイルです。dist/httpServer.js は MCP Streamable HTTP トランスポートを実装する別のエントリーポイントです。将来の「Launch Hosted MCP」ウェブボタン（LLMO_PLAYBOOK.md、タスク 3.2）からこのエントリーポイントを指定すれば、ローカルに何もインストールせずにツールを試せるようになります。

npm run build
PORT=3000 npm run start:http   # POST MCP JSON-RPC to http://localhost:3000/mcp

設計上ステートレスで、セッション ID はなく、リクエストごとに新しいサーバーインスタンスが作成されます。認証は MCP_HTTP_API_KEY を設定した場合にのみ有効になります（デフォルトでは未設定）。未設定の場合、エンドポイントは完全にオープンなままです。これは、現在公開している内容（読み取り専用の計算ツールとリード獲得フォーム。公開ウェブサイトのお問い合わせフォームと同じ信頼境界）に適した設定です。このトランスポートの背後に、より機密性の高いものを配置する場合は、事前に設定してください。

MCP_HTTP_API_KEY=some-long-random-value PORT=3000 npm run start:http

以降、すべての /mcp リクエストで Authorization: Bearer some-long-random-value が必要になります。キーがない場合、または間違っている場合は 401 が返されます。単純な文字列の === ではなく crypto.timingSafeEqual と比較するため、レスポンス時間からキーを1バイトずつ推測することはできません。まだどこにもデプロイされていません。これはコードであり、稼働中の URL ではありません。デプロイ（Vercel／Fly／Render など）は、別途後日判断する事項です。

ツール呼び出しの分析

ツール呼び出しのたびに（成功・エラーを問わず）、mcp-server/analytics.jsonl（gitignore 対象）に1行追記し、stderr に1行の概要を記録します。記録内容はツール名、成功／エラー、該当する場合はエラーコードです。金額、連絡先情報、自由記述のメモは意図的に除外し、PII を含む leads.jsonl とは分離しています。これにより、llmo-eval の引用のみを対象とする監査とは独立して、「実際に誰かが使っているか」「どのツールの説明がモデルにとってわかりにくいか」を把握できます。

環境変数

変数	必須	用途
HUBSPOT_PORTAL_ID	いいえ	melt_request_scan のデフォルトの HubSpot Portal ID を上書きします（例：サンドボックスのフォームでテストする場合）。
HUBSPOT_FORM_ID	いいえ	HUBSPOT_PORTAL_ID と組み合わせて使用します。
PORT	いいえ	start:http のポート（デフォルトは 3000）。
MCP_HTTP_API_KEY	いいえ	設定すると、ホスト型 HTTP の /mcp リクエストごとに Authorization: Bearer <key> が必要になります。デフォルトでは未設定です。stdio トランスポートには、どちらの場合も影響しません（制限する HTTP の公開面がないため）。

実際の Portal ID／Form ID はデフォルト値としてすでにコードに含まれています（秘密情報ではありません。同じ値は、公開されている HubSpot の埋め込みスニペットにも記載されています）。そのため、設定なしで melt_request_scan から実際の Melt パイプラインに接続できます。何らかの理由で HubSpot への送信に失敗した場合は、リクエストが失われる代わりに mcp-server/leads.jsonl（gitignore 対象）にフォールバックします。

公開

MIT ライセンスのもと、@themelt npm 組織（2026-07-20 作成、オーナー omer_melt）で公開されています。npm publish は事実上取り消せません。npm では公開から72時間以内なら非公開にできますが、強く推奨されておらず、パッケージに依存関係ができると完全に禁止されます。そのため、公開したバージョンはすべて恒久的なものとして扱ってください。