mcpField
K
Kema Invoice

Kema Invoice

远程服务
invoice.kema-studio.com金融数据05 周前更新

关于 Kema Invoice

Kema Invoice 是面向自由职业者和企业的远程 MCP 服务,可通过 AI Agent 管理开票流程。它涵盖发票、报价单和预付款,并生成 Factur-X 发票,通过认证平台传输。

主要功能

  1. 01创建和跟踪发票
  2. 02管理报价单和预付款
  3. 03开具贷项通知单和更正发票
  4. 04生成 Factur-X 发票
  5. 05OAuth 2.1 授权

适用场景

  1. 01创建并发送客户发票
  2. 02跟踪发票付款状态
  3. 03将已接受的报价单转为发票

MCP 相关

它向 MCP 客户端提供发票、报价单和预付款操作工具,使用 Streamable HTTP 与 OAuth 2.1。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.kema-studio.com/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Kema Invoice MCP 连接器

Kema Invoice 是一款符合规范的电子发票软件,AI Agent 可通过 Model Context Protocol 操作它。 将远程 MCP 服务连接到 Claude、Cursor 或任何 MCP 客户端,通过 OAuth 2.1 授权一次后,Agent 就能用自然语言创建、开具、发送和跟踪发票、报价单及预收款。发票将生成 Factur-X(EN 16931)格式,并通过经认可的平台传输。无需安装任何内容:服务运行在 https://mcp.kema-studio.com/api/mcp。

网站 · 文档 · 连接你的 Agent · MCP Registry 条目 · 法语版本

本仓库的内容

该连接器是一个远程 MCP 服务(Streamable HTTP + OAuth 2.1)。无需安装任何软件包,服务代码也未在此发布。本仓库包含集成者或目录所需的内容:

文件用途
tools.json41 个工具及其标题、描述、分组和访问提示。由服务代码生成,不手动编辑。
server.json发布到官方 MCP Registry(com.kema-studio/invoice)的声明。
examples/可直接粘贴使用的客户端配置和提示词指南。
scripts/verify-connection.ts一个小型开源脚本,可运行 OAuth 流程并列出工具,以端到端检查连接。
CHANGELOG.md连接器版本。

两分钟内完成连接

客户端操作方法
claude.ai / Claude Desktop设置 › 连接器 › 添加自定义连接器,粘贴 https://mcp.kema-studio.com/api/mcp,授权一次。
Claude Codeclaude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp
Cursor将 examples/cursor-mcp.json 添加到 .cursor/mcp.json。
任何 MCP 客户端使用 Streamable HTTP 传输,URL 如上;通过 PKCE 和动态客户端注册(RFC 7591)使用 OAuth 2.1。授权服务器元数据将从 /.well-known/oauth-protected-resource 中发现。

首次调用时会打开 auth.kema-studio.com 上的授权页面。使用你的 Kema Invoice 账户登录并批准授权后,客户端会保存令牌。你可以随时从应用或客户端撤销访问权限。

还没有账户?创建账户:享受 14 天试用,包含 10 张发票、一个用户,无需信用卡。之后仅需选择单一方案,每位用户每月 €10(不含增值税),包含所有功能,随时可取消。

Agent 可以做什么

