CarsXE

🚗 CarsXE MCP サーバー

CarsXE から車両データを照会・分析する、モジュール式で拡張可能な Model Context Protocol（MCP）サーバーです。LLM やチャットボット向けに、見やすくチャットに適した Markdown 形式で出力します。

製品

• 車両履歴
• 車両ナンバープレートデコーダー
• 車両仕様
• 国際 VIN デコーダー
• 車両画像
• 車両リコール
• 車両市場価値

---

ℹ️ CarsXE MCP サーバーとは？

CarsXE MCP サーバーは、CarsXE から包括的な車両データを照会するためのツール一式を提供する Node.js/TypeScript アプリケーションです。LLM（Anthropic Claude、OpenAI GPT など）、チャットボット、開発者ツールとのシームレスな統合を目的としており、次の機能を提供します。

• 🧩 CarsXE の各エンドポイントに対応した明快なモジュール式コード
• 📝 チャット／LLM 環境向けの一貫した Markdown 形式の出力
• 🛡️ 堅牢なエラー処理とユーザーフレンドリーなメッセージ
• 🔌 新しいエンドポイントや機能を簡単に拡張可能

---

💡 MCP で CarsXE を使う理由

MCP を介して CarsXE を AI エディターやチャットクライアントに接続すると、いつも使っているツールの中で、車両データをさらに活用できます。

メリット	説明
自然な英語で質問	API のエンドポイントやパラメーターを知る必要はありません。知りたいことを説明するだけです
コンテキストを踏まえた回答	AI がリアルタイムの車両データと質問を組み合わせ、ニーズに合わせた実用的な回答を生成します
タブの切り替え不要	エディターやチャットから離れずに、VIN の仕様、履歴、リコール、市場価値を確認できます
リクエストを簡単につなげられる	ナンバープレートをデコード → 詳細な仕様を取得 → リコールを確認 → 市場価値を取得。すべて一つの会話で完結します
常に最新のデータ	すべてのクエリは CarsXE API にリアルタイムで送信されるため、古いキャッシュや更新前の結果はありません
お使いのエディターで動作	Claude Desktop、Cursor、VS Code、Windsurf、および MCP 互換のすべてのクライアント

---

✨ 機能

• 🤖 Anthropic Claude を使用し、API データとユーザーのクエリに基づいて包括的かつ専門的な回答を生成します
• 🚙 車両仕様、履歴、画像、リコール、市場価値などを照会できます
• 🏷️ ナンバープレートと国際 VINをデコードできます（画像からの OCR にも対応）
• 🛠️ OBD（オンボード診断）コードをデコードできます
• 🎨 すべてのエンドポイントが、見やすくグループ化された絵文字付き Markdown を返します
• 🧩 ChatGPT／MCP Apps のホストは、専用のレンダリングツールを使って車両、市場価値、リコールのカードを表示できます
• 🧑‍💻 保守性を高めるため、型、API ロジック、フォーマッターを分離したモジュール式コードです
• 🧪 簡単に実行、テスト、拡張できます

---

⚙️ 前提条件

CarsXE API キー（こちらから取得）

---

🖥️ エディター別のインストール

すべてのエディターで同じリモート MCP エンドポイントを使用します。以下の各設定で、YOUR_API_KEY を実際の CarsXE API キーに置き換えてください。

---

Cursor Marketplace / Grok Bot

一覧表示後、Cursor Marketplace から CarsXE をインストールします（Grok Bot でも同じカタログを使用します）。次に、Plugins → Configure を開き、CarsXE developer dashboard で CARSXE_API_KEY を設定します。実際のキーをリポジトリにコミットしたり、貼り付けたりしないでください。

以下の Cursor ディープリンクも、代替手段として引き続き利用できます。

---

Claude Desktop

1️⃣ Claude Desktop をダウンロードしてインストールする

• 公式の Claude Desktop ダウンロードページ にアクセスします
• お使いのオペレーティングシステム（macOS、Windows、または Linux）用のインストーラーをダウンロードします
• 画面の指示に従って Claude Desktop をインストールします

2️⃣ CarsXE MCP サーバーを使用するよう Claude Desktop を設定する

a. Claude Desktop の設定を開く

• Claude Desktop アプリを起動します
• メニューバーの Claude をクリックします
• Settings を選択します
• Settings ウィンドウで Developer タブを開きます（スクロールするか、詳細オプションを展開する必要がある場合があります）
• Edit Config（または Open Config File）をクリックします

b. 設定ファイルを編集する

