AskMarcel HVAC Technical Knowledge

AskMarcel — HVAC 技術ナレッジ MCP サーバー

AI エージェント向けのメーカー提供 HVAC 技術ドキュメント：126 ブランド、905 モデルにわたる検索、診断、エラーコード、手順、製品資料。

AskMarcel はリモートのホスト型 MCP サーバー（Streamable HTTP）です。インストールもセルフホストも不要です。MCP クライアントをエンドポイントに接続して認証するだけです。このサーバーは AI エージェントをメーカーの実際のドキュメントにつなぎ、回答が推測ではなく、正確なマニュアルとページ番号を出典として示すようにします。

• エンドポイント： https://mcp.askmarcel.app
• レジストリ名： io.github.askmarcel/mcphvac
• マニフェスト： 1.3.1-beta.1 — 本番環境で15 個のツールが稼働中
• ドキュメントと API キー： https://app.askmarcel.app/developers
• リファレンス： https://app.askmarcel.app/developers/reference
• Marcel Inside（B2B API / MCP）： https://askmarcel.app/fr/connecteurs
• 無料の開発者プラン： 月 250 回の API 呼び出し

---

Marcel Inside — ボットの背後に組み込む

AskMarcel をMarcel Insideとして使用すれば、既存のチャットボット、ボイスボット、エージェントの背後にメーカー提供の HVAC ナレッジを組み込めます。スタックを再構築する必要はありません。ManyChat、ElevenLabs、Voiceflow、Intercom、Claude、ChatGPT、Gemini、カスタム MCP クライアントに対応しています。

• 営業とパイロット： https://askmarcel.app/fr/connecteurs（パイロット 490€、Business 月 149€・税抜）
• 開発者用サンドボックス： 無料プラン — 月 250 回、https://app.askmarcel.app/developers

---

AskMarcel を選ぶ理由

汎用 LLM は、冷媒充填量、エラーコードの意味、配線、故障ツリーなど、HVAC 固有の情報を推測します。AskMarcel は、インデックス化されたメーカー PDF に基づいてすべての回答を生成し、出典のページを返すため、現場の技術者やエージェントは回答を信頼し、検証できます。生の LLM 出力との精度比較については、HVAC-Benchをご覧ください。

• 126 ブランド · 905 モデル · 400,000 件以上のエラーコードをインデックス化
• 決定論的なエラーコード検索（推測ではありません）
• 厳密な SKU 出典追跡（resolve_model、get_model_coverage、diagnose_v2）— シリーズによる代替なし
• 出典付きの単発検索（diagnose）と、空気熱源式ヒートポンプ向けの複数ターン式ガイド付きトラブルシューティング（diagnose_guided）
• LIVE Beta Harness セッション — セッション開始時にメーカー DB を検索する、状態を保持する診断ループ（start_diagnostic … get_diagnostic_summary）
• FR / EN、欧州の HVAC/RACH 市場に特化

Harness セッションと diagnose_guided の比較

サーフェス	使用する場面	クォータ
Harness セッション（start_diagnostic …）	PAC Air/Eau または PAC Air/Air の複数ターンにわたる現場診断。仮説、識別に役立つ next_action、技術者の記録を含みます	セッション作成時に1回
diagnose_guided	PAC Air/Eau のみを対象とする従来のガイド付きループ — continuation によるサーバー封印済みの状態	ターンごと
diagnose_v2	1回の呼び出しで完了する厳密な SKU 検索	成功した呼び出しごと
diagnose	SKU の制限なしで行う1回の検索	成功した呼び出しごと

Harness Beta は本番環境で稼働中です（DIAGNOSTIC_SESSIONS_PUBLIC=true）。start_diagnostic では、サーバーが technical_error_codes（メーカー DB）でエラーコードを検索し、その結果を記録します。パックのフォールバックマップだけを参照するわけではありません。有効なパックは pac_air_eau と pac_air_air で、バージョンは**0.0.1**です（Beta 期間中に変更される可能性があります）。

---

ツール

サーバーは15個のツール（GA 10個 + Beta Harness セッション5個）を公開します。詳しいリファレンスは docs/tools.md をご覧ください。

GA（10個）

