Vantage Movers MCP

リモートの Model Context Protocol サーバーで、エージェントが Granot / Vantage バックエンドを利用し、MongoDB Atlas を一元的に照会できるようにします。

Vercel 上で mcp-handler v2 と Next.js を使用してホストされています。これは現在 Vercel がサポートする方法です。Streamable HTTP と 2026-07-28 の MCP 仕様を使用し、Redis も長時間稼働する stdio プロセスも使いません。

このライブラリを選ぶ理由

Related MCP server: MongoDB MCP Server

必要な MCP 設定

クライアント設定では VANTAGE_API_SECRET が必須です。サーバーは https://vantage-movers-main-server.vercel.app を呼び出すときに、その値を x-api-secret ヘッダーに設定します。

Cursor / Claude スタイルの Streamable HTTP:

{
  "mcpServers": {
    "vantage-movers": {
      "url": "https://vantage-movers-mcp.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer <VANTAGE_API_SECRET>"
      }
    }
  }
}

クライアントが Vantage のヘッダー名を好む場合は、x-api-secret も受け付けられます。

{
  "mcpServers": {
    "vantage-movers": {
      "url": "https://vantage-movers-mcp.vercel.app/api/mcp",
      "headers": {
        "x-api-secret": "<VANTAGE_API_SECRET>"
      }
    }
  }
}

リモート URL の場合は、シークレットを env に設定しないでください。HTTP MCP クライアントは headers のみを送信します。env はローカルの stdio サーバー用です。

本番環境では、公開 URL が偽のトークンで Mongo を開けないように、Vercel プロジェクトにも VANTAGE_API_SECRET が保存されています。クライアントの値は一致している必要があります。

MongoDB

公式の MongoDB MCP サーバーは stdio です。このデプロイメントでは、専用の Mongo インターフェースをプロセス内に保持しています。

• mongo_list_databases

• mongo_list_collections

• mongo_collection_schema

• mongo_collection_indexes

• mongo_find

• mongo_aggregate

• mongo_count

• mongo_db_stats

読み取り専用です。$out と $merge は拒否されます。デフォルトのデータベースは vantagemovers です（TEST_MODE=true の場合は testvantagemovers）。

Form / Call Lead の書き込みには lead ツールを使用してください。生の Mongo 更新では、Sheet Sync と CRM への投稿がスキップされます。

最初のツールスライス

今後のスライス: Granot 同期、Owner Registry の項目、予約ケース。

ローカル

pnpm install
cp .env.example .env.local
# fill VANTAGE_API_SECRET and MONGO_URI
pnpm test
pnpm typecheck
pnpm dev

ローカルの MCP URL: http://localhost:3100/api/mcp

環境