AI 助手使用指南

接入 AI 终端（MCP）

把你的 LaTeX Agent 项目交给 Claude Code、Cursor 等 AI 终端直接操作。

这是什么

LaTeX Agent 提供 MCP（Model Context Protocol）工具服务端，让 Claude Code、Cursor 等 AI 终端直接读写你的项目文件、触发云编译并取回 PDF、检索文献、阅读论文库、处理评审批注——你在终端里说「编译我的论文」即可完成闭环。

文件读写云编译 → PDFSyncTeX 双向跳转文献检索论文库阅读评审批注处理就地反馈

前提：API Token 仅对付费订阅用户开放（免费/试用档不可铸造）。

第 1 步：铸造 API Token

在个人中心 → API Token 新建一个 Token（形如 lxa_...，明文只显示一次），按下表勾选 scope：

Scope	赋予的能力	说明
project:write	项目文件读写（编辑、覆盖、追加）	默认建议勾选；也是编译之外的写权限基础
compile:run	触发云编译并取回 PDF	编译请单独勾选（最小授权建议）
papers:read	阅读论文库（列表与逐页全文）	与 project:write 互不蕴含
review:read / review:write	评审批注只读 / 回复与解决	处理导师批注时勾选；只读用 review:read，写入用 review:write

Token 可随时吊销；吊销立即生效。

第 2 步：接入你的客户端

三种主流方式任选其一（域名已按当前站点自动生成，复制后把 lxa_YOUR_TOKEN 换成你的 Token）：

Claude Code（命令行）

claude mcp add --transport http latex-agent https://your-site/mcp --header "X-API-Key: lxa_YOUR_TOKEN"

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "latex-agent": {
      "url": "https://your-site/mcp",
      "headers": {
        "X-API-Key": "lxa_YOUR_TOKEN"
      }
    }
  }
}

通用 Streamable HTTP（JSON）

{
  "transport": "streamable-http",
  "url": "https://your-site/mcp",
  "headers": {
    "X-API-Key": "lxa_YOUR_TOKEN"
  }
}

认证统一走 X-API-Key 请求头；不要用网页登录态的 Bearer Token。

第 3 步：用起来

工具大多需要一个 project_id——它就在浏览器地址栏项目 URL 的 ?project= 参数值（一串短 id），直接粘贴给 AI 即可。然后试着说：

示例 prompt

这是我的 project_id：<粘贴 id>。先列出项目文件结构，把绪论一节的开头改得更学术一点，然后编译并给我 PDF 链接。

安全与边界

API Key 即项目 main 分支的写权限——大改之前先在网页端存一个版本，或让 AI 每次大改前先建版本快照。

Token 泄露后第一时间回个人中心吊销，立即生效。

编译是长任务，个别客户端有超时限制——超时重试即可。

团队/共享项目已接入：按你的项目角色（查看/评论/编辑/所有者）开放对应工具，权限不足会明确提示；API Key 的 scope 仍单独生效。