尧图网页设计 
1. 为什么 LaTeX 作者需要一个能“动手”的 MCP如果你平时用 TeXstudio 写论文或书稿大概率遇到过这种场景让 AI 帮忙改一段公式它改得挺像样但改完你还得自己切回编辑器、手动编译、翻.log找报错、再回来告诉它“第 87 行少了个}”。来回几轮AI 更像一个“会聊天的建议框”而不是真正参与你 LaTeX 工程的协作者。texstudio-mcp 想解决的就是这个断层。它是一层面向 LaTeX 工作流的 MCP 服务在指定的工程目录workspace_root里安全地读写.tex、.bib、.sty按需调用本机已经装好的 TeX 工具链latexmk、bibtex、biber、chktex、pdfinfo、pdftotext、synctex等再把结果以结构化 JSON 交还给 AI 客户端。换句话说它让 Cursor、Claude Desktop 这类支持 MCP 的客户端从“只会泛泛而谈”变成“能读源码、能改文件、能跑编译、能看日志”。它适合谁主要是三类人一是本地已经有 TeXstudio、TeX Live 环境不想重装工具链的论文作者二是书稿/学位论文这种多文件、多章节、带参考文献的复杂工程维护者三是想把 LaTeX 编译、检查、PDF 元数据读取串进 Agent 自动化流程的人。它不替代 TeXstudio也不替代 TeX Live它补的是“AI 与本地 LaTeX 工程之间的操作层”。这篇会先讲清楚 texstudio-mcp 的能力边界和典型工作流然后重点落在统一 Key 接入这件事上用 TaoToken 一个 Key 打通 MCP 调用链给出可复制的配置片段、接入参数以及一次“编译报错回传”的完整验证动作。你照着做能跑通从改稿到看日志的闭环。2. texstudio-mcp 能力全景与 TaoToken 统一接入前置先把 texstudio-mcp 的能力按使用场景过一遍这样后面配置时你知道每个工具是干嘛的。环境自检类get_server_info返回 Python 版本、包版本、平台health_check_tex_toolchain检测latexmk、pdflatex、xelatex、lualatex、bibtex、biber、chktex、pdfinfo、pdftotext、synctex是否在 PATH 里。它只做which不启动编译适合 Agent 在流程开头做能力探测。读工程类read_project_file读 UTF-8 文本可按行号截取有max_chars上限grep_project在工程内对小文件做正则搜索list_latex_related_files递归列出.tex、.bib、.sty等跳过.git、.venvparse_tex_dependencies对单个.tex做静态扫描解析\input、\include、\includegraphics、\usepackage、\bibliography、\addbibresource等可切换为workspace_manifest枚举整个工程资源树。注意它不执行 TeX带\、\#等动态路径会进unresolved。编辑类replace_project_lines按 1-based 行区间替换write_project_file新建文件并自动建父目录覆盖必须显式overwritetrue。写入统一 UTF-8、LF有体积上限。编译与文献类重点compile_latex_document在workspace_root下对main_tex执行latexmk -pdf返回summary、stdout_tail/stderr_tail、wall_clock_ms、exit_code、timed_out。同一 MCP 进程内同一workspace_root同时只能跑一个会改产物的任务并行第二次会得到concurrent_workspace_exclusive_blocked。run_bibtex_on_job/run_biber_on_job在沙箱内对job_name跑对应后端guess_job_bibliography_backend只读查看.bcf/.aux片段启发式返回该用biber还是bibtexcompile_latex_then_run_bibliography_on_job一条龙完成latexmk -pdf → bib → 可选 0~2 次后续 latexmk。日志诊断analyze_latex_log读.log尾部提取 error/warninganalyze_bibliography_log读.blg区分 biber/BibTeX 风格问题。全文日志仍建议用read_project_file读.log。.bib校验validate_bib_file查重复 citation key、重复string、粗括号平衡可选规范化写回装了bibtexparser后可用use_bibtexparsertrue做条目级检查。PDF 与 SyncTeXread_pdf_metadata调pdfinfoextract_pdf_text_preview用pdftotext抽前几页resolve_synctex_forward把 TeX 行映射到 PDF 坐标resolve_synctex_backward反向映射。需要 PATH 里有 Poppler/SyncTeX且工程内已有.pdf与.synctex.gz。ChkTeXrun_chktex_on_tex、batch_run_chktex_on_tex、run_chktex_on_workspace。ChkTeX 有告警时退出码可能非 0ok也可能为 false但warnings里仍有条目可读。TeXstudio 联动read_texstudio_profile_snapshot读取白名单文件texstudio.ini、lastSession.txss仅文件名禁止子路径include_parsed_hintstrue时启发式解析最近文档、Master 文档得到suggested_job_basename。它不会把 TeXstudio 里的绝对路径自动纳入workspace_root也不建议在不可信会话里开启。现在说 TaoToken 的前置。TaoToken 在这里的角色是统一 Key 提供方你不需要为每个 AI 客户端单独申请一套凭证而是用同一个 Key 去驱动 MCP 调用链里的模型侧请求。官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基址是https://taotoken.net/api这个不加 UTM。你需要先拿到 Key再去 API Keys 页面确认权限然后按客户端要求填 Base URL、Key、Model ID 三件套。这一步做完后面的 MCP 配置才有意义。3. 可复制配置texstudio-mcp TaoToken 三件套这一节给可直接复制的片段。核心是三件套Base URL、Key、Model ID。不同客户端字段名略有差异但语义一致。先看 MCP 服务端的 stdio 配置。以 Cursor 的mcp.json为例路径通常在~/.cursor/mcp.jsonmacOS/Linux或%USERPROFILE%\.cursor\mcp.jsonWindows{ mcpServers: { texstudio-mcp: { command: python, args: [-m, texstudio_mcp], env: { WORKSPACE_ROOT: /Users/you/thesis, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_MODEL_ID: claude-sonnet-4-5 } } } }如果你用的是 Claude Desktop配置文件在~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS或%APPDATA%\Claude\claude_desktop_config.jsonWindows结构类似{ mcpServers: { texstudio-mcp: { command: python, args: [-m, texstudio_mcp], env: { WORKSPACE_ROOT: /Users/you/book, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_MODEL_ID: claude-sonnet-4-5 } } } }如果你更习惯用 TOML 管理比如某些 CLI 工具或自建 Agent 框架可以这样写[llm] base_url https://taotoken.net/api api_key sk-你的Key model_id claude-sonnet-4-5 [mcp.texstudio] command python args [-m, texstudio_mcp] workspace_root /Users/you/thesis关于WORKSPACE_ROOT和main_tex的推荐组合TeXstudio 常把“当前工作目录”设为主.tex那一层。若你把workspace_root指到同一层只传paper.tex这样的 basename服务会自动避免多余的latexmk -cd若workspace_root是仓库根、主文件在子目录则用相对路径如thesis/chapter1.tex由latexmk在子目录里编译。我试过把workspace_root设成仓库根、主文件放thesis/下编译时传thesis/main.tex日志和产物都落在thesis/里路径不会乱。Model ID 怎么选如果你主要做长文改稿、多文件结构解析选上下文窗口大的模型如果只是编译报错定位、日志摘要中等模型就够。TaoToken 的模型对话入口在https://taotoken.net/api对应的控制台里可以看可用模型列表具体以你账号下实际可用的为准。长期编码或 Agent 场景可以关注 Coding Plan 相关入口把额度用在刀刃上。配置改完记得重启客户端让 MCP 服务重新加载。重启后先在对话里问一句“调用 get_server_info”能返回版本信息就说明 MCP 进程起来了。4. 验证请求一次编译报错回传的完整动作配置好之后别急着改大稿先用一个最小工程验证“编译报错回传”这条链路。这是最能体现 texstudio-mcp 价值的一步。第一步准备一个故意有错的最小main.tex\documentclass{article} \begin{document} \section{Test} Hello \LaTeX \badcommand \end{document}第二步让 AI 客户端调用health_check_tex_toolchain确认latexmk、pdflatex在 PATH 里。如果返回里latexmk是 false先解决工具链别往下走。第三步调用compile_latex_document参数传main_tex: main.tex。预期返回里exit_code非 0summary会是一行人类可读摘要stderr_tail或stdout_tail里能看到Undefined control sequence之类的信息。第四步调用analyze_latex_log让它读main.log尾部。返回里应该能提取到 error 条目指向\badcommand所在行。这一步就是“编译报错回传”的核心AI 不再需要你手动复制日志它自己拿到了结构化错误。第五步调用replace_project_lines把\badcommand替换成合法内容比如\LaTeX{}。然后再调一次compile_latex_document这次exit_code应为 0summary显示成功。第六步调用read_pdf_metadata确认main.pdf页数、版本等元数据能读出来。如果这一步报错多半是pdfinfo不在 PATH或者编译没真正产出 PDF。整个流程跑通说明 MCP 调用链、TaoToken Key、本机 TeX 工具链三者已经串起来了。你可以把这段流程固化成 Agent 的编排模板validate_workspace_root → read_project_file/grep_project 定位 → replace_project_lines 修改 → compile_latex_document → analyze_latex_log失败就回到定位步骤。带参考文献的论文把第三步换成compile_latex_then_run_bibliography_on_jobbibliography_toolautopost_bibliography_latexmk_passes1或2。如果仍有问题再调analyze_bibliography_log加read_project_file读.blg。插图路径排查则用parse_tex_dependencies看includegraphics边与graphicspath对缺失资源用list_latex_related_files核对。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错来。你大概率会碰到下面几类。401 Unauthorized最常见。原因通常是 Key 没填对、Key 过期、或者 Base URL 写成了带路径的完整接口地址而不是基址。检查TAOTOKEN_BASE_URL是否为https://taotoken.net/apiKey 是否从 API Keys 页面复制完整有没有多余空格。如果客户端支持先用模型对话入口单独测一次 Key 是否可用排除 Key 本身的问题。local proxy failed / connection refusedMCP 服务进程没起来或者端口/stdio 通道断了。先看客户端日志里 MCP 进程的启动输出确认python -m texstudio_mcp能手动跑起来。如果手动跑报ModuleNotFoundError说明包没装到当前 Python 环境检查command指向的 Python 是不是你装包的那个。reading choices / 返回结构解析失败这类报错通常出现在模型侧返回格式和客户端预期不一致时。检查 Model ID 是否填了客户端不支持的模型或者 Base URL 指向的端点与客户端协议不匹配。把 Model ID 换成明确可用的再试一次。如果客户端日志里能看到原始响应对比一下是不是 JSON 结构问题。OAuth / 认证跳转失败部分客户端默认走 OAuth 流程但你的接入方式是 Key 直连。在客户端设置里找“使用 API Key”或“自定义 Base URL”选项关掉 OAuth 自动流程。如果客户端强制 OAuth考虑换用支持 Key 直连的客户端或者用 CLI 方式先验证。concurrent_workspace_exclusive_blocked同一 MCP 进程、同一workspace_root不能并行编译。如果你开了多个 Cursor 窗口或多个 MCP 实例指向同一文件夹仍可能同时写。解决办法是串行化或者给不同实例配不同workspace_root。PDF/SyncTeX 缺失read_pdf_metadata或resolve_synctex_*报错先确认工程内已有.pdf和.synctex.gz通常编译后才有再确认pdfinfo、pdftotext、synctex在 PATH 里。health_check_tex_toolchain能帮你一次性看清哪些缺。ChkTeX 退出码非 0这是正常的有告警时退出码可能非 0ok也可能为 false但warnings里仍有条目可读。别把它当成致命错误读warnings就行。排障时如果怀疑是 Key 或接入参数问题去 API Keys 页面核对再对照接入文档检查字段名。验证模型是否通用模型对话入口单独发一条消息最快。长期编码或 Agent 场景考虑 Coding Plan 把额度规划好。6. 把 MCP 调用链固定下来从单次验证到日常写作跑通一次验证之后真正省时间的是把调用链固定成日常习惯。我的做法是每次开新章节先让 Agent 调read_texstudio_profile_snapshotinclude_parsed_hintstrue拿到suggested_job_basename对齐 TeXstudio 里最近打开的那篇稿子然后parse_tex_dependencies扫一遍依赖确认没有漏掉的\input和缺失插图改稿用replace_project_lines改完立刻compile_latex_document失败就analyze_latex_log。这一套下来AI 不再是“建议框”而是真的在你的工程里干活。几个实用技巧workspace_root尽量对齐 TeXstudio 的工作目录减少路径歧义大段latexmk输出别指望 MCP 返回全文让它读工程内.log文件.bib校验在提交前跑一次validate_bib_file能挡掉重复 key 这种低级错误多文件书稿用workspace_manifest枚举资源树重构目录前先画依赖图。能力边界心里有数它不替代完整 IDE不提供 PDF 预览 UI 和编辑器交互同步编译收敛有限复杂引用仍可能需要手动多编几次单进程互斥多实例同文件夹仍可能冲突日志是截断的TeX 工具需本机安装MCP 包本身不含 TeX Live。如果你还没配好 Key先去https://taotoken.net/api-keys拿 Key再对照https://taotoken.net/doc检查接入参数。模型侧验证用https://taotoken.net/chat长期编码或 Agent 场景看https://taotoken.net/coding-plan。把这三件套填进你的 MCP 配置重启客户端从那个故意报错的最小main.tex开始跑一遍链路就通了。 把 TeXstudio / LaTeX 工程交给 AI：texstudio-mcp 功能详解与 TaoToken 统一接入
1. 为什么 LaTeX 作者需要一个能“动手”的 MCP如果你平时用 TeXstudio 写论文或书稿大概率遇到过这种场景让 AI 帮忙改一段公式它改得挺像样但改完你还得自己切回编辑器、手动编译、翻.log找报错、再回来告诉它“第 87 行少了个}”。来回几轮AI 更像一个“会聊天的建议框”而不是真正参与你 LaTeX 工程的协作者。texstudio-mcp 想解决的就是这个断层。它是一层面向 LaTeX 工作流的 MCP 服务在指定的工程目录workspace_root里安全地读写.tex、.bib、.sty按需调用本机已经装好的 TeX 工具链latexmk、bibtex、biber、chktex、pdfinfo、pdftotext、synctex等再把结果以结构化 JSON 交还给 AI 客户端。换句话说它让 Cursor、Claude Desktop 这类支持 MCP 的客户端从“只会泛泛而谈”变成“能读源码、能改文件、能跑编译、能看日志”。它适合谁主要是三类人一是本地已经有 TeXstudio、TeX Live 环境不想重装工具链的论文作者二是书稿/学位论文这种多文件、多章节、带参考文献的复杂工程维护者三是想把 LaTeX 编译、检查、PDF 元数据读取串进 Agent 自动化流程的人。它不替代 TeXstudio也不替代 TeX Live它补的是“AI 与本地 LaTeX 工程之间的操作层”。这篇会先讲清楚 texstudio-mcp 的能力边界和典型工作流然后重点落在统一 Key 接入这件事上用 TaoToken 一个 Key 打通 MCP 调用链给出可复制的配置片段、接入参数以及一次“编译报错回传”的完整验证动作。你照着做能跑通从改稿到看日志的闭环。2. texstudio-mcp 能力全景与 TaoToken 统一接入前置先把 texstudio-mcp 的能力按使用场景过一遍这样后面配置时你知道每个工具是干嘛的。环境自检类get_server_info返回 Python 版本、包版本、平台health_check_tex_toolchain检测latexmk、pdflatex、xelatex、lualatex、bibtex、biber、chktex、pdfinfo、pdftotext、synctex是否在 PATH 里。它只做which不启动编译适合 Agent 在流程开头做能力探测。读工程类read_project_file读 UTF-8 文本可按行号截取有max_chars上限grep_project在工程内对小文件做正则搜索list_latex_related_files递归列出.tex、.bib、.sty等跳过.git、.venvparse_tex_dependencies对单个.tex做静态扫描解析\input、\include、\includegraphics、\usepackage、\bibliography、\addbibresource等可切换为workspace_manifest枚举整个工程资源树。注意它不执行 TeX带\、\#等动态路径会进unresolved。编辑类replace_project_lines按 1-based 行区间替换write_project_file新建文件并自动建父目录覆盖必须显式overwritetrue。写入统一 UTF-8、LF有体积上限。编译与文献类重点compile_latex_document在workspace_root下对main_tex执行latexmk -pdf返回summary、stdout_tail/stderr_tail、wall_clock_ms、exit_code、timed_out。同一 MCP 进程内同一workspace_root同时只能跑一个会改产物的任务并行第二次会得到concurrent_workspace_exclusive_blocked。run_bibtex_on_job/run_biber_on_job在沙箱内对job_name跑对应后端guess_job_bibliography_backend只读查看.bcf/.aux片段启发式返回该用biber还是bibtexcompile_latex_then_run_bibliography_on_job一条龙完成latexmk -pdf → bib → 可选 0~2 次后续 latexmk。日志诊断analyze_latex_log读.log尾部提取 error/warninganalyze_bibliography_log读.blg区分 biber/BibTeX 风格问题。全文日志仍建议用read_project_file读.log。.bib校验validate_bib_file查重复 citation key、重复string、粗括号平衡可选规范化写回装了bibtexparser后可用use_bibtexparsertrue做条目级检查。PDF 与 SyncTeXread_pdf_metadata调pdfinfoextract_pdf_text_preview用pdftotext抽前几页resolve_synctex_forward把 TeX 行映射到 PDF 坐标resolve_synctex_backward反向映射。需要 PATH 里有 Poppler/SyncTeX且工程内已有.pdf与.synctex.gz。ChkTeXrun_chktex_on_tex、batch_run_chktex_on_tex、run_chktex_on_workspace。ChkTeX 有告警时退出码可能非 0ok也可能为 false但warnings里仍有条目可读。TeXstudio 联动read_texstudio_profile_snapshot读取白名单文件texstudio.ini、lastSession.txss仅文件名禁止子路径include_parsed_hintstrue时启发式解析最近文档、Master 文档得到suggested_job_basename。它不会把 TeXstudio 里的绝对路径自动纳入workspace_root也不建议在不可信会话里开启。现在说 TaoToken 的前置。TaoToken 在这里的角色是统一 Key 提供方你不需要为每个 AI 客户端单独申请一套凭证而是用同一个 Key 去驱动 MCP 调用链里的模型侧请求。官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基址是https://taotoken.net/api这个不加 UTM。你需要先拿到 Key再去 API Keys 页面确认权限然后按客户端要求填 Base URL、Key、Model ID 三件套。这一步做完后面的 MCP 配置才有意义。3. 可复制配置texstudio-mcp TaoToken 三件套这一节给可直接复制的片段。核心是三件套Base URL、Key、Model ID。不同客户端字段名略有差异但语义一致。先看 MCP 服务端的 stdio 配置。以 Cursor 的mcp.json为例路径通常在~/.cursor/mcp.jsonmacOS/Linux或%USERPROFILE%\.cursor\mcp.jsonWindows{ mcpServers: { texstudio-mcp: { command: python, args: [-m, texstudio_mcp], env: { WORKSPACE_ROOT: /Users/you/thesis, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_MODEL_ID: claude-sonnet-4-5 } } } }如果你用的是 Claude Desktop配置文件在~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS或%APPDATA%\Claude\claude_desktop_config.jsonWindows结构类似{ mcpServers: { texstudio-mcp: { command: python, args: [-m, texstudio_mcp], env: { WORKSPACE_ROOT: /Users/you/book, TAOTOKEN_BASE_URL: https://taotoken.net/api, TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_MODEL_ID: claude-sonnet-4-5 } } } }如果你更习惯用 TOML 管理比如某些 CLI 工具或自建 Agent 框架可以这样写[llm] base_url https://taotoken.net/api api_key sk-你的Key model_id claude-sonnet-4-5 [mcp.texstudio] command python args [-m, texstudio_mcp] workspace_root /Users/you/thesis关于WORKSPACE_ROOT和main_tex的推荐组合TeXstudio 常把“当前工作目录”设为主.tex那一层。若你把workspace_root指到同一层只传paper.tex这样的 basename服务会自动避免多余的latexmk -cd若workspace_root是仓库根、主文件在子目录则用相对路径如thesis/chapter1.tex由latexmk在子目录里编译。我试过把workspace_root设成仓库根、主文件放thesis/下编译时传thesis/main.tex日志和产物都落在thesis/里路径不会乱。Model ID 怎么选如果你主要做长文改稿、多文件结构解析选上下文窗口大的模型如果只是编译报错定位、日志摘要中等模型就够。TaoToken 的模型对话入口在https://taotoken.net/api对应的控制台里可以看可用模型列表具体以你账号下实际可用的为准。长期编码或 Agent 场景可以关注 Coding Plan 相关入口把额度用在刀刃上。配置改完记得重启客户端让 MCP 服务重新加载。重启后先在对话里问一句“调用 get_server_info”能返回版本信息就说明 MCP 进程起来了。4. 验证请求一次编译报错回传的完整动作配置好之后别急着改大稿先用一个最小工程验证“编译报错回传”这条链路。这是最能体现 texstudio-mcp 价值的一步。第一步准备一个故意有错的最小main.tex\documentclass{article} \begin{document} \section{Test} Hello \LaTeX \badcommand \end{document}第二步让 AI 客户端调用health_check_tex_toolchain确认latexmk、pdflatex在 PATH 里。如果返回里latexmk是 false先解决工具链别往下走。第三步调用compile_latex_document参数传main_tex: main.tex。预期返回里exit_code非 0summary会是一行人类可读摘要stderr_tail或stdout_tail里能看到Undefined control sequence之类的信息。第四步调用analyze_latex_log让它读main.log尾部。返回里应该能提取到 error 条目指向\badcommand所在行。这一步就是“编译报错回传”的核心AI 不再需要你手动复制日志它自己拿到了结构化错误。第五步调用replace_project_lines把\badcommand替换成合法内容比如\LaTeX{}。然后再调一次compile_latex_document这次exit_code应为 0summary显示成功。第六步调用read_pdf_metadata确认main.pdf页数、版本等元数据能读出来。如果这一步报错多半是pdfinfo不在 PATH或者编译没真正产出 PDF。整个流程跑通说明 MCP 调用链、TaoToken Key、本机 TeX 工具链三者已经串起来了。你可以把这段流程固化成 Agent 的编排模板validate_workspace_root → read_project_file/grep_project 定位 → replace_project_lines 修改 → compile_latex_document → analyze_latex_log失败就回到定位步骤。带参考文献的论文把第三步换成compile_latex_then_run_bibliography_on_jobbibliography_toolautopost_bibliography_latexmk_passes1或2。如果仍有问题再调analyze_bibliography_log加read_project_file读.blg。插图路径排查则用parse_tex_dependencies看includegraphics边与graphicspath对缺失资源用list_latex_related_files核对。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错来。你大概率会碰到下面几类。401 Unauthorized最常见。原因通常是 Key 没填对、Key 过期、或者 Base URL 写成了带路径的完整接口地址而不是基址。检查TAOTOKEN_BASE_URL是否为https://taotoken.net/apiKey 是否从 API Keys 页面复制完整有没有多余空格。如果客户端支持先用模型对话入口单独测一次 Key 是否可用排除 Key 本身的问题。local proxy failed / connection refusedMCP 服务进程没起来或者端口/stdio 通道断了。先看客户端日志里 MCP 进程的启动输出确认python -m texstudio_mcp能手动跑起来。如果手动跑报ModuleNotFoundError说明包没装到当前 Python 环境检查command指向的 Python 是不是你装包的那个。reading choices / 返回结构解析失败这类报错通常出现在模型侧返回格式和客户端预期不一致时。检查 Model ID 是否填了客户端不支持的模型或者 Base URL 指向的端点与客户端协议不匹配。把 Model ID 换成明确可用的再试一次。如果客户端日志里能看到原始响应对比一下是不是 JSON 结构问题。OAuth / 认证跳转失败部分客户端默认走 OAuth 流程但你的接入方式是 Key 直连。在客户端设置里找“使用 API Key”或“自定义 Base URL”选项关掉 OAuth 自动流程。如果客户端强制 OAuth考虑换用支持 Key 直连的客户端或者用 CLI 方式先验证。concurrent_workspace_exclusive_blocked同一 MCP 进程、同一workspace_root不能并行编译。如果你开了多个 Cursor 窗口或多个 MCP 实例指向同一文件夹仍可能同时写。解决办法是串行化或者给不同实例配不同workspace_root。PDF/SyncTeX 缺失read_pdf_metadata或resolve_synctex_*报错先确认工程内已有.pdf和.synctex.gz通常编译后才有再确认pdfinfo、pdftotext、synctex在 PATH 里。health_check_tex_toolchain能帮你一次性看清哪些缺。ChkTeX 退出码非 0这是正常的有告警时退出码可能非 0ok也可能为 false但warnings里仍有条目可读。别把它当成致命错误读warnings就行。排障时如果怀疑是 Key 或接入参数问题去 API Keys 页面核对再对照接入文档检查字段名。验证模型是否通用模型对话入口单独发一条消息最快。长期编码或 Agent 场景考虑 Coding Plan 把额度规划好。6. 把 MCP 调用链固定下来从单次验证到日常写作跑通一次验证之后真正省时间的是把调用链固定成日常习惯。我的做法是每次开新章节先让 Agent 调read_texstudio_profile_snapshotinclude_parsed_hintstrue拿到suggested_job_basename对齐 TeXstudio 里最近打开的那篇稿子然后parse_tex_dependencies扫一遍依赖确认没有漏掉的\input和缺失插图改稿用replace_project_lines改完立刻compile_latex_document失败就analyze_latex_log。这一套下来AI 不再是“建议框”而是真的在你的工程里干活。几个实用技巧workspace_root尽量对齐 TeXstudio 的工作目录减少路径歧义大段latexmk输出别指望 MCP 返回全文让它读工程内.log文件.bib校验在提交前跑一次validate_bib_file能挡掉重复 key 这种低级错误多文件书稿用workspace_manifest枚举资源树重构目录前先画依赖图。能力边界心里有数它不替代完整 IDE不提供 PDF 预览 UI 和编辑器交互同步编译收敛有限复杂引用仍可能需要手动多编几次单进程互斥多实例同文件夹仍可能冲突日志是截断的TeX 工具需本机安装MCP 包本身不含 TeX Live。如果你还没配好 Key先去https://taotoken.net/api-keys拿 Key再对照https://taotoken.net/doc检查接入参数。模型侧验证用https://taotoken.net/chat长期编码或 Agent 场景看https://taotoken.net/coding-plan。把这三件套填进你的 MCP 配置重启客户端从那个故意报错的最小main.tex开始跑一遍链路就通了。