• 既定のテキストエディターで claude_desktop_config.json ファイルが開きます。

• "mcpServers" セクションを探します。存在しない場合は、以下のように追加します。

• CarsXE の以下のエントリを追加または更新します。

  "mcpServers": {
    "carsxe": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.carsxe.com/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  },
  

• YOUR_API_KEY を実際の CarsXE API キーに置き換えます

• ヒント： 複数の MCP サーバーを使用する場合は、"mcpServers" の下に複数追加できます。

• 設定ファイルを保存し、エディターを閉じます。

c. Claude Desktop を再起動する

• 新しい設定を適用するには、Claude Desktop アプリを終了して再起動します。

  変更が反映されるまで、少し時間がかかる場合があります。

3️⃣ CarsXE MCP サーバーが利用可能であることを確認する

• 再起動後、Claude Desktop を開きます。
• ツールまたはプラグインのセクションを開きます（通常は検索バー内、またはツールメニューの下にあります）。
• 利用可能な MCP サーバー／ツールとして CarsXE が表示されているはずです。
• CarsXE ツール（例：get_vehicle_specs）を実行して、正常に動作することを確認します。

  API キーが有効なサブスクリプションに紐づいている場合にのみ動作します。

---

Cursor

マーケットプレイスの掲載がまだ利用できない場合の代替手段です。

CarsXE MCP を Cursor にインストール

以下の値があらかじめ入力された状態で、インストールダイアログが開きます。

フィールド	値
Name	CarsXE
Type	streamableHttp
URL	https://mcp.carsxe.com/mcp
Header	X-API-Key: YOUR_API_KEY

YOUR_API_KEY を実際の CarsXE API キー に置き換え、Install をクリックします。

---

Visual Studio Code（GitHub Copilot）

CarsXE MCP を VS Code にインストール

インストールをクリックした後、API キーを手動で追加する必要があります。

1. Command Palette（Ctrl+Shift+P / Cmd+Shift+P）を開きます
2. MCP: List Servers を実行します
3. リストから CarsXE を探してクリックします
4. Show Configuration をクリックします
5. YOUR_API_KEY を実際の CarsXE API キー に置き換えます。

   "CarsXE": {
     "type": "http",
     "url": "https://mcp.carsxe.com/mcp",
     "headers": {
       "X-API-Key": "YOUR_ACTUAL_KEY_HERE"
     }
   }

6. ファイルを保存します。VS Code が自動的に接続します。

注： GitHub Copilot 拡張機能がインストールされ、エージェントモード（VS Code の設定にある chat.agent.enabled）が有効になっていることを確認してください。

---

Windsurf

1️⃣ MCP の設定を開く

• Windsurf Settings → MCP に移動します（または Ctrl+, を押して MCP を検索します）
• "Edit Config" をクリックして ~/.codeium/windsurf/mcp_config.json を開きます

2️⃣ CarsXE サーバーを追加する

