TUNC.AI / Tunc Doc 示例

Tunc Doc 示例与智能体搭法提示词

Tunc Doc 的三种可用搭法,每种都配一段智能体照着做的提示词:云端文档、表格和演示稿,Word/Excel/PowerPoint 的导入导出,以及脚本。

更新于

下面每种搭法都从一段提示词开始:把它贴给智能体,剩下的由智能体做。不要把 API 密钥放进提示词:用环境变量或密钥管理交给你的工具。Tunc Doc 文档里有每个调用;这一页有的是能用的搭法。

让你的智能体连接到 Tunc Doc

在 Claude 里最快的方式是一个填好内容的链接。它会打开“Add custom connector”,名称和地址已经填好;核对一下再确认。

把 Tunc Doc 加到 ClaudeClaude 免费版只允许一个自定义连接器。Team 和 Enterprise 由 Owner 添加。

在 Claude Code、Cursor,或任何能运行命令、能改自己设置的智能体里,把下面这段贴进去。它会添加连接、等你登录,然后测试一次:

把这段贴给你的智能体
把 Tunc Doc 连接到这个会话。它的 MCP 服务器是 https://mcp.tuncdoc.com/mcp。如果你能运行命令,就运行:claude mcp add --transport http tunc-doc https://mcp.tuncdoc.com/mcp。否则把它加到我的 MCP 设置里。然后让我登录(在 Claude Code 里:运行 /mcp,选择 tunc-doc,再 Authenticate),等我确认。之后测试一次:创建一份标题为“连接测试”、Markdown 为“# 你好\n\n能用了。”的文档,再读回来,然后删除。告诉我你做了什么,以及返回了什么。

在 ChatGPT,或者任何通过菜单添加连接器的应用里,让智能体读说明并一步步带你做:

把这段贴给你的智能体
读 https://tuncdoc.com/llms.txt,按菜单一步一步告诉我怎么把 Tunc Doc 接到这个应用里。用登录的方式,不要用 API 密钥。如果这个应用需要特殊模式才能添加连接器,告诉我是哪一个。

智能体可以添加连接,但不能替你登录:你在浏览器里授权一次,并选择它可以做什么。想手动做的话,每个客户端的步骤都在下面:

客户端步骤
claude.ai, Claude Desktop and Claude mobileCustomize → Connectors → Add custom connector → 名称填 Tunc Doc,URL 填 https://mcp.tuncdoc.com/mcp → Add → Connect。免费版只允许一个自定义连接器;Team 和 Enterprise 由 Owner 在 Organization settings → Connectors 里添加。这个链接会打开对话框,名称和 URL 已经填好:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20Doc&connectorUrl=https%3A%2F%2Fmcp.tuncdoc.com%2Fmcp
Claude Code先添加服务器,然后运行 /mcp,选择 tunc-doc,再 Authenticate。
claude mcp add --transport http tunc-doc https://mcp.tuncdoc.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → 打开 Developer mode → Create → 名称填 Tunc Doc,URL 填 https://mcp.tuncdoc.com/mcp,Authentication 选 OAuth → Create → Connect。
Cursor加到 ~/.cursor/mcp.json,然后 Settings → MCP:会显示“Needs login” → Login。
{
  "mcpServers": {
    "tunc-doc": {
      "url": "https://mcp.tuncdoc.com/mcp"
    }
  }
}
VS Code (Copilot)命令面板 → MCP: Add Server → HTTP → https://mcp.tuncdoc.com/mcp → 名称 tunc-doc → 允许登录提示。
Gemini CLI加到 settings.json,然后运行 /mcp auth tunc-doc。
{
  "mcpServers": {
    "tunc-doc": {
      "httpUrl": "https://mcp.tuncdoc.com/mcp"
    }
  }
}
Copilot StudioTools → Add a tool → New tool → Model Context Protocol → URL 填 https://mcp.tuncdoc.com/mcp → Authentication 选 OAuth 2.0,Dynamic discovery。

用私密链接起草文档、表格或演示稿

要做的事:你想让助手做一份报告、一个带公式和图表的财务模型,或者一套可以在浏览器里打开、也能下载成 Word、Excel 或 PowerPoint 的演示稿。搭法:让智能体在 Tunc Doc 里建,然后把链接给你。

