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 金鑰與安全性 — 金鑰運作方式、安全實踐和威脅模型
這對您有幫助嗎？