通过 MCP 使用 Airparser 提取文档数据
将您的 AI 智能体连接到 Airparser,以上传文档、使用已保存的提取模式,并获取结构化 JSON。通过兼容的 MCP 客户端使用您现有的收件箱和解析工作流程。
AI技术栈的一部分
使用Airparser作为结构化文档数据的系统,而AI智能体则负责推理工作流程、异常和后续操作。
使用真实的管道
智能体可以检查收件箱、查看解析历史、更新模式并测试后处理,而不仅仅是一次性的文件分析。
可重复的输出
保留结构化提取的优势:保存的模式、文档历史,以及智能体可以随时间使用和改进的后处理逻辑。
为什么Airparser MCP与众不同
与基本的手动上传加提示词的方式相比,Airparser MCP 为智能体提供已保存的收件箱、提取模式、文档历史记录和可复用的后处理。
基本的手动上传加提示词方式
- 一次只能处理一份文档
- 没有保存的提取模式
- 没有文档历史或收件箱上下文
- 没有可重复的后处理层
使用Airparser MCP
- 智能体可以处理收件箱、模式和解析后的文档
- 结构化、可重复的输出始终是核心
- 模式和后处理的更改可以被测试和改进
- 解析后的数据能在更广泛的AI驱动工作流程中使用
用户使用Airparser MCP能做什么
最大的优势不仅仅是提取本身,而是为AI智能体提供改进文档工作流程所需的上下文和控制能力。
分类和路由收到的文档
在进入正确的解析工作流程之前,区分发票、简历、采购订单和配送文件。
回填历史邮件和文件
从其他应用导入旧邮件、附件和文档,更快地重建管道,并从过去的业务中恢复结构化数据。
生成和更新提取模式
当布局变化时,智能体可以帮助调整字段和模式结构,而不必让您的团队手动重新配置一切。
编写和测试后处理代码
在解析后的数据导出到下一个系统之前,让智能体帮助清理、规范化、丰富和重构数据。
实际发生了什么,以及在哪里发生
已对照当前的 Airparser MCP 服务器(17 个工具)核实过 —— 这里没有任何猜测。
| 查看收件箱及其模式,或获取文档的解析后 JSON | Airparser MCP —— list_inboxes、get_inbox、get_extraction_schema、get_document、list_documents(均为只读) |
| 创建收件箱、上传并处理文档、编辑模式,或编写后处理代码 | Airparser MCP 中会创建或更改内容的单独工具(create_inbox、upload_document_sync、update_extraction_schema、save_postprocessing_code 等)—— 与上面的只读工具不同 |
| 从 Gmail 获取邮件,或将结果写入另一个应用 | 在您的智能体中配置的另一个连接器或工具。Airparser MCP 本身无法直接访问其他应用。 |
| 保留文档以供审核并批准结果 | 请检查该收件箱自身的审核设置 —— Airparser MCP 目前没有专门的批准工具。 |
需要 Airparser 账户和兼容的 MCP 客户端。工具名称及其可用性取决于您当前的 Airparser MCP 服务器版本 —— 在依赖某个具体工具之前,请先检查客户端的工具列表。
真实示例
PDF → 已保存的模式 → JSON,智能体获取数据的方式
下方的模式属于 PDF 表格解析器页面所使用的同一个演示收件箱 —— 如今可通过 Airparser MCP 及以下步骤访问。这个具体示例的确切来源,请参见结果下方的说明。
智能体的操作步骤
- 1将兼容的 MCP 客户端(Claude、ChatGPT 或其他支持 MCP 的智能体)连接到您的 Airparser 账户。
- 2列出收件箱,并打开具有正确模式的那一个(list_inboxes、get_inbox)。
- 3读取该收件箱当前的提取模式(get_extraction_schema)。
- 4上传文档并等待解析完成(upload_document_sync)。
- 5读取解析后的 JSON(get_document)—— 或使用 list_documents 以便日后再次找到它。
示例提示词
使用演示收件箱及其现有的提取模式。上传这个示例 PDF,等待解析完成,然后返回提取出的 JSON。不要更改收件箱的模式或后处理设置。如遇解析错误请如实报告,不要编造缺失的值。
该收件箱的提取模式
6 个标量字段,外加一个每行 5 列的重复“items”列表 —— 对象加明细行,这是买家最常询问的结构。
已解析的明细行
| item_code | description | quantity | unit_price | line_total |
|---|---|---|---|---|
| WH-1001 | Steel bolt M8 x 40 mm, zinc plated (box of 100) | 12 | 14.50 | 174.00 |
| WH-1002 | Hex nut M8, zinc plated (box of 100) | 12 | 9.80 | 117.60 |
| WH-1015 | Flat washer M8, stainless (box of 200) | 8 | 11.25 | 90.00 |
| WH-1120 | Cable tie 300 mm, black (pack of 100) | 25 | 4.60 | 115.00 |
| WH-1121 | Cable tie 200 mm, natural (pack of 100) | 20 | 3.75 | 75.00 |
| WH-1210 | Work gloves, nitrile coated, size L (pair) | 40 | 2.90 | 116.00 |
| WH-1211 | Safety glasses, clear lens, anti-fog coating | 30 | 3.40 | 102.00 |
| WH-1305 | Duct tape 48 mm x 50 m, silver | 18 | 5.20 | 93.60 |
| WH-1306 | Masking tape 24 mm x 50 m | 24 | 2.35 | 56.40 |
| WH-1410 | LED work light, rechargeable, 10 W, with magnetic base | 6 | 27.90 | 167.40 |
| WH-1411 | Extension cord 5 m, 3 x 1.5 mm2, indoor use | 10 | 12.60 | 126.00 |
| WH-1502 | Pallet wrap film 500 mm x 300 m, clear | 15 | 8.40 | 126.00 |
| WH-1503 | Packing tape 48 mm x 66 m, brown | 36 | 1.95 | 70.20 |
| WH-1620 | Storage bin 600 x 400 x 220 mm, stackable, with lid | 14 | 9.15 | 128.10 |
| WH-1621 | Label roll 100 x 150 mm, direct thermal (roll of 500) | 10 | 13.70 | 137.00 |
| WH-1700 | Hand truck, folding, 70 kg capacity | 2 | 64.00 | 128.00 |
这个具体结果是在 2026-09-19 通过应用程序(Vision 引擎)在该收件箱的模式上获取的,并在当时逐行与源 PDF 核对过。在本次更新期间,我们还通过 Airparser MCP 的 upload_document_sync 将同一文件运行了两次:一次返回 16 行中的 15 行,另一次返回 16 行中的 9 行,收件箱设置相同。我们尚未确定原因,因此请将上面的模式和步骤视为准确的,但不要将这个 16/16 的结果视为新运行也能重现它的保证。版式、扫描质量和文档长度总体上也会影响结果——在依赖它处理生产量级文档之前,请先用您自己的文档进行测试。
想用您自己的文档试试吗?
免费开始MCP工作流程示例
当文档只是更大规模AI辅助流程的一部分时,Airparser MCP尤其有用。
运营团队
- 「查看我们的收件箱,告诉我根据最新文档,哪些模式可能需要更新。」
- 「获取最新解析的发票,标记缺失的总额,并测试后处理修复方案。」
- 「将我们邮箱中的历史附件回填到Airparser,以便我们重建报告。」
AI产品开发者
- 「为这些配送文件创建一个模式,并在最新上传的文件上进行测试。」
- 「获取解析后的JSON,并将结果发送到下一个智能体步骤进行验证和路由。」
- 「使用Airparser进行提取,然后让智能体更新电子表格、发送邮件或触发后续操作。」
买家关于 Airparser MCP 常问的问题
这和在聊天中上传 PDF 有什么不同?
基本的手动上传加提示词方式只读取一份文档、读取一次,且不保存任何内容。Airparser MCP 则使用已保存的收件箱来工作:相同的提取模式、文档历史记录,以及您的智能体可以在下一份文档中复用的后处理逻辑 —— 不仅仅是这一份。
我可以提取自己的字段、对象和明细行吗?
可以。Airparser 的提取模式支持标量字段、嵌套对象、重复列表(明细行)和枚举 —— 本页的示例中明细行使用的就是列表字段。结果取决于文档版式的一致程度。
模式是如何工作的我需要写代码吗?
不需要。连接受支持的 MCP 客户端并使用现有的收件箱和模式不需要写代码。围绕结果构建自定义自动化 —— 按自己的逻辑将 JSON 路由到其他系统 —— 是另一个可选的独立步骤,可能需要代码或 Zapier、Make、n8n 这类无代码工具。
智能体究竟能对我的账户做哪些更改?
读取工具会获取已有的数据——收件箱、其模式,或已解析的文档。写入工具可以创建收件箱、上传并处理新文档、更改模式,或编辑后处理代码——具体哪个是哪个,请参见上表。工具名称的区分并不能阻止智能体自行调用写入工具;您的 MCP 客户端在运行写入工具前是否会要求确认,取决于该客户端,而非 Airparser MCP。
智能体能直接读取我的 Gmail 吗?
仅靠 Airparser MCP 本身不能。Airparser 可以通过邮件转发或在收件箱上配置的 IMAP/Gmail 导入来接收文档;要让智能体将读取 Gmail 作为单独的操作,需要在 Airparser MCP 之外,在您的智能体中配置自己的连接器或集成。
如果结果需要审核后才能使用,该如何处理?
为该收件箱开启审核,并选择结果的投递方式 —— 例如,在已连接的集成接收数据之前先等待批准。Airparser MCP 本身目前没有单独的批准工具;审核在应用内进行,或通过您配置的投递设置进行。
人工审核(HITL)将Airparser MCP连接到您的AI工作流程
从一个真实的使用场景开始:检查收件箱、查看解析后的文档、更新模式,或测试后处理步骤。