ツール	機能
search_technical_docs	技術文書をセマンティック検索します（抜粋は最大10件）。brand、model、error_code で絞り込めます。
get_procedure	chunk_id を指定して手順全体を取得します。
get_error_code	brand + error_code で確定的に検索します（model は任意）。
get_product_sheet	brand + model による製品シート（仕様、構成、頻出エラーコード）を取得します。
get_pdf_page_snapshot	PDF の特定ページへの署名付き5分間有効 URL を取得します（document_id + page）。
diagnose	症状またはエラーコードに基づき、出典付きで1回の検索を行います（抜粋 + 手順 + 引用）。
diagnose_v2	厳密な SKU の出典確認を伴う同じ検索です。承認済みの完全一致モデルのマニュアルがない場合は、回答を控えます（diagnostic: null）。
resolve_model	brand + model を正規 SKU に解決します。完全一致またはエイリアスのみが対象で、シリーズの LIKE 検索は行いません。
get_model_coverage	解決済み SKU の文書フラグ（exact_manual、error_code_covered、market_verified）を取得します。
diagnose_guided	空気-水ヒートポンプの複数ターンにわたるガイド付きトラブルシューティング（従来方式。クォータはターンごと）。

Beta — Harness セッション（5個）

ツール	機能
start_diagnostic	状態を保持する Harness セッションを開始します。開始時にメーカーのエラーコードを検索します。クォータは作成時に適用されます。
get_diagnostic	セッションの現在の投影（hypotheses、next_action、故障コード）を読み取ります。
respond_to_diagnostic	型付きの所見、測定値、または技術者による評価を追加します。
close_diagnostic	任意の理由を指定してセッションを終了します（検証は不要です）。
get_diagnostic_summary	セッションの記録から、確定的でエクスポート可能な要約を生成します。

安定性：beta · レスポンスの release_channel: beta · HVAC の有資格専門家が必要です。

---

クイックスタート

1. API キーを取得する

https://app.askmarcel.app/developers で無料のキーを作成してください（Developer プランでは月250回呼び出せます）。サーバーは OAuth 2.0（PKCE + Dynamic Client Registration）にも対応しており、認証を自動検出するクライアントでも使用できます。

2. MCP クライアントを接続する

すぐに使える設定ファイルは examples/ にあります。Streamable HTTP 対応の MCP クライアントで使用する一般的な形式は次のとおりです。

