假设你有一个合同文件夹，需要每个合同的首页或签名页进行审阅。使用带有 GroupDocs.Merger.Mcp 服务器的 AI 代理，只需一次提示，就能在本地机器上完成此操作，可在 Claude Desktop、Claude Code、Cursor 或带有 GitHub Copilot 的 VS Code 中使用：

提取我的文档文件夹中每个 PDF 的第 1 页，并列出你生成的内容。

带有配置和故障排除的逐步版本请参阅文档：How to extract pages from many documents at once。

代理对文件夹中的文件会做什么？

对于每个文件，代理会调用一次 split 工具。每次调用会生成一个单页文档。一个包含 40 份发票的文件夹因此会产生 40 张封面页。该工具没有文件夹模式；代理提供循环，引擎对每个文件执行页面提取。文件通过 GROUPDOCS_MCP_STORAGE_PATH 配置的文件夹内的名称来解析，因此代理传递的是 invoice-014.pdf，而不是你机器上的路径。

如何将提取的页面保存在原始文件夹之外？

四十个提取的页面与四十个原始文件放在一起，会形成一个没人愿意浏览的文件夹。将 GROUPDOCS_MCP_OUTPUT_PATH 设置为单独的目录，结果就会存放在源文件之外。如果不设置，输出会写入存储文件夹。这是一次性设置，之后的每个批量提示都会保持整洁。

如何提取最后一页或会变动的页面？

“最后一页”在每个文件中的页码都不同。让代理先对每个文档调用 get_document_info。它会返回 pageCount，因此代理可以为每个文件计算页码：

对于文件夹中的每个 PDF，先检查页数，然后提取每个文件的最后一页。

如果代理进行猜测，在猜错的文件上会失败。错误是针对单个文件的，并不会导致整体失败。

最常出现的变体有哪些？

提取每个文档的最后一页。先检查页数。

从每份合同中提取第 2 页，然后将所有页面合并为一个审阅文件。

对每个文件，提取签名页并将结果放入输出文件夹。

第二个提示会将 merge 链接起来，每轮最多处理四个文档，这样就能得到一个由每个源文件的单页组成的合并文档。超过四个源文件则需要多轮。签名页提示在你告诉代理签名所在页码时有效；工具只提取你提供的页码，不会搜索内容。

何时每个文件夹使用一次提示最合适？

当同一规则适用于每个文件时使用：首页、末页、已知的签名页。提示只需声明一次规则，代理会逐文件应用。归档和法律审查工作符合这种模式：为每个文件提取封面页用于索引，或提取每份合同的签名页进行核对。如果规则因文件而异，可将文件夹拆分为多个组，对每组运行一次提示，这样每个提示仍只包含单一规则。请在每个批量提示中保留指令“列出你生成的内容”；该列表就是你处理了哪些文件的记录。

示例会话（节选）

基于文档中工具行为的示例说明，并非实际截图。

You:   Extract page 1 from every PDF in my documents folder and
       list what you produced.

Agent: Found 3 PDFs in the folder.
       [calls split on each file with pages = "1"]
       Extracted page 1 from all 3 files: 3 single-page documents
       in your output folder. No failures.

大批量文件中可能出现的问题有哪些？

  • 失败是针对单个文件的。 损坏或受密码保护的文档会导致其自身调用失败。请将失败以列表形式请求，这样 40 个文件的批次不会隐藏两个错误。split 工具接受 password 参数用于受保护的文档。
  • 文档页数不足。 请求不存在的页码会导致该文件失败；其他文件不受影响。
  • 计量使用会累计。 在计量授权下，每次调用都会计费。

真实的限制

  • 评估模式会将合并输出裁剪至 3 页。 结果会被裁剪为前 3 页，并在每页显示试用徽章。单页提取不受影响，但一旦合并结果，限制会悄然生效。由四十个首页构建的合并审阅文件最终只会返回三页。运行前请检查 get_license_status。
  • 不支持内容搜索。 代理通过页码选择页面。寻找“带有签名的页面”是你的指令，而非工具功能。
  • 工具没有文件夹模式。 每次 split 调用只能处理一个文件，因此大型文件夹会产生大量调用。

常见问题

如何从文件夹中的所有 PDF 提取首页？ 将服务器指向该文件夹，然后询问：“提取我的文档文件夹中每个 PDF 的第 1 页，并列出你生成的内容。” 代理会对每个文件调用 split。

AI 能批量拆分文档并将页面收集到一个文件中吗？ 可以。提取完成后，要求代理以每四个文件为一轮合并单页文件。在评估模式下，合并后的文件会被裁剪至 3 页。

文件会离开我的机器吗？ 不会。服务器读取并写入你配置的文件夹，通过本地 stdio 传输，无需任何入站端口。

深入了解