Vantage Movers MCP

Удалённый сервер Model Context Protocol, позволяющий агентам использовать бэкенд Granot / Vantage и выпонять запросы к MogoDB Atlas из одного места.

Размещён на Vercel с помощью mcp-handler v2 и Next.js. Это теущий поддерживаемый Vercel путь: Streamable HTTP и спецификация MCP от 2026-07-28, без Redis и без долгоживущего процесса stdio.

Зачем эта библиотека

Related MCP server: MongoDB MCP Server

Требуемая конфигурация MCP

VANTAGE_API_SECRET обязателен в конфигурации клиента. Сервер передаёт это значение в заголовке x-api-secret, когда вызывает https://vantage-vers-mains-server.vercel.app.

Streamable HTTP в стиле Cursor / Claude:

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

x-api-secret также принимается, если клиент предпочитает имя заголовка Vantage:

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

Не помещайте секрет в env для удалённого URL. HTTP MCP-клиенты отправляют только headers. env предназначен для локальных stdio-серверов.

В продакшене VANTAGE_API_SECRET также хранится на проекте Vercel, чтобы публичный URL не мог открыть Mogo с поддельным токеном. Значение клиента должно совпадать.

MogoDB

Официальный MogoDB MCP-сервер работает через stdio. В этом развёртывании выделенный интерфейс Mogo работает внутри процесса:

• mongo_list_databases

• mongo_list_collections

• mongo_collection_schema

• mongo_collection_indexes

• mongo_find

• mongo_aggregate

• mongo_count

• mongo_db_stats

Только чтение. $out и $merge отклоняются. База данных по умолчанию — vantagemovers (или testvantagemovers при TEST_MODE=true).

Для записи Form / Call Lead используйте инструменты лидов. Сырые мутации Mogo пропустят 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

Переменные окружения