Prime Forecast MCP

Read-only MCP gateway fase 1 para Prime Forecast V3

• Production Laravel: https://sale.primes.co.th

• Remote MCP: https://mcp.primes.co.th/mcp

• Runtime: Node.js 24.19.0

• Plesk startup file: app.js

• Transport: stateless Streamable HTTP

• Data path: MCP → Laravel API Gateway → Prime Forecast V3

• Política de fase 1: no hay herramientas create/update/delete/write

Herramientas de la fase 1

Todas las herramientas tienen anotaciones MCP readOnlyHint: true, destructiveHint: false y verifican tanto el rol como el permiso explícito de Laravel.

Related MCP server: salesforce-mcp

Empezar en la máquina de desarrollo

Copy-Item .env.example .env
npm install
npm test
$env:NODE_ENV='development'
$env:LARAVEL_MCP_SERVICE_TOKEN='local-test-service-token'
node app.js

Los valores del archivo .env no se cargan automáticamente en producción; configúrelos directamente a través de las variables de entorno de Plesk.

Documentación

• Plan y criterios de aprobación de la fase 1

• Arquitectura y límites de seguridad

• Laravel API contract

• Cómo integrar Laravel V3

• Despliegue mediante Plesk/GitHub sin terminal

• Permission test matrix

Estado importante

El MCP de Node y las pruebas automatizadas están listos, pero está prohibido abrir datos de producción hasta que se adapte el adaptador de Laravel al modelo/esquema real, se pruebe con cuentas reales de Sales / Team Admin / Admin en todos los casos y se confirme el mecanismo OAuth 2.1 o la emisión de tokens que se usará con el cliente real. No se pueden añadir herramientas de escritura hasta que se supere la puerta de aprobación en docs/phase-1-plan.md.