发票(16)
工具功能访问权限
create_invoice为一家公司创建发票,包含明细项目。在此产品中,创建发票即表示开具发票:调用此工具后,向用户简要展示摘要(客户、明细、总额),并在用户批准后调用 issue_invoice,设置 confirm:true。只有当用户明确希望先在应用中查看或编辑时,才将发票保留为草稿。VAT 会根据严格的服务端税务规则(场景 + 默认值)自动计算——切勿询问用户 VAT 税率。创建时会冻结税务场景和客户快照;快照包含公司的法定名称(legal_name),发票上显示的就是该名称,即使它与显示名称不同。写入
issue_invoice开具草稿发票:即正式创建发票(产品将此操作称为“Créer la facture”)。发票将成为具有法律效力的正式文件(状态为 Sent,显示为“Créée”):根据法国法律,此操作不可撤销,只能通过贷项通知单撤销。调用时若设置 confirm:true,必须始终先向用户展示发票摘要并取得其明确批准;未设置 confirm 时,会返回预览。税务认证在此调用中完成,属于内部处理:调用返回后,只需告知用户发票已创建,不要再说其他内容。除非此工具返回错误,否则绝不要向用户提及认证、税务状态、不可变更性或处理过程。写入、破坏性
list_invoices按时间倒序列出已认证租户的发票。支持按状态、单据类型筛选,也支持按发票编号或客户名称进行自由文本搜索,并支持分页。读取
get_invoice根据 ID 获取单张发票,包括明细项目、客户和总额。如果调用者无权查看该发票,则返回形如 null 的错误。读取
get_invoice_pdf返回发票 PDF 的临时签名下载 URL(有效期 1 小时)。适用于调用者可见的任何单据:导入的发票会返回其上传的文件;在 Kema Invoice 中开具的发票(由应用或 Agent 开具)会在服务端根据工作区品牌信息生成,并在完成认证后嵌入 Factur-X XML。草稿也会生成 PDF(标记为 is_draft: true),但尚不具有法律效力。读取
update_invoice更新草稿发票的字段(日期、付款条款、备注或重新分配公司)。只有草稿发票可以修改——已发送/已认证的发票不可变更。写入
delete_invoice软删除草稿发票。从用户角度看,此操作不可撤销。设置 confirm:true 才会实际删除;未设置时,会返回待删除内容的预览。写入、破坏性
cancel_invoice取消草稿发票(状态 → Cancelled)。此操作不可撤销。已开具的单据(Sent、Overdue、Paid)属于税务记录,不能直接取消:请使用 create_credit_note,开具经认证的贷项通知单(avoir)并取消原发票。设置 confirm:true 执行操作;否则会返回预览。写入、破坏性
mark_invoice_paid将 Sent 或 Overdue 发票标记为 Paid。可选设置付款日期(默认为当前时间)。写入
add_invoice_item向草稿发票添加明细项目。总额会自动重新计算。写入
update_invoice_item更新草稿发票中的明细项目。总额会自动重新计算。项目 ID 可通过 get_invoice 或 add_invoice_item 获取。写入
delete_invoice_item从草稿发票中移除明细项目。总额会自动重新计算。项目 ID 可通过 get_invoice 或 add_invoice_item 获取。设置 confirm:true 才会删除;未设置时,会返回该项目的预览。写入、破坏性
reorder_invoice_items设置发票明细项目的显示顺序。传入完整的目标顺序:每个项目 ID 及其从 0 开始的 display_order。项目 ID 可通过 get_invoice 或 add_invoice_item 获取。写入
update_invoice_matter将事宜(dossier)关联到发票,或从发票中解除关联。此操作仅用于组织管理——即使发票已发送也允许执行,但已取消的发票除外。传入 matter_id null 可解除关联。写入
check_certification_status维护工具:从认证提供商刷新已开具单据的税务认证状态,并将其同步到数据库。认证属于内部处理,在 issue_invoice 执行后会自动完成:绝不要主动调用此工具,也绝不要向用户提及认证。仅当用户明确询问认证情况,或 issue_invoice 返回认证错误后,才使用此工具。写入
create_credit_note通过开具贷项通知单(avoir)取消 Sent 或 Paid 发票。贷项通知单是具有法律效力的税务文件(如果原发票已认证,则贷项通知单也会进行税务认证),且创建后不可变更。此操作不可撤销。设置 confirm:true 调用前,必须始终取得用户的明确批准。未设置 confirm 时,会返回预览。写入、破坏性
更正与导入(3)
工具功能访问权限
rectify_invoice为已发送或已付款的发票创建更正发票(facture rectificative):根据原发票预填一张新的草稿发票(同一客户,复制行项目,除非另行指定),并依法与原发票关联。只有在更正发票开具后,原发票才会标记为已更正。传入 confirm:true 可创建;不传则返回预览。写入
get_rectification_links对于一张发票,返回其更正关系链:它替代的原发票(如果它是更正发票),和/或替代它的更正发票(如果它已被更正)。如果该发票不属于任何关系链,两者均为 null。读取
import_external_invoice导入历史或外部发票,保留其自身发票编号(原样保留)、总额和状态,不包含行项目。用于迁移在 Kema Invoice 之外开具的历史发票;不要用于创建新发票(请使用 create_invoice)。写入
报价单(5)
工具功能访问权限
create_quote为公司创建一份草稿报价单(devis)。报价单不是财政凭证,无需认证。日期默认为服务端设置(开具日期为今天,到期日/有效期为 +30 天)。必须指定报价单所属的 matter id(dossier)。写入
send_quote将草稿报价单转为已发送(面向客户的状态)。此过程无需认证;报价单属于商业文件。租户位于法国时,适用法国 B2B 验证(SIREN/VAT)。写入,有破坏性
accept_quote将已发送的报价单标记为已被客户接受。随后调用 convert_quote_to_invoice,将其转为账单。写入,有破坏性
reject_quote将已发送的报价单标记为已被客户拒绝。此操作会结束报价单的生命周期。传入 confirm:true 可执行;不传则返回预览。写入,有破坏性
convert_quote_to_invoice根据已接受的报价单创建一张新的草稿发票(复制行项目,并设置 source_quote_id 以便追溯)。之后发票将遵循正常生命周期(调用 issue_invoice 使其具有法律约束力)。传入 confirm:true 可执行;不传则返回预览。写入
预付款(6)
工具功能访问权限
create_provision为公司创建一份处于草稿状态的预付款文件(avance sur honoraires,预付款),可选关联到一个案件。不会签发或认证——法律签发请使用 send_provision。增值税由服务器端严格按照税务规则自动计算——绝不要询问用户增值税税率。预付款使用独立的 PROV 编号序列;付款后会成为客户抵扣额,可从最终发票中抵扣(apply_provisions_to_invoice)。写入
send_provision签发草稿预付款:即创建该文件的法律行为。预付款将成为正式法律文件(状态为 Sent,使用 PROV 序列):不可撤销,并依据法国法律具有约束力。调用时若使用 confirm:true,务必始终先向用户展示预付款详情并获得其明确批准;未提供 confirm 时,将返回预览。税务认证在此调用内部完成,属于内部处理:调用返回后,只需告知用户预付款已创建,不要再提及其他内容。除非此工具返回错误,否则绝不要向用户提及认证、税务状态、不可变性或处理过程。写入、破坏性
mark_provision_paid将已签发的预付款(状态为 Sent/Overdue)标记为 Paid。已付款的预付款会成为客户抵扣额,可通过 apply_provisions_to_invoice 从该客户的最终发票中抵扣。写入
list_available_provisions列出尚未抵扣到最终发票的已付款预付款(avances sur honoraires,预付款)——即可抵扣的客户抵扣额。不带 matter_id 时,列出独立预付款(不关联案件),这是 Kema Invoice 中的常见情况;带 matter_id 时,列出该案件的预付款。请在使用 apply_provisions_to_invoice 前调用。读取
apply_provisions_to_invoice从同一客户的草稿最终发票中抵扣一笔或多笔已付款预付款(若关联了案件,案件也必须相同)。更新发票的 advances_total 和 amount_due。发票仍处于草稿状态时可撤销(remove_provision_from_invoice)。写入
remove_provision_from_invoice从草稿最终发票中移除一笔预付款,并重新计算其 advances_total / amount_due。该预付款将重新对该案件可用。写入
客户(5)
工具功能访问权限
list_companies列出已认证租户的客户公司(名称、电子邮箱、增值税/税号、国家/地区)。可用于在其他查询前查找公司 ID。读取
get_company获取一家客户公司的完整账单相关记录:法律身份、VAT/SIREN、地址、联系信息和客户档案分类。读取
create_company为租户创建一家客户公司。之后若要向其开具 B2B 账单,则必须提供 VAT/税号。写入
update_company更新现有客户公司的字段(名称、联系信息、地址、VAT 号码、SIREN)。仅更改已提供的字段。为该客户开具发票前,通常需要在此修正 VAT 号码/SIREN/地址,才能完成认证。写入
delete_company软删除一家客户公司。若仍有联系人与其关联,则无法删除。使用 confirm:true 调用以删除;未提供 confirm 时,将返回预览。写入、破坏性
客户档案(3)
工具功能访问权限
get_invoice_client_profile获取每家公司的开票默认设置(付款期限、交付渠道、自定义发票前缀)。若公司没有档案,则返回 {profile: null}——档案会按需创建。读取
upsert_invoice_client_profile创建或更新公司的开票默认设置(付款期限、交付渠道、发票前缀)。这些默认设置会预填该客户未来的发票。写入
delete_invoice_client_profile移除公司的开票默认设置(不会更改公司本身)。使用 confirm:true 调用以实际删除;未提供 confirm 时,将返回预览。写入、破坏性
报表(3)
工具功能访问权限
get_revenue_summary汇总收入数据:期间内收款金额(按付款日期统计)、当前未结和逾期金额(时点数据)、期间内开具的单据、草稿数量,以及贷项通知单的净影响。默认为当前月份。读取
get_settings只读的租户开票设置快照:法律身份、财政国家和税制、默认增值税税率和付款期限、账单邮箱,以及调用方的 UI 语言。只能在应用中更改设置。读取
list_mcp_activity租户近期的 Agent 活动日志:每次成功的 MCP 工具调用对应一条记录(工具名称、已知时的相关发票编号、时间戳)。按时间从新到旧排列。读取

