接入 AI 终端（MCP）
把你的 LaTeX Agent 项目交给 Claude Code、Cursor 等 AI 终端直接操作。
LaTeX Agent 提供 MCP（Model Context Protocol）工具服务端，让 Claude Code、Cursor 等 AI 终端直接读写你的项目文件、触发云编译并取回 PDF、检索文献、阅读论文库、处理评审批注——你在终端里说「编译我的论文」即可完成闭环。
前提：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 可随时吊销；吊销立即生效。
三种主流方式任选其一（域名已按当前站点自动生成，复制后把 lxa_YOUR_TOKEN 换成你的 Token）：
claude mcp add --transport http latex-agent https://your-site/mcp --header "X-API-Key: lxa_YOUR_TOKEN"{
"mcpServers": {
"latex-agent": {
"url": "https://your-site/mcp",
"headers": {
"X-API-Key": "lxa_YOUR_TOKEN"
}
}
}
}{
"transport": "streamable-http",
"url": "https://your-site/mcp",
"headers": {
"X-API-Key": "lxa_YOUR_TOKEN"
}
}认证统一走 X-API-Key 请求头；不要用网页登录态的 Bearer Token。
工具大多需要一个 project_id——它就在浏览器地址栏项目 URL 的 ?project= 参数值（一串短 id），直接粘贴给 AI 即可。然后试着说：
这是我的 project_id：<粘贴 id>。先列出项目文件结构，把绪论一节的开头改得更学术一点，然后编译并给我 PDF 链接。
API Key 即项目 main 分支的写权限——大改之前先在网页端存一个版本，或让 AI 每次大改前先建版本快照。
Token 泄露后第一时间回个人中心吊销，立即生效。
编译是异步的：`compile` 立即返回任务号，请让 AI 用 `compile_status` 轮询（约 15 秒一次）直到成功/失败，成功即得 PDF 链接。若客户端报「Internal Server Error / 超时」而任务号还在，继续轮询即可——不要重新提交。
团队/共享项目已接入：按你的项目角色（查看/评论/编辑/所有者）开放对应工具，权限不足会明确提示；API Key 的 scope 仍单独生效。