设置

API 鉴权 / MCP 接入 / 打印机

API Token

所有 /api/* 与 /mcp 端点需 Bearer token:

Authorization: Bearer <your-api-token>

当前: ✓ 已用环境变量 API_TOKEN 设置 (值已隐藏, 请在部署配置中查看)

OpenAPI 文档

完整 REST API 规范 (OpenAPI 3.1):

GET /api/openapi

MCP HTTP+SSE

AI agent 可通过 Streamable HTTP 连接:

POST /mcp
Authorization: Bearer <your-api-token>
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}

工具: search_item · get_inventory · inbound_item · outbound_item · list_locations · find_or_create_item · recent_logs

MCP stdio

本地 stdio 模式 (无需 token):

npm run mcp
# 或: node dist/mcp-server.js (生产)

热敏打印机

detonger WebSDK: sdkID 1200C8C4-E698-4624-BA30-5F18A1744493. 可通过 NEXT_PUBLIC_DETONGER_SDK_URL 配置 SDK 脚本地址. 未加载 SDK 时, 打印页自动回退到浏览器打印.