{
  "mcpServers": {
    "carsxe": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.carsxe.com/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

3️⃣ Windsurf を再起動する

ウィンドウを再読み込みするか、Windsurf を再起動します。Cascade チャットパネルを開くと、CarsXE ツールが自動的に表示されます。

---

その他のエディター（手動／汎用）

その他の MCP 対応クライアントでは、次の情報を使ってリモート MCP サーバーを登録します。

• エンドポイント： https://mcp.carsxe.com/mcp
• トランスポート： HTTP（Streamable HTTP）
• 認証ヘッダー： X-API-Key: YOUR_API_KEY

正確な設定形式については、お使いのエディターの MCP ドキュメントを参照してください。

---

🖼️ ChatGPT / MCP Apps UI（データ → 描画）

MCP Apps を実装するホスト（ChatGPT を含む）では、車両カードをインライン表示できます。CarsXE では、取得ツールをデータツールとして維持し、専用の描画ツールからのみ UI をマウントするため、ChatGPT は検索のたびに iframe を再マウントしません。

推奨される呼び出しフロー：

1. データツール（get_vehicle_specs、get_market_value、または get_vehicle_recalls）を呼び出します。Markdown と structuredContent が返されます — _meta.ui.resourceUri は含まれません。
2. モデルは、その構造化された結果を調整できます。
3. 一致する描画ツール（render_vehicle_card、render_market_value、または render_recalls）を、それらのフィールドとともに呼び出します。
4. ホストが ui://carsxe/… HTML リソース（text/html;profile=mcp-app）を読み込み、カードを一度だけ描画します。

カードでは、@carsxe/design-system の公開トークン（--primary #065774、--background #F9F9F9、--card #FFFFFF、角丸の 2xl クローム）と、公式の Logo アセット https://ui.carsxe.com/logo-light.png / logo-dark.png を使用します。

認証方法に変更はありません。MCP では引き続き API キーまたは OAuth が必要です。x402 は引き続き REST のみです。

カードをローカルでプレビューする（API キー不要、モックデータを使用）：

npm run preview:ui

次に、ブラウザーで previews/vehicle-card.html、previews/market-value.html、previews/recalls.html を開きます。

---

🛠️ 利用可能なツールとプロンプト例

以下は、利用可能なすべての CarsXE ツールとそのパラメーター、およびプロンプト例の一覧です。これらのプロンプトは、MCP に接続された任意のクライアントで使用できます。

1. get_vehicle_specs 🚙

• 説明： VIN による車両の包括的な仕様を取得します（車両仕様）

• パラメーター：

  • vin（string、必須）：17 文字の車両識別番号

• プロンプト例：

  VIN WBAFR7C57CC811956 の詳細な仕様を教えてください。

  これは V6 ですか、それとも V8 ですか？ VIN：WBAFR7C57CC811956

  WBAFR7C57CC811956 のトリムレベルを教えてください。

• 出力： Markdown 形式の車両仕様（年式、メーカー、モデル、エンジン、寸法、色、装備など）

---

2. decode_license_plate 🏷️

• 説明： 車両のナンバープレートをデコードして、VIN と基本情報を取得します（車両ナンバープレートデコーダー）

• パラメーター：

  • plate（string、必須）：ナンバープレート番号
  • state（string、任意）：州の略称（例：CA）
  • country（string、必須、デフォルト：US）：国コード

• プロンプト例：

  カリフォルニア州でナンバープレート 7XER187 が付いている車は何ですか？

  ナンバープレート 7XER187、州 CA をデコードしてください

  テキサス州でナンバープレート ABC1234 を検索してください

• 出力： デコードした車両情報（VIN、メーカー、モデル、年式など）の Markdown 要約

---

3. decode_international_vin 🌍

• 説明： 国際 VIN をデコードして詳細情報を取得します（国際 VIN デコーダー）

• パラメーター：

  • vin（string、必須）：17 文字の VIN

• プロンプト例：

  このヨーロッパの VIN をデコードしてください：WF0MXXGBWM8R43240

  WAUZZZ8K9AA123456 は何の車ですか？ドイツの VIN です。

• 出力： 国際車両の詳細（メーカー、仕様、排出量など）を記載した Markdown

---

4. get_market_value 💰

• 説明： VIN から車両の推定市場価値を取得します（車両の市場価値）

• パラメーター：

  • vin（string、必須）：17 文字の VIN
  • state（string、任意）：米国の州の略称
  • mileage（number、任意）：市場価値の調整に使用する車両の現在の走行距離
  • condition（string、任意）：車両の全体的な状態 — excellent、clean、average、または rough

• プロンプトの例：

  WBAFR7C57CC811956 の価値はいくらですか？

  VIN WBAFR7C57CC811956 の車を買おうと思っています。適正価格はいくらですか？

  フロリダ州で、走行距離 45,000 マイル、状態が良好な WBAFR7C57CC811956 の下取り価格はいくらですか？

• 出力： 市場価値の内訳（小売価格、下取り価格、希望小売価格など）を含む Markdown

---

5. get_vehicle_history 🕓

• 説明： VIN から包括的な車両履歴レポートを取得します（車両履歴）

• パラメーター：

  • vin（string、必須）：17 文字の VIN
  • format（string、任意）：応答形式（json または xml）

• プロンプトの例：

  WBAFR7C57CC811956 は事故歴がありますか？

  VIN WBAFR7C57CC811956 の全履歴を表示してください

  WBAFR7C57CC811956 はこれまで何人の所有者がいましたか？

• 出力： 履歴記録（廃車／サルベージ、保険、ブランド、タイトル、走行距離計など）を含む Markdown

---

6. get_vehicle_images 🖼️

• 説明： メーカー、モデル、フィルターを指定して車両画像を取得します（車両画像）

• パラメーター：

  • make（string、必須）
  • model（string、必須）
  • year、trim、color、transparent、angle、photoType、size、license、format（すべて任意）

• プロンプトの例：

  青い 2018 年式 Toyota Tacoma の写真を表示してください

  赤い 2022 年式 Ford Mustang GT の画像を取得してください

  白い 2020 年式 Tesla Model 3 はどのような外観ですか？

• 出力： 最大 5 枚の画像（リンク、サムネイル、詳細）を含む Markdown

---

7. get_vehicle_recalls 🚨

• 説明： VIN から車両のリコール情報を取得します（車両のリコール）

• パラメーター：

  • vin（string、必須）：17 文字の VIN

• プロンプトの例：

  1C4JJXR64PW696340 に未対応のリコールはありますか？

  VIN 1C4JJXR64PW696340 の車を買ったばかりですが、リコールについて心配すべきですか？

  WBAFR7C57CC811956 の安全上のリコールを確認してください

• 出力： リコールの詳細（日付、説明、リスク、対処方法、ステータスなど）を含む Markdown

---

8. read_license_plate_from_image 🏷️

• 説明： 車両画像の URL からナンバープレートを認識して抽出します（車両ナンバープレートデコーダー）

• パラメーター：

  • imageUrl（string、必須）：車両のナンバープレート画像への直接 URL

• プロンプトの例：

  この画像のナンバープレート番号は何ですか？ https://imagedelivery.net/moyiiSImjJPI_EZVxNMBBw/f49aed53-d736-4370-f3f4-97418841c800/public

  この写真からナンバープレートを読み取ってください：[image URL]

• 出力： 検出されたナンバープレート、信頼度スコア、バウンディングボックス、車両タイプなどを含む Markdown

---

9. extract_vin_from_image 🔍

• 説明： OCR を使用して車両画像から VIN を抽出します

• パラメーター：

  • imageUrl（string、必須）：車両の VIN 画像への直接 URL

• プロンプトの例：

  この画像から VIN を抽出してください：https://user-images.githubusercontent.com/5663423/30922082-64edb4fa-a3a8-11e7-873e-3fbcdce8ea3a.png

  この写真の VIN は何ですか？ https://res.cloudinary.com/carsxe/image/upload/q_auto/f_auto/v1713204144/base/images/vin-ocr/vin.jpg

• 出力： 検出された VIN、信頼度、バウンディングボックス、候補を含む Markdown

---

10. get_year_make_model 📅

• Description: 年式、メーカー、モデル、任意のトリムから包括的な車両情報を取得します（車両仕様）

• Parameters:

  • year (string, required)
  • make (string, required)
  • model (string, required)
  • trim (string, optional)

• Example Prompts:

  2020年式のToyota Camryの仕様を教えてください。

  2019年式のHonda Civic Sportトリムについて教えてください。

  2021年式のFord F-150にはどのような色がありましたか？

• Output: 車両の詳細、色、機能、オプション、パッケージを含むMarkdown

---

11. decode_obd_code 🛠️

• Description: OBDコードを解読し、診断情報を取得します

• Parameters:

  • code (string, required): OBDコード（例：P0115）

• Example Prompts:

  エンジン警告灯が点灯していて、コードがP0115と表示されます。どういう意味ですか？

  OBDコードP0300を解読してください。

  ダッシュボードにC1234コードが表示されています。深刻な問題ですか？

• Output: コード、診断、日付を含むMarkdown

---

12. check_lien_and_theft 🔒

• Description: VINから車両の担保権および盗難情報を取得します

• Parameters:

  • vin (string, required): 17文字の車両識別番号

• Example Prompts:

  WBAFR7C57CC811956に担保権は設定されていますか？

  VINがWBAFR7C57CC811956の中古車を購入しようとしています。盗難車かどうか確認してください。

  WBAFR7C57CC811956の所有権に問題がないか確認してください。

• Output: 担保権者情報、盗難記録、回収日、ステータスを含むMarkdown

---

13. get_recalls_by_ymm 🚨

• Description: 年式、メーカー、モデルから安全リコール情報を取得します（VINは不要です）（車両リコール）

• Parameters:

  • year (string, required): 4桁のモデル年
  • make (string, required)
  • model (string, required)

• Example Prompts:

  2026年式のToyota Corollaにリコールはありますか？

  2019年式のHonda Civicの安全リコールを確認してください。

  2020年式のFord F-150に影響するリコールは何ですか？

• Output: NHTSAのキャンペーン番号、対象部品、リスク、対処方法を含むMarkdown

---

14. submit_recalls_batch 📦

• Description: 最大10,000件のVINを対象とする非同期の一括リコールチェックを送信します（車両リコール）

• Parameters:

  • vins (string[] or comma-separated string, optional)
  • csv (string, optional): VINを含むインラインCSV
  • csvUrl (string, optional): VINを含むCSVのHTTPS URL
  • webhookUrl (string, optional): バッチ完了時のHTTPSウェブフック

• Example Prompts:

  VIN 1HGBH41JXMN109186、5YJSA1E26HF000001、1C4JJXR64PW696340のリコールチェックを一括送信してください。

  次のCSV URLから一括リコールチェックを開始してください：https://example.com/vins.csv

• Output: batchIdとステータスを含むMarkdown。次にget_recalls_batch_statusをポーリングしてください。

---

15. get_recalls_batch_status 📦

• Description: 以前に送信したリコールチェックバッチのステータスを確認します（車両リコール）

• Parameters:

  • batchId (string, required)

• Example Prompts:

  リコールチェックバッチbrb_mnablbn7_wvbaqvのステータスを教えてください。

• Output: ステータス、処理済みVIN数、ヒット率を含むMarkdown

---

16. get_recalls_batch_results 📦

• Description: 完了した一括リコールチェックの結果をJSON形式で取得します（ステータスがcompletedまたはpartialの場合）（車両リコール）

• Parameters:

  • batchId (string, required)

• Example Prompts:

  バッチbrb_mnablbn7_wvbaqvのリコール結果を取得してください。

• Output: VINごとのMarkdown要約（大規模なバッチでは省略されます）

---

17. download_recalls_batch 📦

• Description: 完了した一括リコールチェックの結果をCSV形式でダウンロードします（車両リコール）

• Parameters:

  • batchId (string, required)

• Example Prompts:

  リコールチェックバッチbrb_mnablbn7_wvbaqvのCSVをダウンロードしてください。

• Output: CSVのMarkdownプレビュー

---

18. get_ymm_options 📋

• 説明： ドロップダウン向けに、年式、メーカー、モデル、トリム、またはバリアントの連動する選択肢を一覧表示します（車両仕様）

• パラメーター：

  • dimension（string、任意）：years | makes | models | trims | variants
  • year、make、model、trim（すべて任意のフィルター）

• プロンプトの例：

  CarsXE には何年式の車両データがありますか？

  Toyota のモデルを一覧表示してください

  2026 年に販売されていた Tacoma のバリアントは何ですか？

• 出力： 推定または指定された項目の Markdown リスト

---

19. get_ownership_by_vin 👤

• 説明： エンタープライズ — VIN から登録所有者を検索します

• パラメーター：

  • vin（string、必須）：17 文字の VIN
  • include（string、任意）：demographics,emails,phones,vehicle_history

• プロンプトの例：

  VIN 1FT8X3BT0BEA61538 の登録所有者は誰ですか？

• 出力： 所有者、連絡先情報、人口統計情報、車両履歴を含む Markdown。所有者のレコードごとに課金されます。

---

20. get_ownership_by_person 👤

• 説明： エンタープライズ — 氏名、番地、ZIP コードから人物を検索します

• パラメーター：

  • firstName、lastName、address、zip（必須）
  • include（string、任意）

• プロンプトの例：

  ZIP コード 90210、123 Example St の John Sample を検索してください

• 出力： 一致した人物、連絡先情報、関連付けられた車両を含む Markdown

---

21. get_ownership_by_address 👤

• 説明： エンタープライズ — 番地と ZIP コードから居住者を検索します

• パラメーター：

  • address、zip（必須）
  • include、variant（任意。include を優先してください）

• プロンプトの例：

  ZIP コード 90210 の 123 Example St には誰が住んでいますか？

• 出力： 居住者と関連付けられた車両を含む Markdown

---

22. get_ownership_by_zip 👤

• 説明： エンタープライズ — 任意のフィルターを指定して、5 桁の ZIP コードから人物を検索します

• パラメーター：

  • zip（string、必須）
  • gender、minAge、maxAge、income、page、limit、include、variant（任意）

• プロンプトの例：

  ZIP コード 90210 で 45 歳以上の人物を検索してください

  ZIP コード 49646 で所得コード F の女性を検索してください

• 出力： 条件に一致するレコードの Markdown ページ。返されるレコードごとに課金されます（デフォルトの上限は 15、最大 100）。

---

23. render_vehicle_card 🖼️

• 説明： VIN の識別情報と主要仕様を含むビジュアルカードを表示します。必ず最初に get_vehicle_specs を呼び出し、その structuredContent を渡してください。（車両仕様）

• パラメーター： vin（必須）と、任意の year、make、model、trim、style、engine、transmission、drivetrain、fuel、MPG、seating、MSRP、built-in country

• プロンプトの例：

  VIN WBAFR7C57CC811956 の仕様を取得してから、車両カードを表示してください。

• 出力： MCP Apps / ChatGPT の iframe カード。テキストのフォールバックでは車両の概要を表示します。

---

24. render_market_value 🖼️

• 説明： 小売価格と下取り価格の範囲を表示します。必ず最初に get_market_value を呼び出し、その structuredContent を渡してください。（車両の市場価値）

• プロンプトの例：

  VIN WBAFR7C57CC811956 のカリフォルニア州での価値はいくらですか？その後、市場価値カードを表示してください。

• 出力： MCP Apps / ChatGPT の iframe カード。テキストのフォールバックでは査定額の概要を表示します。

---

25. render_recalls 🖼️

• 説明： 未解決のリコール一覧を表示します。必ず最初に get_vehicle_recalls を呼び出し、その structuredContent を渡してください。（車両のリコール）

• プロンプトの例：

  VIN 1C4JJXR64PW696340 のリコールを確認して、リコールカードを表示してください。

• 出力： MCP Apps / ChatGPT の iframe カード。テキストのフォールバックではリコール件数を表示します。

---

🔗 ツールの連鎖 — 上級者向けの例

CarsXE MCP の真価は、1 回の会話でツールを連鎖させることで発揮されます。

シナリオ 1 — 購入前のデューデリジェンス：

1. カリフォルニア州でナンバープレート 7XER187 をデコードしてください

2. その車両の詳細な履歴を取得してください

3. 未対応のリコールはありますか？

4. 今日購入する場合、いくらの価値がありますか？

シナリオ 2 — 路上で見かけた車：

1. この画像からナンバープレートを読み取ってください：[写真 URL]

2. テキサス州でそのナンバープレートを検索してください

3. その車種の写真を表示してください

シナリオ 3 — 整備士／サービスショップ：

1. ダッシュボードの写真からこの VIN をデコードしてください：[画像 URL]

2. 詳細な仕様を取得してください

3. 顧客によるとエンジンチェックコードは P0300 とのことです。この車両ではどのような意味ですか？

シナリオ 4 — VIN を使わずに車両群のリコールを確認：

1. 2020 年の Toyota モデルを一覧表示してください

2. 2020 年の Toyota Camry のリコールを確認してください

3. 次の在庫 VIN のリコール一括処理を送信してください：[リスト]

4. 一括処理のステータスを確認してから、結果を表示してください

---

🔐 OAuth 2.1（Claude.ai カスタムコネクター）

ホスト型サーバー https://mcp.carsxe.com/mcp は、次の 2 種類の認証方式に対応しています。

1. API キー（変更なし）— X-API-Key ヘッダー、Authorization: Bearer <api-key>、または ?key= クエリパラメーターを使用します。Claude Desktop／mcp-remote およびローカルクライアントで使用します。
2. OAuth 2.1 — Claude.ai カスタムコネクターなどのホスト型 MCP クライアントで使用します。Claude.ai で Connect をクリックすると、標準的な Authorization Code + PKCE フローが実行されます。これには、動的クライアント登録（RFC 7591）、CarsXE の同意ページでのブラウザーサインイン、その後のトークン交換が含まれます。アクセストークン（mcp_at_*、1 時間）はユーザーの CarsXE API キーに対応し、リフレッシュトークン（mcp_rt_*、90 日）は更新のたびにローテーションされます。

認証情報なしでリクエストすると、WWW-Authenticate チャレンジを含む 401 が返されます。これにより、Claude.ai はフローを開始します。

環境変数

変数	デフォルト値	用途
OAUTH_ISSUER	https://mcp.carsxe.com	ディスカバリーメタデータ内の Issuer／エンドポイントのベース
OAUTH_WEB_BASE	https://api.carsxe.com	OAuth ロジックをホストする CarsXE ウェブアプリ
MCP_OAUTH_INTERNAL_SECRET	(未設定)	ホスト環境で設定し、コミットしないでください。未設定の場合、OAuth ベアラートークンは拒否されますが、API キー認証は引き続き機能します。

Cloudflare Workers のデプロイ（src/index.ts）では OAuth サーフェスは提供されません。提供するのは、mcp.carsxe.com の背後にある GCP Cloud Run のデプロイ（src/index.gcp.ts）のみです。