帮助中心
关于撰写、编译和协作 LaTeX 与 Typst 项目的清晰实用指南。
接入外部 Agent
让兼容 MCP 的外部 Agent 只在你指定的项目和范围内工作。
通过登录连接应用
像 Claude 这样只凭 MCP 服务地址添加服务器的应用不需要令牌：它会把你带到 JointTex 登录并确认。
操作步骤
- 在账户设置中打开访问令牌，复制 MCP 服务地址。
- 把它粘贴到应用添加服务器的地方。在 Claude 中是：自定义、连接器、添加自定义连接器。
- 应用会在浏览器中打开 JointTex。按提示登录，核对页面上写的返回地址，选择权限范围和项目，然后选择「允许」。
- 该应用会出现在访问令牌页的「已连接的应用」里，可以在那里收窄它的权限或断开连接。
创建 MCP 令牌
JointTex 教育版、Plus 和 Pro 可以通过账户设置里显示的 MCP 服务器，接入兼容的外部 Agent，包括 Codex 和 Claude Code。
操作步骤
- 在账户设置中打开访问令牌，展开“使用 MCP 令牌”，创建一个令牌，只勾选该 Agent 真正需要的项目和权限。
- 令牌只显示一次，复制后在你的 Agent 里配置显示的 MCP 服务器地址，并把令牌作为 Authorization Bearer 头。
- 或者选择「复制 Agent 配置提示词」，把它粘贴给你的 Agent。提示词里包含端点和完整的令牌，所以只发给你信任的 Agent。
- 先从只读的权限范围开始。如果之后 Agent 需要改动源码，就新建一个带文件写入权限的令牌：令牌的权限范围只能移除，不能添加。
选择权限范围和项目
令牌带着一份权限范围清单和一份项目清单，Agent 在两者之外什么都做不了。只有公开的帮助指南不受此限，任何令牌都能读取。
操作步骤
- 权限范围有 projects:read、projects:create、members:invite、files:read、files:write、review:decide、compile:run、comments:read、comments:write、templates:publish 和 account:read。新令牌默认带三个读取范围，写入范围总会连带对应的读取范围。
- 有 projects:create 时 Agent 可以在你的账号下新建项目，有 members:invite 时可以按邮箱邀请别人加入你拥有的项目；两者都计入套餐的项目数和协作者数上限。新令牌默认不勾选，已有令牌也不会自动获得：只在你希望 Agent 代你做这些事时才勾选。
- 有 templates:publish 时，Agent 可以把你拥有的项目发布到模板库，或重新发布你发布过的模板，与「发布为模板」相同；模板发布后立即公开。新令牌默认不勾选，已有令牌也不会自动获得。
- 有 account:read 时，Agent 可以看到你的账户已经设置了什么，从而帮你设置其余部分：你的套餐、Zotero、WebDAV 和 GitHub 是否已连接、持有多少个 Git 和 MCP 令牌、你的 Agent 连接器和组织。它看不到任何密钥、密码或令牌。新令牌默认不勾选。
- 有了 comments:write，Agent 可以针对一段文字发起评论对话、回复对话，并将其标记为已解决或重新打开；它不能编辑评论，只能删除自己发起的对话。
- Agent 写入的内容与应用内 Agent 的编辑一样，以修订的形式留给项目成员审阅。有了 review:decide，它还可以接受或拒绝修订；如果希望由人来决定，就不要勾选这一项。
- 有了 files:write，Agent 还可以修改项目的编译设置（主文件、引擎、TeX Live 版本、编译模式），这些设置对所有协作者生效。有了 files:read，它可以取得编译出的 PDF 的下载链接；链接十分钟内有效、无需登录，断开该 Agent 后立即失效。
- 选择「所有项目」会包括你现在和将来能访问的项目，所以当 Agent 的任务很窄时，请指明具体项目。
- 令牌永远不会超出你自己的角色：在你只是查看者的项目里，即使有 files:write，Agent 也无法写入。
监督并随时撤销连接
看不见的令牌就是管不住的令牌，所以每个连接都可查、可撤。
操作步骤
- 在“访问令牌”的“使用 MCP 令牌”里查看该令牌能触及哪些项目和权限范围。
- 工作范围变化时，用「编辑权限」修改它的项目或移除权限范围，而不是另发一个权限更大的令牌。添加权限范围需要新建一个 MCP 令牌。
- 不再需要时立刻撤销，撤销即时生效。
- 外部 Agent 写入的内容会和普通编辑一样进入项目历史，随时可以审阅或回滚。
- 最多可以保留 10 个 MCP 令牌。如果你的套餐降到教育版、Plus 或 Pro 以下，已有的令牌仍会保存，但会被暂停。