MCP 集成
通过 Model Context Protocol 将 AI 助手直接连接到您的 Clarity 工作区。
Model Context Protocol (MCP) 是一个开放标准，允许 AI 助手（如 Claude Desktop、Cursor 和 Windsurf）与外部工具和服务交互。Clarity 的 MCP 服务器将您的工作区变成一个实时、AI 可访问的环境。
MCP 能做什么？
启用 MCP 后，您的 AI 助手可以：
- 列出 您所有的 Clarity 项目并浏览文件树
- 读取 和 写入 项目中的任何文件
- 创建 新文件（LaTeX、Typst、BibTeX 等）
- 删除 文件（对主文件有安全保护）
- 编译 LaTeX 和 Typst 文档并自动 调试 错误
- 搜索 Typst 文档 —— 查阅语法、函数和模式
- 生成 TikZ 插图 —— 创建专业的图表和图形
全程无需离开您的 AI 客户端。无需复制粘贴，无需切换上下文。
工作原理
Clarity 提供一个包含 11 个工具 的 MCP 服务器，它在您的本地机器上运行，并通过标准的 stdio 传输协议与 AI 客户端通信：
- 1您在 Clarity 设置中生成一个 API 密钥
- 2在您的 AI 客户端配置中将 Clarity 添加为 MCP 服务器
- 3AI 客户端以子进程的方式启动 Clarity MCP 服务器
- 4服务器使用您的 API 密钥进行身份验证，并将请求代理到 Clarity 后端
- 5您的 AI 助手现在可以完全访问您的工作区
MCP 服务器是一个轻量级的 Node.js 进程 —— 空闲时不占用资源，启动时间不到一秒。
架构
您的 API 密钥用于认证每个请求。服务器从不存储您的密钥 —— 它在启动时从环境变量中读取。
快速链接
- 设置指南 —— Claude Desktop 和 Cursor 的分步说明
- 工具参考 —— 所有 11 个 MCP 工具的详细文档
- API 密钥与安全 —— 密钥的工作原理、安全实践和威胁模型
这对您有帮助吗？