开票 MCP 布置简报
你是独立顾问开票自动化顾问。只根据用户约束写提问清单，不要编造已上线 MCP。
开票系统：{{system}}
是否允许邮件发送：{{email_send}}
工时来源：{{hours_source}}
输出 Markdown：
1. 工具四分域最小集（先未付）
2. OAuth/令牌存放与刷新
3. 建票→人核→发送门禁
4. 人工对账清单
禁止建议无人值守群发催款；禁止声称回款已自动化完成。← 返回用例列表
Peter：给 Claude Code 接 iDoklad MCP——终端里开票、催款、看营收
对照捷克咨询行政：自建 MCP 连 iDoklad；披露 15 工具四分域、OAuth 本机登录、先做未付清单再扩；不代你自动群发催款、不外推。
场景说明
面向每月点网页开票、查未付的独立顾问：把「再开一遍网表」写成可对账的本机 MCP 工具面，区别于多语发票 API 批处理与个人全量财务看板自建。
案例叙事
01他们做了什么
Peter Šutarík 在个人博客《Building an MCP Server So My AI Assistant Can Send Invoices》（页内 27 January 2026；JSON-LD datePublished 2026-01-27 → 2026-01-27；canonical petersutarik.com）写明：跑小型分析咨询，咨询之外每月要在 iDoklad 网页开票、发 PDF、查未付；日常开发已用 Claude Code，于是自建 MCP server，用自然语言驱动开票与营收查询。
架构：Python + httpx + 官方 MCP Python SDK，stdio；模块含 server/config/auth/client 与 tools 下 invoices/contacts/payments/statistics。共披露 15 个工具、四域——开票（建/列/详/下 PDF/邮发，先拉默认模板再叠数据）、联系人、付款（已付/未付/逾期）、分析（按客户/月营收等）。鉴权：iDoklad OAuth2 授权码流对 CLI 别扭，故单独 `idoklad-mcp-login`：本机临时服 11470、浏览器授权、落盘 tokens，之后自动刷新。创建 流程例：「给 ACME 开 40 小时×€120、标准 VAT」→查客户→建票→「发送」。日常：月末贴工时批量建发；月中问未付；季度问分客户营收。学习点：工具描述比实现更费时；从「列未付」最小能力长出来，而非一次做满 15。下一步打算接 GitHub Issues/Projects 工时，一句「给一月所有客户开票」。本场景据此输出「开票 MCP」提纲。禁止建议无人值守群发催款或自动改账标记无核对。
02实际效果
- 源披露 15 工具四分域、OAuth 本机 11470 登录与约 60 秒刷新缓冲、先做未付清单再扩创建/分析，以及月末贴工时批量开票等作者口径；属一人咨询行政叙事，不可外推为你的回款天数、错票率或合规免责。
- 能把「每月点网页开票」与「本机 MCP + 人核发送」拆开。
- 为 OAuth 过期、工具描述含糊误调、以及误开自动催款提供提问清单。
03值得知道
- 令牌与发票 API 在本机；泄露面要按密钥管。
- 工时仍靠人贴——源帖尚未接通任务系统自动汇总结账。
- 上面写的是 Peter 个人实践帖，不是 iDoklad/Anthropic 官文集成指南。
04可复制提示词
误开/错发发票复盘提纲
Agent 建错客户或错 VAT 档并已触发发送，请写复盘提纲。
现象：{{symptom}}
输出：
1. 是工具描述、缺人核门、还是模板覆盖错误
2. 最小门禁补丁
3. 下次验收标准
4. 人工确认清单
不要伪造「开票 MCP 已永不错票」。怎么做
- 粘贴开票系统（如 iDoklad/其他）、是否允许邮件发送发票，以及工时来源（粘贴/表格/GitHub）
- Agent 按实践帖输出：工具四分域→OAuth 本机登录→月结提问清单
- 人工保留发送前核对与催款口吻；Agent 不代你声称账单已无人值守结清
实用提示
- 源帖：15 个工具分开票/联系人/付款/分析；登录命令临时起本机 11470 接 OAuth，令牌存 ~/.idoklad-mcp/tokens.json，刷新留约 60 秒缓冲
- 与 robson-multilang-invoice-claude-api / harry-guinness-claude-quickbooks-finance 不同：本条是既有开票 SaaS 的 MCP 终端面，不是多语 API 批处理或整套财务看板替换