服务遵循的设计规则:每个工具使用唯一标题,读取操作设置 readOnlyHint,写入操作明确设置 destructiveHint;每个参数都有说明;每个结果都包含 outputSchema 和 structuredContent。工具名称固定不变:你的提示词和自动化流程可以在不同版本间持续使用。

对于被拒绝的调用(没有有效订阅、已达到配额),系统会返回一条面向模型编写的工具结果,而非传输错误:连接器会保持连接,并继续列出其工具。

试试看

用你的语言向 Agent 提问:

  • “为 Dupont SARL 开具 3 天的咨询服务发票,每天 €800。”
  • “列出我所有未付款的发票,并将 FAC-2026-0412 标记为已付款。”
  • “将报价单 DEV-2026-0031 转成发票并发送。”

更多示例见 examples/prompts.md。

合规与数据

  • 发票以 Factur-X 格式(内嵌 EN 16931 XML 的 PDF/A-3)生成,并通过经认证的平台传输,满足法国电子发票强制要求。
  • 数据托管在欧盟(数据库和身份验证位于 AWS eu-north-1,斯德哥尔摩;边缘服务和存储位于欧盟)。子处理方和数据保留期限请参阅隐私政策。
  • 每次 MCP 调用都会记录在应用的 Agent 活动中,你可以随时查看 Agent 执行的操作。
  • 条款 · 法律声明

