Vantage Movers MCP

에이전트가 Granot / Vantage 백엔드를 사용하고 MongoDB Atlas를 한곳에서 쿼리할 수 있도록 해주는 원격 Model Context Protocol 서버입니다.

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 서버용입니다.

프로덕션 환경도 Vercel 프로젝트에 VANTAGE_API_SECRET을 저장하므로 공개 URL에서 임의의 토큰으로 Mongo를 열 수 없습니다. 클라이언트 값은 일치해야 합니다.

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 쓰기에는 리드 도구를 사용하세요. 원시 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

환경