跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Quaderno，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
在 AI 中使用 Quaderno 的税务和开票功能：计算任意地区的销售税、增值税和 GST，验证增值税号，搜索联系人、发票、贷记单、报价单、费用和产品，开具发票并通过邮件发送，以及申请税务报表。
试试这样问
Quaderno 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Quaderno、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Quaderno
在 AI 中使用 Quaderno 的税务和开票功能：计算任意地区的销售税、增值税和 GST，验证增值税号，搜索联系人、发票、贷记单、报价单、费用和产品，开具发票并通过邮件发送，以及申请税务报表。
设置
- 登录
https://quadernoapp.com，打开 Profile → API keys（https://quadernoapp.com/users/api-keys）。 - 把以
sk_开头的 私钥 复制到QUADERNO_API_KEY。可公开密钥（pk_）在这里不能用。密钥作为 HTTP Basic 的用户名发送，密码为空，只发给你的 Quaderno 账户。 - 同一页面会显示你的 API 地址，例如
https://acme-1234.quadernoapp.com/api/。把.quadernoapp.com前面的部分（这里是acme-1234）填入QUADERNO_ACCOUNT_NAME，然后安装连接器。 - 用
quaderno_ping检查设置：它会确认密钥有效，并显示当前时间窗口内剩余的请求次数。
开具和发送发票都需经你同意：已开具的发票是正式的税务凭证。Quaderno 会按顺序编号，发票无法删除，只能在 Quaderno 应用中作废或用贷记单冲销。调用 quaderno_create_invoice 之前，AI 会给你看客户、明细、价格和币种。quaderno_deliver_invoice 会立即把发票通过邮件发给客户且无法撤回，调用之前 AI 会告诉你哪张发票发往哪个地址。quaderno_create_contact 和 quaderno_request_report 也会先问你。创建发票并不会发送它。quaderno_delete_contact 在安装时处于关闭状态。
税额计算：quaderno_calculate_tax 返回销往任意地区的销售税、增值税或 GST：税种名称、税率、税额、小计和总计、精确到城市的税务管辖区，以及诸如对有效欧盟增值税号适用反向征税之类的提示。它只计算，不记录任何内容。quaderno_validate_tax_id 会在所属国家的官方登记库中核验增值税号或企业编号（欧盟 VIES、英国、瑞士、魁北克、澳大利亚、新西兰）。
可以读取的内容：联系人、发票、贷记单、报价单（Quaderno 称为形式发票）、费用、产品、税务管辖区和税码。税务报表（按管辖区汇总的已收税款以便申报、发票清单或贷记单清单）在后台生成：AI 按期间申请报表，反复查看直到生成完成，再把下载链接交给你。
敏感数据：发票和联系人包含客户的姓名、地址和税号，也是税务记录。只与负责开票的人共享。
金额：以 _cents 结尾的字段以分为单位（12345 即 123.45）；价格和税额计算结果以货币单位表示。
速率限制：每 15 秒 100 次调用。返回 429 时请等待时间窗口重置。
常见错误：401 Wrong API key or the user does not exist：密钥错误、用的是 pk_ 密钥，或密钥属于与 QUADERNO_ACCOUNT_NAME 不同的账户。406：值无效，例如未知的税码。422：单据无法这样创建，例如没有明细。
不包括：修改、作废发票或将其标记为坏账，登记付款，收据，周期性单据，交易，结账会话和优惠券，地点证据，Webhook，Sandbox 以及 Quaderno Connect 账户。
前提条件: QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 Quaderno 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
quaderno_ping | Check that the API key works and see the requests left in the current rate-limit window |
quaderno_list_contacts | List or search customers and suppliers (contacts) by name, email or tax id: id, kind (person or company), name, email, tax id and tax… |
quaderno_get_contact | Get one contact with full address, phone, website, language, default discount, notes and the link to their billing area |
quaderno_create_contact | Create a customer or supplier contact |
quaderno_delete_contact | Delete one contact for good |
quaderno_list_invoices | List or search invoices by number, customer name or PO number, issue date range, state or customer: id, number, dates, state (outstanding… |
quaderno_get_invoice | Get one invoice in full: customer and billing address, line items with their taxes, the tax breakdown, payments, deliveries, alerts, the… |
quaderno_create_invoice | Issue a new invoice |
quaderno_deliver_invoice | Email an invoice to its customer from Quaderno, with the PDF and the link to it |
quaderno_list_credit_notes | List or search credit notes (refunds and corrections of invoices) by number, customer name or PO number, issue date range or state: id… |
quaderno_get_credit_note | Get one credit note in full: customer, line items, tax breakdown, payments, deliveries, the related invoice, the public link and the PDF… |
quaderno_list_quotes | List or search quotes (Quaderno calls them proformas; they replaced estimates) by number, customer name or PO number, issue date range… |
quaderno_get_quote | Get one quote (proforma) in full: customer, line items, tax breakdown, validity, the public link and the PDF link |
quaderno_list_expenses | List or search expenses (purchase invoices from suppliers) by number, supplier name or PO number, issue date range, state or supplier: id… |
quaderno_list_products | List or search products (items) by name or code: id, code, name, description, unit cost, currency, kind (one-off or subscription), product… |
quaderno_calculate_tax | Calculate the sales tax, VAT or GST for a sale to a customer location: tax name, rate, taxable part, tax amount, subtotal and total, the… |
quaderno_validate_tax_id | Check a business tax id against the official registry of its country (EU VIES, UK, Switzerland, Quebec, Australia, New Zealand): returns… |
quaderno_list_tax_jurisdictions | List the tax jurisdictions Quaderno knows, optionally for one country or region: id, name, country and region |
quaderno_list_tax_codes | List the tax codes products can be classified with (e.g. eservice, saas, ebook, consulting, standard, reduced, exempt): id, name and what… |
quaderno_list_reports | List the reports requested so far: id, type (tax_summary, invoices_list, credits_list), state, period, when it completed and the download… |
quaderno_request_report | Ask Quaderno to build a report for a period: tax_summary (taxes collected per jurisdiction, for filing returns), invoices_list or… |
quaderno_get_report | Check one report request: state (pending, suceeded or failed), period, when it completed and the report_url to download it once ready |
示例提示
- “向法国里昂的个人消费者销售 49 欧元的 SaaS 订阅，适用多少增值税？如果卖给当地持有有效增值税号的企业呢？”
- “增值税号 DE123456789 有效吗？”
- “哪些发票还未付款或已逾期？按币种合计各是多少？”
- “给 Northwind GmbH 开一张发票：咨询 10 小时，每小时 120 欧元。创建前把所有内容给我看，先不要发邮件。”
- “申请第三季度的税务汇总报表，生成后把下载链接给我。”
下一步
这份指南对你有帮助吗?
