Fakto.app - wFirma MCP Server

Fakto.app — wFirma 和 Fakturownia 的 MCP 服务

Polska wersja / Polish version → README.pl.md

Fakto.app 是托管的 Model Context Protocol（MCP）服务，可将 AI 助手——Claude、ChatGPT、n8n、Make 及其他任何 MCP 客户端——连接到波兰最受欢迎的两大会计平台：

• wFirma.pl — 45 个 MCP 工具
• Fakturownia.pl — 37 个 MCP 工具

用日常语言直接向 AI 助手发出指令，即可开具发票、查询承包商、分析财务状况、查看库存或预测现金流。

此代码仓库包含托管服务 fakto.app 的文档、示例和提示词。服务本身由托管方管理，且为闭源服务——你无需自行运行任何内容。

端点

系统	端点	传输方式
wFirma	https://fakto.app/wfirma/stream	HTTP Streamable（JSON-RPC）
Fakturownia	https://fakto.app/fakturownia/stream	HTTP Streamable（JSON-RPC）

两者均支持 OAuth 2.0 和动态客户端注册（RFC 7591）——Claude 和 ChatGPT 无需手动配置客户端即可连接。

快速开始

1. 创建账户

在 fakto.app 注册——提供免费套餐（无需信用卡）——然后在控制面板中连接你自己的 wFirma 或 Fakturownia API 密钥。

2. 连接客户端

Claude（桌面版或 claude.ai）

1. Settings → Connectors → Add custom connector
2. URL：https://fakto.app/wfirma/stream（或 /fakturownia/stream）
3. 点击 Connect——系统将引导你完成 OAuth，并要求你输入一次 API 密钥。

ChatGPT

1. Settings → Connectors → 添加 MCP 服务
2. 服务 URL：https://fakto.app/wfirma/stream
3. Discovery URL：https://fakto.app/.well-known/openid-configuration
4. 将 Client ID/Secret 留空——ChatGPT 会自动注册自身（RFC 7591）。

n8n / Make / 自定义自动化

使用在 fakto.app 控制面板中生成的 Bearer token，或在请求头中传递凭据：

POST https://fakto.app/wfirma/stream
Authorization: Bearer <token from dashboard>
Content-Type: application/json

可直接使用的 n8n 工作流位于 examples/n8n/——导入 JSON，设置环境变量，即可完成。分步指南（波兰语）：

• Claude 快速入门
• ChatGPT 快速入门
• n8n 快速入门
• Make 快速入门

3. 试用

“显示我最近的 3 张发票” · “为 ACME Sp. z o.o. 开具一张咨询服务发票，净额 5000 PLN” · “哪些发票已逾期？” · “总结我上个月的收入”

工具

所有 82 个工具的完整自动生成列表（发票、承包商、费用、仓库、付款、税务登记簿/KPiR、财务分析、预测、自动化）请见 TOOLS.md。

AI 会计师提示词

prompts/asystent-ksiegowy-pl.md 包含一份经过实战验证的波兰语 AI 会计 Agent 系统提示词（适用于 n8n AI Agent、Claude Projects、自定义 GPT）——涵盖波兰 VAT 税率、纳税期限、回复格式和安全规则。

安全性

• 凭据采用 AES-256-GCM 加密后静态存储，且绝不记录日志。
• 全程使用 TLS；服务器托管在欧盟；符合 GDPR 要求。
• 你连接的是自己的 wFirma/Fakturownia API 密钥——数据直接在 AI 客户端、Fakto.app 和你的会计系统之间流动。

定价

免费套餐（只读，每月 100 次请求），以及提供发票创建、仓库、分析和预测功能的付费套餐：fakto.app/mcp/pricing。

支持

• 指南（波兰语）：fakto.app/mcp/poradniki
• 常见问题：fakto.app/mcp/faq
• 电子邮件：[email protected]

许可证

本仓库的内容（文档、示例工作流、提示词）采用 MIT License 发布。Fakto.app 服务本身为专有服务。