MCP 接入
Loxily MCP（Model Context Protocol）服务把开放平台的 REST 接口原样封装成 AI Agent 可直接调用的工具。Cursor、Claude Desktop、Cline 等主流 AI 客户端只需要一行 mcp.json 配置，就能获得完整的翻译任务、术语、导出能力，无需自己实现签名逻辑。
- 服务地址：
https://mcp.loxily.com/mcp - 传输方式：Streamable HTTP（MCP 2025-06-18 协议）
- 鉴权方式：Bearer Token（唯一凭证，永远只在生成时明文显示一次）
- 工具数量：29 个
loxily_*工具，与开放平台 REST API 一一对应
何时用 MCP vs 直连 REST
| 维度 | MCP 接入 | 直连 开放平台 REST |
|---|---|---|
| 目标用户 | AI Agent、IDE 助手、自动化脚本 | 后端服务、CI/CD、自建 SDK |
| 鉴权凭证 | 单一 Bearer <MCP Token> | X-Loxily-AppKey + X-Loxily-Timestamp + X-Loxily-Sign |
| 签名开销 | 无（服务端负责所有签名） | 每次请求 MD5(timestamp + body + appSecret) |
| 调用方式 | 自然语言 → LLM 挑选工具 → 参数校验 → 执行 | 拼 URL / 组装 body / 手写签名 / 处理响应 |
| 参数校验 | 服务端 Zod schema，错误提前抛 | 拆到 REST 422 之后才知道 |
| 典型场景 | "帮我把这批中文文案翻成日/韩/英" | 批量脚本、CI 集成、自建门户 |
两条通路走的是同一个 project、同一份数据，可以并存。MCP 只是加了一层 AI Agent 友好的包装，底层依然复用开放平台的 App Key / App Secret 签名下游 REST 请求。
29 个工具分类概览
工具命名规范
所有工具统一 loxily_<domain>_<action> 前缀，方便 LLM 在语义匹配阶段准确定位。每个工具的完整 inputSchema 见 开放平台 API 参考 —— MCP 参数结构与 REST 请求体保持一致。
项目与语言（1）
loxily_list_languages— 查询项目源语言、可用目标语言、全量语言树
任务生命周期（8）
loxily_create_task— 创建翻译任务（异步）loxily_query_task_status— 查询任务状态与阶段（单次拉取）loxily_wait_for_task— 服务端阻塞轮询直到任务到达终态（推荐 Agent 使用）loxily_query_task_strings— 分页查询任务字符串与各语言译文（JSON，任务 completed 即可查，无需先发布）loxily_publish_task— 发布已完成翻译到项目级（异步，返回publish_open_...job_id）loxily_query_publish_status— 查询发布状态（单次拉取，见 查询发布状态）loxily_wait_for_publish— 阻塞轮询直到发布到达终态；发布后要导出，先等它 completedloxily_supplement_translate— 追加/补翻某任务里的字符串
任务级术语（4）
loxily_query_task_terms— 查询扫描到的术语loxily_update_task_term— 修改单条任务术语loxily_delete_task_term— 删除单条任务术语loxily_confirm_terms— 确认术语库并继续翻译（当auto_apply_terms=false时）
项目级术语库（4）
loxily_create_terms— 批量上传项目术语loxily_list_terms— 查询项目术语列表loxily_batch_update_terms— 批量修改loxily_batch_delete_terms— 批量删除
翻译记忆库（3）
loxily_list_tm— 分页查询项目 TM 记录（支持按源语言 / 原文 / 关键词过滤）loxily_update_tm— 修正 TM 译文（同步）loxily_delete_tm— 删除 TM 记录（同步）
导出模板（5）
loxily_list_export_templates— 列出模板loxily_get_export_template— 查询单个模板loxily_create_export_template— 创建模板loxily_update_export_template— 更新模板loxily_delete_export_template— 删除模板
导出与其他（4）
loxily_export_ini— 导出 INI（或 ZIP），返回签名下载 URL；默认同步，async=true入队即时返回 job_id（大批多语言导出建议开启）loxily_query_export_status— 查询一次异步导出的进度/终态（单次拉取）loxily_wait_for_export— 阻塞轮询直到异步导出完成，返回 download_urlloxily_whats_new— 查询平台更新日志