都有。开放 API：石墨文档与石墨办公都提供 API，企业可把文档与知识能力接入自有 workflow、Agent 与 AI 应用，SaaS 与私有部署口径一致。CLI：私有部署环境可用，通过通用 CLI 适配不同类型的 Agent，与私有部署的石墨办公环境通讯。
还有一件事要先说清：石墨办公不提供 MCP Server。业界常见做法是把工具包成 MCP Server 供 Agent 调用；石墨办公不提供 MCP Server，Agent 接入统一走 CLI 与 API。这是接口形态的选择，下面把两条通道各自能做什么讲清楚。
一、API 与 CLI，分工不同
同一个动作，两条通道的差别在“谁发起”：系统按流程发起用 API，Agent 按对话意图发起用 CLI。
| 通道 | 谁发起 | 典型场景 | 需要注意 |
|---|---|---|---|
| 开放 API | 业务系统、脚本、定时任务 | 批量创建与转换、把结果写回业务系统 | 按接口约定处理鉴权、幂等与重试 |
| 通用 CLI | Agent、自动化助手 | 读取检索、创建文档、编辑与结构化处理 | 写前检查远端版本，冲突时重拉重试 |
别把两者当替代品：API 稳定、可编排，适合固定流程；CLI 更贴近“边看边改”的会话式操作。真实项目里常见的是组合——API 做批处理，CLI 做单次任务。
二、CLI 能做的几件事
CLI 的能力边界写在公开发布说明里，列清楚反而好判断。目前明确支持的是这几类：
- 轻文档：创建、连接、读取与更新正文；写前检查远端版本，冲突时重拉重试。
- 表格：读写单元格、追加与删除行、导入 xlsx、导出 CSV 与 XLSX。
- 附件：插入图片，以及 PDF 与 Office 附件。
- 批量：读取文件夹内的轻文档，把归纳结果写进一份新文档。
表格类操作建议先在副本上跑：导出可以重来，追加与删除行不行。
清单之外的不要假设。比如“能不能改幻灯片版式”“能不能批量重命名文件夹”，公开说明没列，就要按项目问，别在方案里写“应该支持”——集成阶段的返工多半来自这种默认。
还有一条对审计有用：据 CLI 版本迭代说明，从 0.2.1 起每次轻文档写入必须声明实际使用的模型家族（如 claude、deepseek、gpt、qwen），并与登录用户身份分开记录；未修改的内容保留原有来源。这条能回答“这段字是谁写的”，但具体字段与落库方式以版本说明为准，别当成本文实测结论。
三、Agent 接进来，能做哪些事
按公开说明，Agent 与私有部署的石墨办公环境通讯后可以做四类事：读取和检索文档、创建文档并生成内容、编辑补充与结构化处理、转换文档格式，并把任务结果写回。对接对象覆盖企业自研 Agent 与国内、国外的 Agent 入口。
边界要提前写进方案：Agent 用什么身份、能碰哪些空间、写回失败怎么补偿。可行的做法是给它一个受限成员账号，配文件与空间授权，用操作留痕回溯——这是我们建议的管理做法，不是“智能体专属账号”之类的产品能力。把这条写进方案，比事后追责有用。
落地时最容易低估的是“写回”。至少做三项验收：让它读一份没授权的文件（应被拒绝）、让它在一份同事正在编辑的文件上写入（应给出冲突处理而不是覆盖）、断网后重试一次（不应重复写入）。半天能测完，比看演示有用。
四、没有 MCP Server，接入方式怎么选
结论再重复一次：石墨办公不提供 MCP Server，Agent 接入走 CLI 与 API 两条路。剩下的问题只是选哪条。
| 任务 | 建议通道 | 验收看什么 |
|---|---|---|
| 批量生成一批文档并归档 | API | 幂等、失败重试、文件落到哪个目录 |
| Agent 读几份材料再写一份新稿 | CLI | 读到的是哪个版本、写回到哪、来源有没有记录 |
| 定时把表格数据导给业务系统 | API 或 CLI | 导出格式、字段对齐、重复执行的结果 |
| 业务系统页面里直接编辑 | JSSDK 嵌入 | 权限映射、事件回调、撤权后是否失效 |
最后一行常被混进同一个需求里：先把“人在页面上改”和“Agent 在后台改”分开，权限与审计才说得清。前者走前端嵌入，后者走 CLI 或 API，混着设计，最后一定在“谁改了这份文件”上卡住。
想对着接口清单确认，可以看文档中台私有部署的产品页与办公套件私有部署的产品页，能力边界以产品事实页为准；要按你们的 Agent 做一次联调，直接约演示。也可以先看私有化部署方案，了解部署形态与交付范围。
常见问题
有没有开放 API？
有。石墨文档与石墨办公都提供 API，企业可以把文档与知识能力接入自有 workflow、Agent 与 AI 应用，SaaS 与私有部署口径一致。具体接口范围、鉴权方式与调用限制以开发文档与项目方案为准，不同版本可能有差异，接入前让技术同学对一遍清单。
CLI 怎么接 Agent？
用通用 CLI 适配不同类型的 Agent，与私有部署的石墨办公环境通讯；私有部署环境可用。落地时先定三件事：Agent 用哪个受限账号、能访问哪些空间、写回失败怎么补偿。CLI 支持的能力见公开发布说明，清单外的能力要按项目确认，不要在方案里先写死。
智能体能做哪些操作？
四类：读取和检索文档、创建文档并生成内容、编辑补充与结构化处理、转换文档格式，并把任务结果写回。CLI 层面具体到轻文档正文的读写、表格单元格与行的读写、导入 xlsx 与导出 CSV/XLSX、插入图片与附件、批量读取文件夹内的轻文档。
有没有 MCP？
没有。石墨办公不提供 MCP Server，Agent 接入统一走 CLI 与 API。如果你们的 Agent 框架只支持 MCP，需要在 Agent 侧做适配，或改用能直接调用 CLI 与 API 的方式，这一点要在方案阶段就确认。