CarKeeper ChatGPT MCP 연동

이 프로젝트는 ChatGPT를 실시간 CarKeeper 리포트 엔진에 연결합니다.

노출하는 기능

• check_vehicle — 차량 등록 번호에 대해 실제 CarKeeper 엔진을 실행합니다.

• analyse_purchase — 가격, 광고 문구 및 선택 이미지가 포함된 전체 CarKeeper 구매 리포트를 실행합니다.

• compare_vehicles — 2~5대 차량에 CarKeeper를 실험하여 실시간 리포트가 반환한 Buyer Score를 기준으로 순위를 매깁니다.

• start_full_report_checkout — 기존 £9.99 CarKeeper WooCommerce 체크아웃을 생성하는 선택적/비공개 도구입니다.

• get_report — 기존 유료 리포트의 상태/본문을 읽은 선택적/비공개 도구입니다.

커머스 도구는 기본적으로 비활성화되어 있고, 현재 공개 Plugin Directory 양식에서는 디지털 상품 커머스가 지원되지 않습니다. 이 도구들은 비공개 테스트 목적으로 Developer Mode에서 활성화할 수 있습니다.

Related MCP server: Vehicle Database MCP Server

아키텍처

ChatGPT -> MCP server -> CarKeeper Render 엔드포인트 보호 -> DVLA/DVSA/Check Car Details/웹/OpenAI

선택적 비공개 구매 경로: ChatGPT -> MCP server -> WordPress REST bridge -> 기존 WooCommerce 체크아웃/리포트 흐름

1. Render 리포트 엔진 패치

제공된 carkeeper-report-engine-plugin 버전의 백엔드를 사용하세요. 웹사이트용 /generate-report는 그대로 유지하고 다음을 추가합니다:

POST /plugin/generate-report

이 라우트에는 다음이 필요합니다.

Authorization: Bearer <CARKEEPER_PLUGIN_TOKEN>

Render 서비스 환경에 CARKEEPER_PLUGIN_TOKEN을 추가하세요.

2. 이 MCP 서버 구성

.env.example을 .env로 복사하고 동일한 CARKEEPER_PLUGIN_TOKEN 값을 설정하세요.

공개/플러그인 테스트에서는 다음과 같이 남겨 둡니다:

CARKEEPER_ENABLE_COMMERCE_TOOLS=false

3. 설치 및 실행

npm install
npm start

MCP 엔드포인트는 다음과 같습니다.

http://localhost:8787/mcp

4. 로컬 테스트

npx @modelcontextprotocol/inspector@latest

Streamable HTTP를 사용해 Inspector를 http://localhost:8787/mcp에 연결하세요.

5. ChatGPT Developer Mode에 연결

포트 8787을 HTTPS 터널(예: ngrok)로 명시하고 다음에 대해서:

https://YOUR-TUNNEL/mcp

앱의 MCP URL로 사용합니다.

선택사항: 기존 £9.99 체크아웃 흐름

carkeeper-chatgpt-api.php을 소규모 WordPress 플러그인으로 설치하세요. WordPress 설정의 안전한 위치에 다음 상수를 추가하세요.

define('CK_CHATGPT_API_TOKEN', 'a-long-random-secret');

MCP 서버에서 CARKEEPER_WP_API_TOKEN을 동일한 값으로 설정하고 다음을 설정하세요:

CARKEEPER_ENABLE_COMMERCE_TOOLS=true

비공개 Developer Mode 테스트에서만.

브리지는 기존 CarKeeper 리포트 생성, 체크아웃 토큰 복원, £99 9.99 WooCommerce 상품 및 유료 리포트 저장 등을 사용하며, 별도의 두 번째 결제 시스템을 만들지 않습니다.

보안

.env, OpenAI 키, Check Car Details 키, DVLA 키 또는 공유 플러그인 토큰을 커밋하지 마세요. 공유 토큰 두 가지 모두 길고 임의의 비밀값으로 생성하세요.