Интеграция CarKeeper с ChatGPT и через MCP

Этот проект подключает ChatGPT к работему движку отчётов CarKeeper.

Что он предоставляет

• check_vehicle — запускет настоящий движок CarKeeper по рег номерному номеру автомобиля.

• analyse_purchase — запус кает полный отчёт CarKeeper о покупке с цен, текстом объявления и необязательными изображениями.

• compare_vehicles — запус кает CarKeeper для 2–5 автотомбилией и ранжирует их по метрике Buyer Score из реального ответа.

• start_full_report_checkout — необязательный/приватный инструмент, который создаёт существующий процесс оформлления заказа CarKeeper через WooCommerce за £9.99.

• get_report — необязательный/приватный инструмент, который считывает статус/текст существующего платного отчёта.

Инструменты коммерции отключены по умолчанию, потому что в текущей публичной форме Plugin Directory указано, что торговля цифровыми товарами не поддерживается. Их всё равно можно включить в режиме Developer Mode для приватного тестирования.

Related MCP server: Vehicle Database MCP Server

Архитектура

ChatGPT -> MCP-сервер -> защищённый эндпоинт CarKeeper на Render -> DVLA/DVSA/Check Car Details/web/OpenAI

Необязательный приватный путь покупки: ChatGPT -> MCP-сервер -> WordPress REST bridge -> существующий процесс оформления заказа и получения отчёта WooCommerce

1. Доработайте движок отчётов на Render

Используйте предоставленную версию бэкенда carkeeper-report-engine-plugin. Она оставляет /generate-report без изменений для сайта и добавляет:

POST /plugin/generate-report

Этот маршрут требует:

Authorization: Bearer <CARKEEPER_PLUGIN_TOKEN>

Добавьте CARKEEPER_PLUGIN_TOKEN в окружение сервиса Render.

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

Подключите Inspector к http://localhost:8787/mcp через Streamable HTTP.

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, восстановление checkout-токена, товар WooCommerce за £9.99 и хранение платных отчётов, а не создаёт вторую платёжную систему.

Безопасность

Никогда не коммитьте .env, ключи OpenAI, ключи Check Car Details, ключи DVLA и общие токены плагинов. Генерируйте длинные случайные секреты для обоих общих токенов.