name: PandaDoc 自动化 description: “通过 Composio PandaDoc 集成,自动化文档工作流 – 从文件创建文档、管理联系人、组织文件夹、设置 Webhook、创建模板以及跟踪文档状态。” requires: mcp: - rube
PandaDoc 自动化
直接在 Claude Code 中管理 PandaDoc 文档工作流。从上传的文件创建文档、管理收件人和联系人、使用文件夹进行组织、设置事件 Webhook、创建模板并跟踪文档状态,无需离开终端。
工具包文档: composio.dev/toolkits/pandadoc
设置
- 将 Composio MCP 服务器添加到您的配置中:
https://rube.app/mcp - 当提示时连接您的 PandaDoc 账户。代理将提供一个 OAuth 链接进行身份验证。
- 确保您的 PandaDoc 工作区有适合所需功能的计划(例如,电子签名、模板、Webhook)。
核心工作流
1. 从文件创建文档
上传 PDF、DOCX 或 RTF 文件,创建新的 PandaDoc 文档,指定收件人进行签名和跟踪。
工具: PANDADOC_CREATE_DOCUMENT_FROM_FILE
关键参数:
name(必需)-- 文档名称recipients(必需)-- 收件人对象数组,每个对象包含:email(必需)-- 收件人邮箱first_name,last_name– 收件人姓名role–signer(默认)、approver或cc(每个收件人必须唯一)signing_order– 数字顺序(如果为某个收件人设置,则必须为所有收件人设置)
file– 上传的文件对象,包含name、mimetype和s3keyurl– 替代方案,文件的公共 HTTPS URLparse_form_fields(默认 false)-- 解析 PDF 表单字段tags– 分类字符串数组owner– 文档所有者(邮箱或 membership_id)
示例提示: “从 contract.pdf 创建一个 PandaDoc 文档,john@example.com 作为签署者,jane@example.com 作为批准者”
2. 获取文档详情
获取文档的全面元数据,包括收件人、字段、令牌、定价、标签和内容块引用。
工具: PANDADOC_GET_DOCUMENT_DETAILS
关键参数:
id(必需)-- 唯一文档标识符(例如,BhVzRcxH9Z2LgfPPGXFUqa)
使用此工具检查文档状态、查看收件人完成情况、审查字段值或收集报告元数据。
示例提示: “获取 PandaDoc 文档 BhVzRcxH9Z2LgfPPGXFUqa 的完整详情和状态”
3. 管理联系人
在 PandaDoc 中创建新联系人或更新现有联系人。通过邮箱匹配联系人 – 如果给定邮箱的联系人存在,则更新;否则创建新联系人。
工具: PANDADOC_CREATE_OR_UPDATE_CONTACT
关键参数:
email(必需)-- 联系人邮箱地址first_name,last_name– 联系人姓名company– 公司名称job_title– 职位/头衔phone– 电话号码street_address,city,state,postal_code,country– 地址字段
示例提示: “为 john.doe@example.com 在 Acme Corp 创建 PandaDoc 联系人,职位为软件工程师”
4. 使用文件夹进行组织
创建文件夹并移动文档,以组织您的 PandaDoc 工作区。
工具: PANDADOC_CREATE_FOLDER, PANDADOC_LIST_DOCUMENT_FOLDERS, PANDADOC_MOVE_DOCUMENT_TO_FOLDER
用于创建文件夹:
name(必需)-- 文件夹名称parent_uuid– 父文件夹 UUID,用于嵌套结构
示例提示: “在 PandaDoc 中创建 ‘2026 年第一季度合同’ 文件夹,并将文档 BhVzRcxH9Z2LgfPPGXFUqa 移动到其中”
5. 设置 Webhook
创建 Webhook 订阅,以在文档事件发生时接收实时通知。
工具: PANDADOC_CREATE_WEBHOOK
关键参数:
name(必需)-- Webhook 的描述性名称url(必需)-- 通知端点 URLtriggers(必需)-- 事件类型:document_state_changed、recipient_completed、document_updated等active(默认 true)-- 启用/禁用 Webhookpayload– 包含的额外数据:fields、products、metadata、tokens、pricing
示例提示: “设置 PandaDoc Webhook,当文档状态更改或收件人完成时通知 https://api.example.com/hooks”
6. 创建模板
从 PDF 文件或从头开始创建可重用模板,使用结构化内容块。
工具: PANDADOC_CREATE_TEMPLATE
关键参数:
name(必需)-- 模板名称file_path– PDF 文件路径,用于模板创建content– 结构化内容对象,包含title和blocks数组,用于从头构建description– 模板描述tags– 分类标签
示例提示: “从 nda-template.pdf 文件创建名为 ‘标准 NDA’ 的 PandaDoc 模板”
已知陷阱
- 收件人角色唯一性: PandaDoc API 不允许在单个文档中存在重复角色。每个收件人必须有唯一的
role值(例如,signer、signer_2、approver、cc)。 - 签署顺序一致性: 如果为任何收件人指定
signing_order,则必须为文档中所有收件人指定。部分排序将导致错误。 - 文件上传要求: 必须提供
file(带s3key)或url进行文档创建,不能两者都提供。URL 必须是可公开访问的 HTTPS。 - 联系人更新行为:
PANDADOC_CREATE_OR_UPDATE_CONTACT通过邮箱匹配。如果需要更新联系人的邮箱本身,必须创建新联系人并单独处理旧联系人。 - 文档 ID 格式: 文档 ID 是字母数字字符串(例如,
BhVzRcxH9Z2LgfPPGXFUqa)。创建文档时返回,可以通过 PandaDoc 仪表板找到。 - Webhook 事件命名: 触发事件名称必须完全匹配(例如,
document_state_changed,而不是stateChanged或state_changed)。查看 PandaDoc API 文档获取完整列表。 - 文件夹操作需要 UUID: 移动文档需要文档 ID 和目标文件夹 UUID。首先列出文件夹以获取正确的 UUID。
- 模板内容块: 从头创建模板时,
blocks数组必须包含根据 PandaDoc 模式的有效内容块对象。查看其 API 文档获取支持的块类型。
快速参考
| 工具 Slug | 描述 |
|---|---|
PANDADOC_CREATE_DOCUMENT_FROM_FILE |
从 PDF/DOCX/RTF 创建带收件人的文档 |
PANDADOC_GET_DOCUMENT_DETAILS |
获取完整文档元数据、状态和字段 |
PANDADOC_CREATE_OR_UPDATE_CONTACT |
通过邮箱创建或更新联系人 |
PANDADOC_CREATE_FOLDER |
创建文件夹进行文档组织 |
PANDADOC_LIST_DOCUMENT_FOLDERS |
列出所有文档文件夹 |
PANDADOC_MOVE_DOCUMENT_TO_FOLDER |
将文档移动到特定文件夹 |
PANDADOC_CREATE_WEBHOOK |
设置事件通知 Webhook |
PANDADOC_CREATE_TEMPLATE |
创建可重用文档模板 |
由 Composio 提供支持