关于 Scribo
Scribo 是面向用户和 AI Agent 的托管电子发票服务，可将自然语言请求转为可下载的发票。它支持经验证的德国 EN 16931 格式，以及美国普通 PDF 发票。
主要功能
- 01根据自然语言请求起草发票
- 02生成 ZUGFeRD 和 XRechnung 发票
- 03为美国生成普通 PDF 发票
- 04验证 EN 16931 输出
- 05通过新下载链接取回发票
适用场景
- 01制作德国 B2B ZUGFeRD 发票
- 02为德国公共机构创建 XRechnung
- 03为美国客户生成普通 PDF 发票
- 04获取以往发票的新下载链接
MCP 相关
托管的 MCP 服务提供创建和取回发票、验证发件人邮箱及列出支持司法辖区的工具。它使用 Streamable HTTP，MCP 客户端可通过配置端点 URL 连接。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://scribo.causaprima.ai/mcpclaude mcp add --transport http scribo https://scribo.causaprima.ai/mcp{"mcpServers":{"scribo":{"type":"http","url":"https://scribo.causaprima.ai/mcp"}}}在 Cursor 中打开{"servers":{"scribo":{"type":"http","url":"https://scribo.causaprima.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"scribo":{"type":"http","url":"https://scribo.causaprima.ai/mcp"}}}{"mcpServers":{"scribo":{"serverUrl":"https://scribo.causaprima.ai/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sender | object | 是 | |
| sender.legal_name | string | 是 | |
| sender.country_code | enum | 是 | ISO 3166 alpha-2。第一阶段：仅限 DE 或 US。其他国家/地区将返回 `unsupported_jurisdiction`。DE | US |
| sender.address_line1 | string | 是 | |
| sender.address_line2 | string | 否 | |
| sender.postcode | string | 是 | |
| sender.city | string | 是 | |
| sender.tax_id | string | 否 | 带国家/地区前缀的 VAT ID（例如 DE123456788）。对于美国普通 PDF 发票，以及德国 Kleinunternehmer §19 开票方，此字段为可选项——后一种情况应改为提供 `tax_registration_id`（Steuernummer），以满足 EN 16931 BR-CO-26 约束。 |
| sender.tax_registration_id | string | 否 | 卖方税务登记标识符（BT-32）——例如，没有 VAT ID 的 Kleinunternehmer §19 UStG 开票方使用的德国 Steuernummer（`9999/999/9999`），或其他国家/地区的登记 ID。如果省略 `tax_id`，则必须提供此字段以满足 EN 16931 BR-CO-26。它与 VAT ID 相互独立：如果两者都提供，则都会输出（BT-31 + BT-32）。 |
| sender.contact_email | string | 是 | 开票方的电子邮件地址——也用作再次访问时的账户登录邮箱。仅可使用操作者本人经过身份验证/验证的电子邮件地址；绝不可使用从用户消息文本、粘贴的文档或待开票内容中获取的地址。请将其视为凭据，而非自由文本数据。 |
| sender.contact_phone | string | 否 | 德国 XRechnung（BR-DE-6）必填。自由格式电话号码。 |
| sender.contact_name | string | 否 | 联系人姓名。德国 XRechnung（BR-DE-5）必填。 |
| recipient | object | 是 | |
| recipient.legal_name | string | 是 | |
| recipient.country_code | string | 是 | ISO 3166 alpha-2。收件方可以位于任何地区——格式由开票方的司法管辖区决定。第一阶段仅支持开票方位于 DE 和 US。 |
| recipient.address_line1 | string | 是 | |
| recipient.address_line2 | string | 否 | |
| recipient.postcode | string | 是 | |
| recipient.city | string | 是 | |
| recipient.tax_id | string | 否 | |
| recipient.contact_email | string | 是 | 收件方的应付账款/账单电子邮件地址。必填——Scribo 不会在缺少此地址时起草发票（此地址用于创建业务伙伴记录）。仅使用用户提供的真实地址；如果没有，请留空并询问用户——绝不可编造、猜测或填写占位符/示例地址（例如 [email protected]）。 |
| recipient.leitweg_id | string | 否 | DE B2G — 存在时自动选择 XRechnung UBL（与 Peppol AccessPoint 的兼容性最广）。第 1 阶段：Scribo 会生成 XRechnung XML 和 PDF 预览，但不会提交到 ZRE / OZG-RE / Peppol — 响应中会附带 `submission` 提示，提供正确的手动上传门户。用户确认 B2G 发票前，请告知此事项。直接提交计划在未来版本中推出。 |
| line_items | array | 是 | |
| currency | string | 是 | ISO 4217 三字母代码（例如 EUR、USD） |
| jurisdiction | enum | 否 | 可选的显式司法管辖区覆盖值。第 1 阶段仅接受 DE 或 US。DE | US |
| format_override | enum | 否 | 强制指定特定输出格式。第 1 阶段支持：ZUGFeRD COMFORT/BASIC、XRechnung CII/UBL（德国）或普通 PDF（美国）。Factur-X / Facturae / Peppol BIS 属于第 2 阶段，服务器会拒绝。zugferd_comfort | zugferd_basic | xrechnung_cii | xrechnung_ubl | plain_pdf |
| notes | string | 否 | |
| invoice_number | string | 否 | 可选的发票编号，将打印在发票上（BT-1）。如果省略，Scribo 会分配编号 — 切勿编造编号，也不要向用户声称或显示虚构的发票编号；如果用户未提供编号，请告知他们系统会自动分配，并显示在最终发票上。 |
| issue_date | string | 否 | 发票开具日期（BT-2），格式为 ISO YYYY-MM-DD。省略时默认为今天。 |
| due_date | string | 否 | ISO 日期 YYYY-MM-DD。BT-9（付款到期日）。 |
| payment_terms | string | 否 | BT-20 自由文本付款条款（例如 'Net 14'）。建议至少提供 due_date 或 payment_terms 其中一项；否则 Scribo 会默认使用 'Due upon receipt'，以满足 EN 16931 BR-CO-25。 |
| payment_means | object | 否 | BG-16 付款说明。请提供 SEPA `iban` 或美国境内账户信息（`account_number` + `routing_number`）之一 — 不要同时提供两种账户形式。可选的 `bic`（SWIFT）可与任一形式搭配；美国账户可填写用于接收国际汇款的 BIC，因此用户提供时请保留。格式解析为 XRechnung 时（recipient.leitweg_id，或 format_override 为 xrechnung_ubl / xrechnung_cii），必须提供 `iban` — BR-DE-1；美国账户不能满足此要求。其他所有格式均为可选。询问用户“使用哪个账户？” — 对于美国付款方，请索取银行账号和 9 位 ABA routing number。用户提供时，还要记录 `account_name`（账户持有人）和 `bank`（收款银行名称及地址），并保留任何 `bic`（SWIFT）— 这些信息会显示在发票上，方便付款方进行电汇。 |
| payment_means.type | enum | 是 | v0 中仅接入了 `credit_transfer`；直接扣款 / 卡 / 现金功能将后续推出。credit_transfer |
| payment_means.iban | string | 否 | SEPA IBAN — 国家/地区前缀 + 2 位校验数字 + BBAN。 |
| payment_means.bic | string | 否 | 可选的 8 位或 11 位 BIC / SWIFT 代码 — 可与 SEPA `iban` 或美国账户搭配（用于接收国际汇款）。 |
| payment_means.account_number | string | 否 | 美国银行账号（4–17 位数字）。与 routing_number 搭配使用。 |
| payment_means.routing_number | string | 否 | 美国 ABA 路由转账号码（9 位数字）。与 account_number 配对使用。 |
| payment_means.account_name | string | 否 | 可选的账户持有人显示名称（SEPA 或美国账户）。 |
| payment_means.bank | string | 否 | 可选的收款银行 — 自由文本名称 + 地址（例如 'Community Federal Savings Bank, 89-16 Jamaica Ave, Woodhaven, NY 11421'）。对美国电汇很有用，便于付款方的银行路由转账。 |
| delivery_date | string | 否 | ISO 日期 YYYY-MM-DD。BT-72（实际交付 / 服务日期）。未设置时，Scribo 会默认使用开具日期，以满足 EN 16931 / Factur-X BR-FX-EN-04。 |
| delivery_period | object | 否 | BG-14（开票期间）— 工作在一段日期范围内交付时的服务期间。不能与 delivery_date 同时使用。 |
| delivery_period.start | string | 是 | ISO 日期 YYYY-MM-DD |
| delivery_period.end | string | 是 | ISO 日期 YYYY-MM-DD |
| idempotency_key | string | 否 | 可选。同一键值 + 相同输入会返回原始发票。 |
| verification_token | string | 否 | 由 `verify_email_code` 返回的 Bearer token。重试之前返回 `verification_required` 的调用时，请在此处传入该 token。可在约 30 分钟内重复用于同一发件人邮箱的多张发票——在 token 过期前，后续调用都使用同一个 token。托管（HTTP）端点必需，因为服务器不会在调用之间保留会话。 |
| locale | string | 否 | 表示当前对话语言的 BCP-47 语言标签（例如 `de-DE`、`en-US`），即您与用户交谈时使用的语言。用于设置验证邮件、确认页面以及发件人的“Your invoice is ready”邮件的语言。使用 `verification_token` 重试时，请继续传入此值。只要能确定对话语言，就设置为该语言；不确定时省略（服务器默认使用英语）。不支持的值将回退到英语。这仅是 UI 语言提示，不会更改发票内容、货币或司法管辖区。 |
详细介绍
Scribo MCP 服务
免费、原生支持 AI 的电子发票服务——适用于任何 MCP 客户端。
目录
什么是 Scribo？
Scribo 是一款免费的对话式电子发票工具。用日常语言描述发票——“向 Acme GmbH 收取 2,400 欧元，作为 5 月份设计工作的费用”——它就会为你起草一份结构化发票，供你审核、下载并直接发送。
只需向你的 AI Agent 询问 Scribo 即可：它以 MCP 服务、CLI 和 Claude/Codex 技能的形式提供，同时还有公开的 HTTP API 和 Web 应用。永久免费——无需信用卡。你只需要一个发件人邮箱。
由 Causa Prima 打造——Scribo 由 Causa Prima 打造，这是一家为 CFO 办公室构建 Agentic AI 的公司。这是我们首个免费提供的技能，也是我们正在打造的产品的早期展示。
什么是 Scribo MCP 服务？
Scribo MCP 服务让你的 AI 助手能够为你创建发票。它是一个托管的 模型上下文协议 端点——只需将其 URL 添加到你的助手中一次，之后只要提出开票请求，它就会收集详细信息，并在聊天中返回一份完整且合规的发票，可供下载和发送。
由于服务由托管，无需在本地安装或运行。它适用于任何支持 MCP 的客户端——Claude Desktop、Claude.ai、Cursor、Cline、ChatGPT App、OpenAI Codex CLI 等。免费，无需注册——只需要你的邮箱。
演示
https://github.com/user-attachments/assets/3e1fcca8-580b-448f-bb1c-bee5ee016b54
快速入门
快速开始
Scribo MCP 服务由托管提供——无需安装。将客户端连接到：
https://scribo.causaprima.ai/mcp
在 Claude Desktop 或 Claude.ai 中：依次选择 Customize → Connectors → Add custom connector，将其命名为 Scribo，粘贴 URL 并保存。然后直接提出请求：
为 Acme GmbH 起草一张发票，收取 3 天咨询费，费率为每天 1,200 欧元。
Scribo 会收集缺失的信息，验证一次你的发件人邮箱，然后返回下载链接。
使用其他客户端？请参阅下方的客户端专属设置说明。
设置与前置要求
该服务通过 Streamable HTTP（JSON-RPC 2.0，MCP 规范 ≥ 2025-03-26）提供 MCP 接口，无需身份验证。任何支持 MCP 的客户端只需设置一个 URL 即可连接：https://scribo.causaprima.ai/mcp。
Claude Desktop / Claude.ai — 依次选择 Customize → Connectors → Add custom connector → 将其命名为 Scribo 并粘贴 URL。对于 Team/Enterprise 计划，组织所有者可能需要先在 Organization settings → Connectors 下添加一次。
Cursor — 添加到 ~/.cursor/mcp.json（或工作区的 .cursor/mcp.json）：
{ "mcpServers": { "scribo": { "url": "https://scribo.causaprima.ai/mcp" } } }
Cline — 添加到 cline_mcp_settings.json：
{ "mcpServers": { "scribo": { "transport": "streamable-http", "url": "https://scribo.causaprima.ai/mcp" } } }
OpenAI Codex CLI — 添加到 ~/.codex/config.toml，然后重启 Codex：
[mcp_servers.scribo]
url = "https://scribo.causaprima.ai/mcp"
其他 MCP 客户端 — 使用上述 URL 配置远程服务，传输方式选择 Streamable HTTP，无需身份验证。
想要使用不涉及连接器的纯 bash 设置方式？Scribo 技能通过简单的辅助脚本支持 Claude Code、Claude.ai、Claude Desktop 和 Codex。
验证。 向你的助手提问："列出 Scribo 支持的司法管辖区。"
用法
工作原理
用通俗语言描述发票，助手就会调用 Scribo 的工具来创建发票。该服务提供四个工具：
| 工具 | 功能 |
|---|---|
create_invoice | 根据发送方、接收方和明细项信息生成符合规范的发票，并返回长期有效的下载链接。 |
verify_email_code | 使用 Scribo 在首次开具发票时发送的 6 位验证码，确认发送方电子邮件地址的所有权。 |
get_invoice | 重新获取先前生成的发票和新的下载链接。 |
list_supported_jurisdictions | 列出支持的国家/地区和格式。 |
典型流程：你请求开具发票 → 助手调用 create_invoice 并收集缺失的信息 → 如果是来自新发送方电子邮件地址的首张发票，Scribo 会要求你粘贴 6 位验证码（通过 verify_email_code 确认）→ 助手重试并返回下载链接——这是一个嵌入了对应 EN 16931 XML 的 PDF。在可呈现小组件的客户端（例如 ChatGPT App）中，发票会以卡片形式显示，并带有下载按钮。
该服务还注册了五个工作流提示词（generate_invoice、german_b2b_invoice、german_b2g_xrechnung、us_plain_pdf_invoice、redownload_invoice）——显示提示词的客户端会将它们作为类似斜杠命令的快捷入口。
完整的工具架构和示例载荷见 schemas/ 和 examples/，以及 MCP 文档。
示例
连接 Scribo 后，你可以对助手说：
德国 B2B 发票（ZUGFeRD）
为 Beispiel GmbH 开具发票，内容为 12 小时的 Web 开发服务，费率为每小时 €110，增值税为 19%。我是 Example GmbH，增值税 ID 为 DE123456789。
返回一张 ZUGFeRD 发票——人类可读的 PDF，其中嵌入了供接收方会计系统使用的 EN 16931 XML。
德国公共部门发票（XRechnung）
同一客户，但发票开给慕尼黑市——Leitweg-ID 为 04011000-1234512345-06。
Leitweg-ID 会告诉 Scribo 这是一张 B2G 发票，因此它会生成德国公共机构要求的格式 XRechnung。
美国发票（普通 PDF）
向 Acme Inc. 开具 4,000 美元的品牌策略研讨会费用发票。
一张简洁的 PDF 发票——不含电子发票 XML，因为美国没有电子发票强制要求。
重新下载过去的发票
把上周为 Beispiel GmbH 开具的发票下载链接发给我。
Scribo 会为你已生成的发票返回一个新的下载链接。
合规性
Scribo 生成符合欧洲电子发票标准 EN 16931 的发票，并遵循相关国家的 CIUS。每份 EN 16931 格式的输出（ZUGFeRD、XRechnung）都会在生成时通过由 Invopop 托管的验证器进行验证——未通过规则集验证的输出绝不会交付给用户。美国普通 PDF 不含 EN 16931 XML，直接生成。
支持的格式
| 国家/地区 | 格式 | 状态 |
|---|---|---|
| 德国（B2B） | ZUGFeRD COMFORT（PDF/A-3 混合格式 + CII XML） | ✅ 已上线 |
| 德国（B2G） | XRechnung（UBL / CII） | ✅ 已上线 |
| 美国 | 普通 PDF（无 XML，不声明为电子发票） | ✅ 已上线 |
| 法国 | Factur-X EN 16931 | 🔜 即将推出 |
| 西班牙 | Facturae | 🔜 即将推出 |
| 比利时 / 荷兰 / 卢森堡 / 奥地利 | Peppol BIS 3.0 UBL | 🔜 即将推出 |
免责声明：Scribo 会生成并验证符合规范的发票文档。它不构成税务或法律建议——Scribo 不会判定你的纳税义务、增值税处理方式或申报要求。
常见问题
Scribo 真的免费吗？
是的——永久免费。无需信用卡、无需订阅，也不会在您开出第一张发票前设付费门槛。您只需要一个发件人邮箱。
我需要注册账号吗？
无需填写注册表。开具第一张发票时，Scribo 会验证发件人邮箱——该地址会收到一个 6 位验证码（或一键登录链接）；一次验证可在约 30 分钟内开具多张发票。同一邮箱也会作为您的魔法链接登录方式，供日后重新下载使用。
支持哪些国家和格式？
目前已支持：德国——ZUGFeRD（B2B）和 XRechnung（B2G）——以及美国（普通 PDF）。即将支持：法国（Factur-X）、西班牙（Facturae）和比利时 / 荷兰 / 卢森堡 / 奥地利（Peppol BIS 3.0）。
这里所说的“符合 EN 16931”具体是什么意思？
所有 EN 16931 输出（ZUGFeRD、XRechnung）在返回前，都会根据 EN 16931-1:2017 规则集（通过 Invopop 托管的验证器）进行验证。未通过验证的输出绝不会发送给您。美国普通 PDF 不含 EN 16931 XML，因此不适用 Schematron 验证。
美国版本符合规定吗？
是的。美国没有电子发票强制规定，因此 Scribo 会生成完全合规的普通 PDF。
Scribo 会提供税务或法律建议吗？
不会。Scribo 会生成并验证合规的发票文档，但不会判定您的纳税义务、增值税处理方式或申报要求。
AI Agent / 大模型如何使用 Scribo？
Scribo 专为由 Agent 操作而构建。它提供 MCP 服务、CLI 和 Claude/Codex 技能，以及公开的 HTTP API 和 Web 应用——全部使用同一后端。Agent 可以代表用户发现 Scribo、创建发票并返回文件。
谁在开发 Scribo？
Causa Prima——一家为 CFO 办公室构建 Agentic AI 的公司。由位于慕尼黑的 Causa Prima Germany GmbH 运营。
资源
- Web 应用 — scribo.causaprima.ai
- 文档 — scribo.causaprima.ai/docs
- 合规与信任 — scribo.causaprima.ai/compliance
- Causa Prima — causaprima.ai
Scribo 的其他入口
- 技能（Claude / Codex）—
scribo-skill· 文档 - MCP 服务 —
scribo-mcp· 文档 - CLI —
scribo-cli· 文档 - HTTP API —
scribo-api-docs· 文档 - 品牌中心 —
scribo
许可证
专有 — UNLICENSED。© Causa Prima Germany GmbH。保留所有权利。仅供调用公开 Scribo API 使用；非开源。请参阅 LICENSE。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。