概覽
MEXAR MCP Server 是一個 headless Model Context Protocol server，用於把部分 MEXAR Core API 工作流暴露給 AI clients。它讓操作人員可以透過自然語言查詢部門、客戶、幣種、帳戶、交易、master agents、匯率報價與 remittance 上下文，而不需要再建構一個新的 dashboard surface。
這個元件是探索性的 V1 prototype，不是公開產品 UI。由於它連接的是實際金融營運系統，設計上刻意保持保守：read 和 lookup tools 是預設工作流，write tools 必須經過明確確認，也可以透過 read-only mode 完全關閉。
產品架構
- Thin TypeScript MCP bridge - Server 使用 TypeScript 與官方 Model Context Protocol SDK 實作，透過 stdio 運行，因此 Claude Code、Claude Desktop 或其它支援 MCP 的 client 可以連接，而不需要額外 HTTP server。
- 不需要後端改動 - MCP 層包裝既有 MEXAR Core REST API，沒有引入新的後端服務或資料庫，因此可以作為 operator-side integration layer 部署。
- 基於環境變數的認證 - Runtime configuration 透過
MEXAR_API_BASE_URL與MEXAR_ACCESS_TOKEN提供。Access token 使用既有 Laravel Passport bearer token，並要求對應 employee identity user。 - 按業務域拆分 tools - Tools 按部門、客戶、exchange、remittance、transactions、accounts、master agents、countries 與共享 response helpers 拆分。
- Read-first operating model -
list_my_departments、search_customers、get_customer、quote_exchange、list_transactions、show_transaction、list_accounts、show_account等 lookup tools 始終註冊。 - Confirm-gated write tools - 建立/更新客戶、建立 money changer exchange 與建立 remittance 預設返回 dry-run preview。Tool 會返回即將呼叫的方法、endpoint 與 payload；只有再次以
confirm: true呼叫時才會執行。 - Read-only deployment switch -
MEXAR_READONLY可以完全關閉 write tools，讓同一個 server 用於更安全的查詢、支援與排查流程。 - Human-readable response enrichment - Reference-data helpers 會把部分回應中的 currency id 與 country id 解析成名稱，減少 AI client 需要自行解讀的數字上下文。
- Rate and settlement safeguards - Exchange 與 remittance tools 包含系統報價檢查、rate deviation warning、帳戶查詢支援，並明確提示 money changer flow 與 remittance flow 的差異。
關鍵能力
- 自然語言營運查詢 - 透過 AI client 查詢客戶紀錄、今日交易、帳戶餘額、部門幣種配置或 master agent 上下文。
- 交易準備輔助 - 在準備 exchange 或 remittance payload 前，先解析部門、客戶、幣種、帳戶與報價上下文。
- Dry-run financial writes - 敏感的 CRM、exchange 與 remittance 寫入會先預覽再執行，保留人工審查步驟。
- 最小整合面 - 作為本機或 operator-side MCP process 運行，透過 bearer token 存取既有 API，避免新增公開服務面。
- AI-assisted internal tooling - 展示如何在不重寫核心平台的前提下，將 MEXAR 既有 API 架構延伸為 AI-native operator workflow。