把这段贴给你的智能体
用 doc_create 创建一份标题为“Q3 项目回顾”的 Tunc Doc,包含摘要、关键指标和下一步,并把它的链接给我。
把这段贴给你的智能体
用 doc_create(kind 为 "sheet")创建一份标题为“2026 预算模型”的 Tunc Doc 表格,用 sheet_write 在 A1:E14 填入每月的收入和成本,合计用 SUM 公式,再用 sheet_add_chart 在 G2 加一个柱状图,并把链接给我。
把这段贴给你的智能体
在 Tunc Doc 里用 doc_create(kind 为 "deck")和 deck_add_slides 做一套 6 页的演示稿,标题为“客户提案”,用 deck_check 检查版式,并把链接给我。

每份文档、表格和演示稿都在登录后通过 tuncdoc.com 上的短私密链接打开。有编辑权限的人在电脑上的浏览器里可以切到 Write,和你的智能体一起编辑。

导入和导出 Word、Excel、PowerPoint 与 PDF 文件

要做的事:有人给你发了 DOCX 合同、XLSX 工作簿或 PPTX 演示稿,或者需要把你的 Tunc Doc 导出成 Office 文件或 PDF。搭法:智能体用 doc_import 导入,做精确的、带版本校验的修改,再用 doc_export 导出。

把这段贴给你的智能体
用 doc_import 把 proposal.docx 导入 Tunc Doc,然后用 doc_edit 的 mode "suggest" 提出让定价部分更紧凑的修改,这样我可以在页面上逐条接受或拒绝,并把链接给我。
把这段贴给你的智能体
用 doc_list 在 Tunc Doc 里找到我的“2026 预算模型”表格,用 doc_export(format 为 "xlsx")把它导出成 XLSX 工作簿,同时把 to_art 设为 true 存一份 PDF 到 Tunc Art。

智能体用 doc_edit 改精确的文本(要么全部生效要么全都不生效),用 sheet_write 和 sheet_ops 原子地改表格,用 deck_edit 按幻灯片和元素 id 改演示稿。每次改动都是 doc_history 里的一个版本,可以用 doc_restore 恢复。

用脚本生成文档和 Office 导出

要做的事:一个定时脚本或后端任务需要把数据变成排版好的文档、表格或演示稿,并导出成 PDF、DOCX、XLSX 或 PPTX。搭法:用 API 密钥调用 Tunc Doc 的 REST API。

在 https://tunchub.com/account/keys/new?product=doc 创建一个带读取和保存权限的 API 密钥,用环境变量传给脚本。然后把下面这段贴给你的编码智能体:

把这段贴给你的智能体
写一个脚本 publish_doc.py,通过 https://api.tuncdoc.com/v1/docs 在 Tunc Doc 里创建一份每周报告,然后通过 https://api.tuncdoc.com/v1/tool 把它导出成 PDF(调用 doc_export,format 为 "pdf")。从环境变量 TUNC_API_KEY 读 API 密钥,永远不要打印出来。结束时打出文档链接。请求的具体形状看 https://tuncdoc.com/docs。

然后问任何一个已连接的助手:

把这段贴给你的智能体
用 doc_list 列出我在 Tunc Doc 里最新的 5 份文档,用 doc_read 读最新的那份每周报告,并总结改了什么。

把文档直接导出到 Tunc Art

Tunc Doc 是你和智能体一起撰写和修改文档、表格或演示稿的地方。当某个版本要作为固定的 PDF、DOCX、XLSX 或 PPTX 文件交出去时,带 to_art 的 doc_export 会把它存到 Tunc Art,并带自己的私密链接。

把这段贴给你的智能体
用 doc_export 把 Tunc Doc 里的“Q3 项目回顾”导出成 PDF,并把 to_art 设为 true,然后同时把 Tunc Doc 的链接和 Tunc Art 的链接给我。

值得知道的

  • 一份文档最多 1 MiB 的 Markdown 文本。导入的文件(DOCX、PPTX、XLSX、XLS、ODS、CSV、Markdown)最大 16 MiB:一次 MCP 调用约 3 MiB,更大的文件走 REST 导入接口。
  • 每次编辑都校验版本:doc_edit 的改动要么全部生效要么全都不生效,doc_write 建立在一次完整的 doc_read、doc_create,或者没有返回标记的 doc_write 之上。
  • 在工作区里创建的文档对该工作区成员可见;没有工作区的文档只属于它的所有者。
  • 你的账号页面在 https://tunchub.com/account,可以看到存储用量和已连接的智能体。