Vantage Movers MCP

Remote Model Context Protocol Server, damit Agenten das Granot-/Vantage-Backend nutzen und MongoDB Atlas von einem Ort aus abfragen können.

Gehostet auf Vercel mit mcp-handler v2 und Next.js. Das ist der aktuell von Vercel unterstützte Weg: Streamable HTTP plus die 2026-07-28-MCP-Spezifikation, kein Redis, kein langlebiger stdio-Prozess.

Warum diese Bibliothek

Related MCP server: MongoDB MCP Server

Erforderliche MCP-Konfiguration

VANTAGE_API_SECRET ist in der Client-Konfiguration erforderlich. Der Server setzt diesen Wert beim Aufruf von https://vantage-movers-main-server.vercel.app in den x-api-secret-Header.

Streamable HTTP im Cursor-/Claude-Stil:

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

x-api-secret wird ebenfalls akzeptiert, wenn ein Client den Vantage-Header-Namen bevorzugt:

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

Legen Sie das Secret bei einer Remote-URL nicht in env ab. HTTP-MCP-Clients senden nur headers. env ist für lokale stdio-Server.

Außerdem speichert die Produktion VANTAGE_API_SECRET im Vercel-Projekt, damit eine öffentliche URL nicht mit einem erfundenen Token auf Mongo zugreifen kann. Der Client-Wert muss übereinstimmen.

MongoDB

Der offizielle MongoDB-MCP-Server ist ein stdio-Server. Dieses Deployment stellt eine dedizierte Mongo-Oberfläche prozessintern bereit:

• mongo_list_databases

• mongo_list_collections

• mongo_collection_schema

• mongo_collection_indexes

• mongo_find

• mongo_aggregate

• mongo_count

• mongo_db_stats

Schreibgeschützt. $out und $merge werden abgelehnt. Standarddatenbank ist vantagemovers (oder testvantagemovers, wenn TEST_MODE=true).

Verwenden Sie für Form-/Call-Lead-Schreibvorgänge die Lead-Tools. Rohe Mongo-Mutationen würden Sheet Sync und CRM-Posting überspringen.

Erste Tool-Gruppe

Spätere Tool-Gruppen: Granot-Syncs, Owner-Registry-Einträge, Buchungsfälle.

Lokal

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

MCP-URL lokal: http://localhost:3100/api/mcp

Umgebung