验证连接

git clone https://github.com/Kema-Studio/kema-invoice-mcp && cd kema-invoice-mcp
npm install
npm run verify        # opens the consent page, then lists the tools

支持

  • 账户或发票相关问题:通过应用获取支持(“帮助”按钮),或发送邮件至 [email protected]。
  • 连接器本身的错误(工具报错、架构问题):提交 issue。

许可证

本仓库的内容(文档、示例、脚本)依据 MIT License 发布。Kema Invoice 服务及其服务端是 Kema Studio 的专有软件。


法语版

Kema Invoice 是一款符合规范的电子发票软件,AI Agent 可通过 Model Context Protocol 对其进行操控。 将远程 MCP 服务连接到 Claude、Cursor 或任意 MCP 客户端,通过 OAuth 2.1 授权一次,即可让 Agent 使用自然语言创建、开具、发送和跟踪发票、报价单及预付款。发票以 Factur-X(EN 16931)格式生成,并通过经认证的平台传输。无需安装任何内容:服务端通过 https://mcp.kema-studio.com/api/mcp 响应。

连接
客户端说明
claude.ai / Claude Desktop设置 › 连接器 › 添加自定义连接器,粘贴 https://mcp.kema-studio.com/api/mcp,授权一次即可。
Claude Codeclaude mcp add kema-invoice --transport http --url https://mcp.kema-studio.com/api/mcp
Cursor将 examples/cursor-mcp.json 添加到 .cursor/mcp.json。
其他 MCP 客户端使用 Streamable HTTP 传输、OAuth 2.1(含 PKCE)和动态客户端注册(RFC 7591)。

