Doklad.ai

Doklad.ai MCP 服务

将 AI 助手连接到 Doklad.ai，这是一款面向自由职业者（OSVČ）和小型公司的捷克发票软件。托管的 Doklad.ai MCP 服务可让 Claude、ChatGPT、Codex、Claude Code、Cursor、VS Code、Gemini CLI 及其他 Model Context Protocol 客户端在你的 Doklad.ai 账户中创建并发送发票、管理客户、记录费用、登记已收款项，以及汇总现金流。

端点	https://doklad.ai/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1（使用你的 Doklad.ai 账户登录；PKCE、动态客户端注册）或 API 密钥 Authorization: Bearer dk_…
价格	Doklad.ai 目前免费，包含 MCP
速率限制	每家公司每分钟 60 个请求
官方 MCP 注册表	ai.doklad/mcp
设置指南（捷克语）	https://doklad.ai/mcp-fakturace

此仓库仅包含文档和客户端配置。MCP 服务由 Doklad.ai 托管和运营，因此你无需安装或运行任何内容。

适用对象

• 使用 Doklad.ai 开具发票，并希望通过 AI 助手处理发票的自由职业者（OSVČ）和捷克小型公司。
• 希望自动处理日常开票和付款跟进工作的会计人员及后台团队。
• 基于捷克发票数据构建 Agent 的开发者。

你可以询问的内容

• “哪些发票已逾期？未收款总额是多少？”
• “为 Alfa s.r.o. 创建一张发票，内容为 12 小时咨询服务，单价为 1,500 CZK（不含 VAT），14 天后到期。”
• “将发票 2026-0142 通过电子邮件发送给客户。”
• “登记今天收到的 18,150 CZK 款项，用于支付发票 2026-0137。”
• “显示 9 月的收入、支出和利润。”

连接客户端

所有客户端使用相同的 URL：https://doklad.ai/mcp。首次使用时，客户端会在浏览器中打开 Doklad.ai：登录、选择公司并授权访问。无需在任何地方复制密钥。只有公司的所有者或管理员可以授权访问。

Claude（claude.ai、Claude Desktop、移动应用）

添加连接器，或打开 Customize → Connectors → Add custom connector，输入 https://doklad.ai/mcp 并登录。之后，该连接器即可在网页、Claude Desktop 和移动应用中使用。免费套餐允许添加一个自定义连接器；在 Team 和 Enterprise 套餐中，所有者可通过 Organization settings → Connectors 添加。

ChatGPT

启用 Settings → Security and login → Developer mode，然后打开 chatgpt.com/plugins，点击 +，输入 https://doklad.ai/mcp，选择 OAuth 身份验证并登录。Plus、Pro、Business、Enterprise 和 Edu 套餐均提供开发者模式。

Claude Code

claude mcp add --transport http --scope user doklad https://doklad.ai/mcp

然后运行 /mcp，选择 doklad 并选择 Authenticate。

Codex（CLI、IDE 扩展、ChatGPT 桌面应用）

codex mcp add doklad --url https://doklad.ai/mcp
codex mcp login doklad

Cursor

在 Cursor 中安装，或添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "doklad": { "url": "https://doklad.ai/mcp" }
  }
}

VS Code（GitHub Copilot Agent 模式）

添加到 .vscode/mcp.json（VS Code 1.99+）：

{
  "servers": {
    "doklad": { "type": "http", "url": "https://doklad.ai/mcp" }
  }
}

Gemini CLI

gemini mcp add --scope user --transport http doklad https://doklad.ai/mcp

然后运行 /mcp auth doklad。此仓库也可作为 Gemini CLI 扩展（gemini-extension.json）。

API 密钥（n8n、脚本、不支持 OAuth 的客户端）

在 Doklad.ai 中通过 Integrace → API klíče a webhooky → MCP server 创建密钥，并将其作为 Authorization: Bearer dk_… 发送：

claude mcp add --transport http doklad https://doklad.ai/mcp --header "Authorization: Bearer $DOKLAD_API_KEY"

# ~/.codex/config.toml
[mcp_servers.doklad]
url = "https://doklad.ai/mcp"
bearer_token_env_var = "DOKLAD_API_KEY"

Claude Desktop 的 claude_desktop_config.json 只能运行本地服务，因此请使用 mcp-remote 桥接程序（Node.js 20.18+）：

{
  "mcpServers": {
    "doklad": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://doklad.ai/mcp", "--header", "Authorization:${DOKLAD_AUTH_HEADER}"],
      "env": { "DOKLAD_AUTH_HEADER": "Bearer dk_YOUR_KEY" }
    }
  }
}

工具

工具	功能	访问权限
list_invoices	列出发票，可按状态、客户、文本搜索或日期范围筛选	读取
get_invoice	获取一张发票及其明细项和客户详情	读取
create_invoice	创建发票：客户、明细项（描述、数量、单价、增值税率）和到期日	写入
update_invoice	更新发票；仅更改传入的字段	写入
delete_invoice	删除发票（仅限草稿和已取消的发票）	破坏性操作
send_invoice_email	将发票通过电子邮件发送给客户	写入，发送电子邮件
get_invoice_pdf_url	获取发票 PDF 的下载 URL	读取
record_payment	记录发票已收到的付款（记账条目，不会转移资金）	写入
list_customers	按名称、IČO 或电子邮件搜索客户	读取
get_customer	获取一位客户	读取
create_customer	创建客户	写入
update_customer	更新客户	写入
list_expenses	列出费用，可按状态筛选	读取
get_expense	获取一项费用	读取
create_expense	记录一项费用	写入
get_invoice_stats	发票数量统计：总数、已付款、已发送、逾期、草稿	读取
get_cash_flow_summary	指定期间的收入、费用和利润	读取

每个工具都带有 MCP 注解（title、readOnlyHint、destructiveHint、openWorldHint），因此客户端会在调用会更改数据或发送电子邮件的工具前请求确认。

安全

• 使用 OAuth 2.1 和 PKCE（S256）、动态客户端注册（RFC 7591）、带重用检测的刷新令牌轮换，以及 RFC 9207 iss。发现地址：https://doklad.ai/.well-known/oauth-protected-resource/mcp。
• 通过 Doklad.ai 授权页面按公司授予访问权限；只有所有者和管理员可以授予权限。连接可在 集成 → API 密钥和 webhook → 已连接的应用 中查看和撤销。
• 每次工具调用都会写入公司的审计日志。令牌和 API 密钥仅以哈希形式存储。
• 每家公司每分钟 60 次请求。

捷克语

捷克语连接指南：**https://doklad.ai/mcp-fakturace**（Claude、ChatGPT、Codex、Claude Code、Cursor、VS Code、Gemini CLI、n8n）。

支持

[email protected] · https://doklad.ai

许可证

本仓库中的文档和配置文件采用 MIT 许可证。Doklad.ai 服务受其条款和隐私政策约束。