{
  "mcpServers": {
    "askmarcel": {
      "type": "streamable-http",
      "url": "https://mcp.askmarcel.app",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop / Cursor / VS Code： examples/ にある該当ファイルをご覧ください。YOUR_API_KEY をご自身のキーに置き換えてください。

3. 質問する

接続したら、次のように自然な言葉でプロンプトを入力してください。

「Daikin Altherma にエラー U4 が表示されています。これはどういう意味で、どうすれば解除できますか？」

エージェントが resolve_model / diagnose_v2（または get_error_code / diagnose）を呼び出し、原因、修正手順、参照したマニュアルのページを返します。完全一致するマニュアルがない場合は、明示的に回答を控えます。

ヒートポンプの現場診断を一連の流れで行うには、start_diagnostic → respond_to_diagnostic → close_diagnostic を使用してください（スキル hvac-harnais-session を参照）。

---

MCP と Chat API の違い

AskMarcel には、2 つの独立した統合インターフェースがあります。それぞれのプロトコルを混同しないでください。

インターフェース	エンドポイント	プロトコル	用途
MCP サーバー（このリポジトリ）	https://mcp.askmarcel.app	JSON-RPC Streamable HTTP（tools/call）	Claude、Cursor、VS Code、または任意の MCP クライアントを HVAC ツールに接続します
Chat API（ウェブ／モバイル／拡張機能）	https://app.askmarcel.app/api/chat	AI SDK v5 SSE（UIMessageStream）	ストリーミング、ツール、ドキュメントブロックに対応した完全な会話型 UI

MCP サーバーは AI SDK のチャットストリーム（text-delta、data-* パーツ）を使用しません。Vercel AI SDK でカスタムエージェントを構築する場合は、ウェブチャットのエンドポイントではなく、JSON-RPC 経由で MCP ツールを使用してください。

---

認証

次の 2 つの方法に対応しています（詳細は docs/authentication.md を参照してください）。

1. API キー（Bearer）： Authorization: Bearer YOUR_API_KEY
2. OAuth 2.0： 次の URL からディスカバリーを実行します https://mcp.askmarcel.app/.well-known/oauth-protected-resource

---

Claude Skills

skills/ フォルダーには、これらのツールを HVAC ワークフローに組み込んだ、すぐに使える Agent Skills が含まれています。

• hvac-error-lookup — メーカー名とエラーコードから、出典付きの説明と修理方法を提示します。
• hvac-diagnostic — 症状を一度の照会で調べ、引用を提示します（diagnose）。
• hvac-guided-diagnosis — 空気熱源ヒートポンプを対象に、複数ターンのガイド付きトラブルシューティングを行います（diagnose_guided）。
• hvac-harnais-session — Beta Harness のセッションループです（start_diagnostic … close_diagnostic）。

---

REST API SDK

REST API を直接呼び出すカスタムエージェント（MCP ではないもの）には、npm パッケージ @askmarcel/sdk を使用してください。Harness セッション用メソッド（startDiagnosticSession、respondToDiagnosticSession、…）、POST /v1/diagnostic/turn 用の guidedTurn()、さらに resolveModel()／getModelCoverage()／V2 diagnose が含まれています。

---

リンク

• MCP エンドポイント — https://mcp.askmarcel.app
• 開発者ポータルと API キー — https://app.askmarcel.app/developers
• API リファレンス — https://app.askmarcel.app/developers/reference
• Marcel Inside（B2B）— https://askmarcel.app/fr/connecteurs
• テンプレート — https://app.askmarcel.app/templates
• 公式 MCP レジストリ — io.github.askmarcel/mcphvac
• ウェブサイト — https://askmarcel.app

---

ライセンス

このリポジトリ内のコードとコンテンツ（ドキュメント、サンプル、スキル）は、MIT License の下で公開されています。AskMarcel のホスト型サービスとその基盤データはプロプライエタリであり、AskMarcel の利用規約が適用されます。

---

🇫🇷 フランス語

AskMarcel は、メーカーの出典に基づく HVAC/RACH 技術ドキュメントを AI エージェントに接続する、ホスト型のリモート MCP サーバー（Streamable HTTP）です。インストールは不要です。クライアントの MCP 接続先にエンドポイントを指定して認証するだけです。回答には推測ではなく、マニュアルと正確なページが記載されます。

• エンドポイント： https://mcp.askmarcel.app
• レジストリ名： io.github.askmarcel/mcphvac
• マニフェスト： 1.3.1-beta.1 — 本番環境で15 個のツール
• ドキュメントと API キー： https://app.askmarcel.app/developers
• Marcel Inside（B2B）： https://askmarcel.app/fr/connecteurs
• 無料 Developer ティア： 月 250 回の呼び出し
• カバレッジ： 126 ブランド · 905 モデル · 400,000 件以上のエラーコードをインデックス化

Marcel Inside — AskMarcel のデータベースを既存のチャットボット、ボイスボット、またはエージェントに接続できます。パイロット 490€ · Business 149€/月（税抜） · テスト用の無料 Developer ティア。

15 個のツール： GA 10 個（search_technical_docs、get_procedure、get_error_code、get_product_sheet、get_pdf_page_snapshot、diagnose、diagnose_v2、resolve_model、get_model_coverage、diagnose_guided）+ セッション型 Harnais Beta 5 個（start_diagnostic、get_diagnostic、respond_to_diagnostic、close_diagnostic、get_diagnostic_summary）。

Harnais Beta 稼働中： start_diagnostic 時にメーカー DB のルックアップ（technical_error_codes）を実行し、パック pac_air_eau / pac_air_air は 0.0.1、クォータが適用されるのはセッション作成時のみです。diagnose_guided（旧式のガイド付き PAC Air/Eau、ターンごとにクォータを適用）とは別の機能です。

スキル： エラーコードのルックアップ、単発診断、PAC のガイド付き診断、Harnais セッション — skills/ を参照してください。

REST SDK（npm）： @askmarcel/sdk — Harnais セッション + guidedTurn() + API v2。

クイック接続： https://app.askmarcel.app/developers でキーを作成し、examples/ フォルダーにある設定（Claude Desktop、Cursor、VS Code）のいずれかを使用してください。YOUR_API_KEY をご自身のキーに置き換えてください。

MCP と Chat API： このリポジトリでは MCP サーバー（mcp.askmarcel.app 上の JSON-RPC）について説明しています。Web／モバイルチャットでは別の API（/api/chat 上の SSE AI SDK v5）を使用します。この 2 つのプロトコルは相互に置き換えられません。

ツールの詳細：docs/tools.md · 認証：docs/authentication.md。