Prime Forecast MCP

Read-only MCP gateway фазы 1 для 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

• Политика фазы 1: нет инструментов create/update/delete/write

Инструменты фазы 1

Каждый tool имеет MCP annotations: readOnlyHint: true, destructiveHint: false, и проверяет как role, так и explicit permission из Laravel

Related MCP server: salesforce-mcp

Начало работы на машине разработки

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

Значения из файла .env не загружаются автоматически в production; задавайте их напрямую через Plesk Environment Variables

Документация

• План и критерии утверждения Phase 1

• Архитектура и security boundaries

• Laravel API contract

• Интеграция Laravel V3

• Deploy через Plesk/GitHub без Terminal

• Permission test matrix

Важный статус

Node MCP и automated tests готовы, но запрещено открывать production data, пока adapter Laravel не будет приведён в соответствие с реальными model/schema, не будут протестированы реальные учётные записи Sales / Team Admin / Admin во всех случаях, и не будет подтверждён механизм OAuth 2.1 или token issuance для использования с реальными client. Запрещено добавлять write tools до прохождения approval gate в docs/phase-1-plan.md.