Integración de CarKeeper ChatGPT MCP

Este proyecto conecta ChatGPT con el motor de informes en vivo de CarKeeper.

Lo que expone

• check_vehicle — ejecuta el motor real de CarKeeper para una matrícula.

• analyse_purchase — ejecuta el informe de compra completo de CarKeeper con precio, texto del anuncio e imágenes opcionales.

• compare_vehicles — ejecuta CarKeeper sobre 2–5 coches y los clasifica por el Buyer Score devuelto por el informe en vivo.

• start_full_report_checkout — herramienta opcional/privada que crea el checkout existente de CarKeeper y WooCommerce por £9.99.

• get_report — herramienta opcional/privada que lee el estado/el texto de un informe de pago existente.

Las herramientas de comercio están desactivadas por defecto porque el formulario público actual del Plugin Directory indica que no se admite el comercio de bienes digitales. Aun así, se pueden habilitar en Developer Mode para pruebas privadas.

Related MCP server: Vehicle Database MCP Server

Arquitectura

ChatGPT -> MCP server -> protected CarKeeper Render endpoint -> DVLA/DVSA/Check Car Details/web/OpenAI

Ruta de compra privada opcional: ChatGPT -> MCP server -> puente REST de WordPress -> flujo existente de WooCommerce checkout/informe

1. Parchea el motor de informes de Render

Usa la versión del backend suministrada en carkeeper-report-engine-plugin. Mantiene /generate-report sin cambios para el sitio web y añade:

POST /plugin/generate-report

Esta ruta requiere:

Authorization: Bearer <CARKEEPER_PLUGIN_TOKEN>

Añade CARKEEPER_PLUGIN_TOKEN a las variables de entorno del servicio de Render.

2. Configura este servidor MCP

Copia .env.example a .env y establece el MISMO valor de CARKEEPER_PLUGIN_TOKEN.

Para pruebas públicas/de plugin, deja:

CARKEEPER_ENABLE_COMMERCE_TOOLS=false

3. Instala y ejecuta

npm install
npm start

El endpoint MCP es:

http://localhost:8787/mcp

4. Prueba localmente

npx @modelcontextprotocol/inspector@latest

Conecta Inspector a http://localhost:8787/mcp usando Streamable HTTP.

5. Conéctate a ChatGPT Developer Mode

Expón el puerto 8787 usando un túnel HTTPS como ngrok y usa:

https://YOUR-TUNNEL/mcp

como URL MCP de la aplicación.

Opcional: flujo de checkout existente de £9.99

Instala carkeeper-chatgpt-api.php como un pequeño plugin de WordPress. Añade esta constante en algún lugar seguro de la configuración de WordPress:

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

Configura CARKEEPER_WP_API_TOKEN con el mismo valor en el servidor MCP y define:

CARKEEPER_ENABLE_COMMERCE_TOOLS=true

solo para pruebas privadas en Developer Mode.

El puente utiliza la creación de informes existente de CarKeeper, la restauración del token de checkout, el producto de WooCommerce de £9.99 y el almacenamiento de informes de pago, en lugar de crear un segundo sistema de pagos.

Seguridad

Nunca hagas commit de .env, claves de OpenAI, claves de Check Car Details, claves de DVLA ni tokens de plugin compartidos. Genera secretos aleatorios largos para ambos tokens compartidos.