# MCP 工具

Canonical: https://heeditapp.com/docs/connections/mcp/
Language: zh-CN

MCP 是 Agent → Heedit 的执行通道。Skill 可以教 Agent 怎么调用，但不能替代真实连接的 MCP server。

## 从能力探测开始

先调用 get_capabilities。再用 open_document 或 list_documents，随后只调用所需的最小正文读取动作。Markdown 上下文、选区和大纲每次读取都需要用户确认。

```
get_capabilities
open_document / list_documents
list_inbox_files / read_inbox_files / record_inbox_delivery
get_context_packet / get_selection / get_outline
reveal / highlight
export_document
```

## 明确 MCP 不做什么

export_document 可在确认输出路径后，把指定 Markdown revision 导出为 PDF。revise_selection 当前不可用，Heedit MCP 也不提供通用文件写入工具；Agent 通过它自身获准的环境修改文件。批注通过 list_annotations、get_annotation、register_output 或等价的 heedit annotations 命令处理。