还没有账户?立即创建:享受 14 天试用,包含 10 张发票和 1 位用户,无需银行卡。之后仅需每位用户每月 10 €(不含税),即可使用全部功能,无需承诺。

您的 Agent 能做什么
发票(16)
工具功能访问权限
create_invoice为公司创建发票并添加明细。在此产品中,创建发票即表示开具发票:调用此工具后,向用户简要说明(客户、明细、总额),并在获得用户批准后调用 issue_invoice,且设置 confirm:true。只有用户明确表示要先在应用中查看或编辑时,才将发票保留为草稿。增值税由严格的服务器端税务规则(场景 + 默认值)自动计算——切勿询问用户增值税税率。创建时会固定税务场景和客户快照;快照包含公司的法定名称(legal_name),发票将打印此名称,即使它与显示名称不同。写入
issue_invoice开具草稿发票:这是创建发票的法律行为(产品将其称为“创建发票”)。该发票会成为具有最终效力的法律文件(状态为 Sent,显示为“已创建”):根据法国法律,此操作不可撤销,只能通过贷项通知单撤销。调用时若设置 confirm:true,必须始终先向用户展示发票摘要并获得其明确批准;不传 confirm 时会返回预览。税务认证在此调用中完成,属于内部流程:调用返回后,只需告知用户发票已创建,不要再提及其他内容。除非此工具返回错误,否则切勿向用户提及认证、税务状态、不可变性或处理流程。写入、破坏性
list_invoices按时间从近到远列出已认证租户的发票。支持按状态、单据类型筛选,按发票编号或客户名称进行全文搜索,并支持分页。读取
get_invoice按 ID 获取单张发票,包括其明细、客户和总额。如果调用者无权查看该发票,则返回结构中各字段均为 null 的错误结果。读取
get_invoice_pdf返回发票 PDF 的临时签名下载 URL(有效期为 1 小时)。适用于调用者可查看的任何单据:导入的发票会返回其上传的文件;在 Kema Invoice 中由应用或 Agent 开具的发票,则由服务器使用工作区品牌信息进行渲染,并在认证后嵌入 Factur-X XML。草稿也会被渲染(标记为 is_draft: true),但尚不是法律文件。读取
update_invoice更新草稿发票的字段(日期、付款条件、备注或重新指定公司)。只有草稿发票可以修改——Sent/已认证发票不可更改。写入
delete_invoice软删除草稿发票。从用户角度看,此操作不可撤销。设置 confirm:true 才会实际删除;不传则返回将被删除内容的预览。写入、破坏性
cancel_invoice取消草稿发票(状态 → Cancelled)。此操作不可撤销。已开具的单据(Sent、Overdue、Paid)属于税务记录,不能直接取消:请使用 create_credit_note,它会开具经认证的贷项通知单(avoir)并取消原单据。设置 confirm:true 才会执行;否则返回预览。写入、破坏性
mark_invoice_paid将 Sent 或 Overdue 发票标记为 Paid。可选设置付款日期(默认为当前时间)。写入
add_invoice_item向草稿发票添加一项明细。总额会自动重新计算。写入
update_invoice_item更新草稿发票上的一项明细。总额会自动重新计算。明细 ID 可通过 get_invoice 或 add_invoice_item 获取。写入
delete_invoice_item从草稿发票中移除一项明细。总额会自动重新计算。明细 ID 可通过 get_invoice 或 add_invoice_item 获取。设置 confirm:true 才会删除;不传则返回该明细的预览。写入、破坏性
reorder_invoice_items设置发票明细的显示顺序。传入完整的目标顺序:每个明细 ID 及其从 0 开始的 display_order。明细 ID 可通过 get_invoice 或 add_invoice_item 获取。写入
update_invoice_matter为发票关联或解除关联事项(dossier)。此操作仅用于整理,即使发票为 Sent 也允许执行,但 Cancelled 发票除外。传入 matter_id null 可解除关联。写入
check_certification_status维护工具:从认证提供方刷新已开具单据的税务认证状态,并将其同步到数据库。调用 issue_invoice 后,认证会作为内部流程自行完成:切勿主动调用此工具,也不要向用户提及认证。仅在用户明确询问认证状态,或 issue_invoice 返回认证错误后使用。写入
create_credit_note通过开具贷项通知单(avoir)取消 Sent 或 Paid 发票。贷项通知单属于法律税务文件(如果原发票已认证,该单据也会进行税务认证),创建后不可更改。此操作不可撤销。设置 confirm:true 调用前,必须始终获得用户的明确批准。不传 confirm 时会返回预览。写入、破坏性
冲销与导入(3)
工具功能访问权限
rectify_invoice为已发送或已付款的发票创建一张冲销发票(facture rectificative):一张根据原发票预填的新草稿发票(客户相同,除非另行指定,否则复制明细行),并与原发票建立法律关联。只有在冲销发票正式开具时,原发票才会标记为已冲销。使用 confirm:true 创建;不传此参数则返回预览。写入
get_rectification_links返回一张发票的冲销链:它所替代的原发票(如果它是冲销发票),和/或替代它的冲销发票(如果它已被冲销)。如果该发票不属于任何冲销链,则两者均为 null。读取
import_external_invoice导入历史或外部发票,保留其原有发票编号(不作更改)、总额和状态,不含明细行。用于迁移在 Kema Invoice 之外开具的历史发票;不要用于创建新发票(请使用 create_invoice)。写入
报价单(5)
工具功能访问权限
create_quote为一家公司创建一张草稿报价单(devis)。报价单不是税务文件,无需认证。日期由服务端设定默认值(开具日期为当天,到期/有效期为 30 天)。必须提供报价单所属的 matter id(档案)。写入
send_quote将草稿报价单变更为已发送状态(客户可见的状态)。报价单是商业文件,无需认证。租户位于法国时,需进行法国企业对企业交易验证(SIREN/VAT)。写入、破坏性操作
accept_quote将已发送的报价单标记为已被客户接受。随后使用 convert_quote_to_invoice 将其转为应收账款。写入、破坏性操作
reject_quote将已发送的报价单标记为已被客户拒绝。此操作将结束报价单的生命周期。使用 confirm:true 应用;不传此参数则返回预览。写入、破坏性操作
convert_quote_to_invoice根据已接受的报价单创建一张新的草稿发票(复制明细行,并设置 source_quote_id 以便追踪)。之后,发票将遵循正常生命周期(使用 issue_invoice 使其具有法律效力)。使用 confirm:true 应用;不传此参数则返回预览。写入
Provision(6)
工具功能访问权限
create_provision为公司创建一份状态为 Draft 的 provision 文件(律师费预付款、预付费),可选择关联事项。不会签发或认证——法律签发请使用 send_provision。增值税由严格的服务端税务规则自动计算——绝不要询问用户增值税税率。Provision 使用独立的 PROV 编号序列;付清后会成为客户抵扣额,可从最终发票中抵扣(apply_provisions_to_invoice)。写入
send_provision签发一份 Draft 状态的 provision:即创建该文件的法律行为。Provision 会成为正式法律文件(状态为 Sent,使用 PROV 序列):此操作不可撤销,并依据法国法律具有法律约束力。调用时若设置 confirm:true,务必先向用户展示 provision 详情并取得其明确批准;不设置 confirm 时会返回预览。税务认证在此调用过程中完成,属于内部处理:调用返回后,告知用户 provision 已创建,不要补充其他内容。除非此工具返回错误,否则绝不要向用户提及认证、税务状态、不可变性或处理过程。写入、破坏性
mark_provision_paid将已签发的 provision(状态为 Sent/Overdue)标记为 Paid。付清的 provision 会成为客户抵扣额,可通过 apply_provisions_to_invoice 从该客户的最终发票中抵扣。写入
list_available_provisions列出尚未用于最终发票的 PAID provision(律师费预付款、预付费)——即可抵扣的客户额度。不提供 matter_id 时,列出独立预付费(不关联事项),这是 Kema Invoice 中的常见情况;提供 matter_id 时,列出该事项的预付费。请在使用 apply_provisions_to_invoice 前调用。读取
apply_provisions_to_invoice从同一客户的 DRAFT 最终发票中抵扣一份或多份 PAID provision(若发票关联了事项,事项也必须相同)。更新发票的 advances_total 和 amount_due。只要发票仍处于 Draft 状态,就可以撤销(remove_provision_from_invoice)。写入
remove_provision_from_invoice从 DRAFT 最终发票中移除一份 provision,并重新计算其 advances_total / amount_due。该 provision 会重新变为该事项可用的额度。写入
客户(5)
工具功能访问权限
list_companies列出已认证租户的客户公司(名称、电子邮件、增值税号/税号、国家/地区)。可用于在其他查询前查找公司 ID。读取
get_company获取一家公司客户的完整账单相关记录:法定身份、VAT/SIREN、地址、联系信息和客户资料分类。读取
create_company为租户创建一家客户公司。之后若要按 B2B 方式向其开票,则必须提供 VAT/税号。写入
update_company更新现有客户公司的字段(名称、联系信息、地址、VAT 号码、SIREN)。只更改提供的字段。开具该客户的发票前,通常需要在此修正 VAT 号码 / SIREN / 地址,以便认证发票。写入
delete_company软删除一家客户公司。若仍有关联的联系人,则无法删除。设置 confirm:true 后删除;不设置时会返回预览。写入、破坏性
客户资料(3)
工具功能访问权限
get_invoice_client_profile获取单个公司的开票默认设置(付款期限、交付渠道、自定义发票前缀)。若该公司没有资料,则返回 {profile: null}——资料会按需创建。读取
upsert_invoice_client_profile创建或更新一家公司的开票默认设置(付款期限、交付渠道、发票前缀)。这些默认设置会预填该客户今后的发票。写入
delete_invoice_client_profile移除一家公司的开票默认设置(不会影响公司本身)。设置 confirm:true 后才会实际删除;不设置时会返回预览。写入、破坏性
管理概览(3)
工具功能访问权限
get_revenue_summary汇总收入数据:期间内已收款金额(按付款日期统计)、当前未结清和逾期金额(时点数据)、期间内开具的单据、草稿数量,以及贷项通知单的净影响。默认统计当前月份。只读
get_settings只读快照,展示租户的开票设置:法定身份信息、财政所属国家和制度、默认增值税税率和付款期限、账单邮箱,以及调用方的界面语言。设置只能在应用中更改。只读
list_mcp_activity租户近期的 Agent 活动日志:每次成功调用 MCP 工具对应一条记录(工具名称、已知时的相关发票编号、时间戳)。按时间从新到旧排列。只读
合规与数据

Factur-X 发票(含 EN 16931 XML 的 PDF/A-3)通过经认可的平台传输;数据托管于欧盟(数据库和身份验证位于 AWS eu-north-1,斯德哥尔摩);每次 MCP 调用都会记录在应用的Agent 活动栏目中。隐私政策 · 服务条款 · 法律声明。

支持

账户和发票:请通过应用(帮助按钮)或联系 [email protected]。连接器 Bug:提交 issue。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。