快速开始

三步完成 MCP 接入：开放平台生成凭证 → 客户端配置 mcp.json → 重启客户端验证。

前置：确认项目已启用开放平台

MCP Token 只是"入口凭证"，服务端仍需要项目的 App Key / App Secret去签下游 REST 请求。若项目从未启用过开放平台，任何 MCP 调用都会以 401 Invalid token 失败（消息容易误导，实际是缺凭证）。

进入控制台 → 目标项目 → 开放平台，确认 App Key / App Secret 已生成。首次点"生成 App Secret"即可。

顺序不要反

可以先生成 MCP Token 再生成 App Key，但只要缺其一 MCP 就 401。推荐一次把两者都生成。

第 1 步：生成 MCP Token

同一个"开放平台"页面下方的 AI Agent 接入 卡片，点 生成 MCP Token。

页面会仅此一次弹出明文 token（形如 lox_mcp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX），关闭对话框后无法再次取回。同时提供一键复制的 mcp.json 片段。

Token 处置规则

Token 明文只显示这一次，关闭对话框后无法再取回，请立即存到你的密钥管理位置
控制台 重置 / 撤销 后下一次请求就 401，没有缓存、没有过渡窗口
若泄露或忘存，点 重置 MCP Token 生成一条新的（旧 token 立即失效）

第 2 步：写入客户端 mcp.json

页面提供的 mcp.json 片段如下（Bearer 后面就是你的 token）：

json

{
  "mcpServers": {
    "loxily": {
      "url": "https://mcp.loxily.com/mcp",
      "headers": {
        "Authorization": "Bearer lox_mcp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

粘贴或合并到你 MCP 客户端的配置文件（各客户端具体路径见客户端配置）。

第 3 步：重启客户端

重启 Cursor / Claude Desktop / Cline 等客户端后，工具列表里应该出现 21 个 loxily_* 工具（loxily_list_languages、loxily_create_task 等）。

第一次调用：验证链路

推荐第一次调用 loxily_list_languages（零参数、只读、幂等）：

> 帮我查一下这个项目支持哪些目标语言

预期返回项目的 project_id / source_language / target_languages。如果拿到列表，说明整条链路 MCP 客户端 → mcp.loxily.com → 反查 project 凭证 → 签下游 REST → Open Platform 全部通了。

如果拿不到，去疑难排查按错误消息定位。

快速开始 ​

前置：确认项目已启用开放平台 ​

第 1 步：生成 MCP Token ​

第 2 步：写入客户端 mcp.json ​

第 3 步：重启客户端 ​

第一次调用：验证链路 ​