fakto.app n8n example

n8n-wFirma MCP集成工作流程

n8n 工作流示例演示了通过 HTTP Streamable 与企业 MCP 服务器的集成。

📋 描述

本工作流向您展示如何将 n8n 连接到企业内的 MCP 服务器，以便直接从 n8n 自动化级别自动化会计操作和管理发票。

机器人十大工作流程：

✅ 初始化到MCP服务器的连接（JSON-RPC 2.0）\ ✅ 调用工具 get_invoices 带过滤参数\ ✅ 处理结果并返回下载的发票数量

🚀 快速启动

要求

• n8n（自托管润滑油云）
• 拥有API访问权限的活动帐户
• MCP 订阅密钥 facto.app

Krok 1：导入工作流

1. 打开 n8n
2. 转到 工作流 → 从文件导入
3. 选择文件 n8n-http-streamable-mcp-workflow.json

步骤 2：更新 Endpoint URL

更新HTTP请求节点中的URL：

https://fakto.app/wfirma/stream

步骤 3：设置 Headers

工作流使用模型上下文协议 （MCP） 与以下标头：

格式 x-wfirma-credentials:

{
  "accessKey":"2158c549....",
  "secretKey":"182a0dda2.....",
  "appKey":"408ead4b.....",
  "companyId":"25...9",
  "subscription_api_key":"ak_prod_SgtDfYTb...."
}

Krok 4：测试

点击 执行工作流 检查发票是否正确收取。

🛠️ 可用的MCP工具

连接到公司内的MCP服务器后，您可以访问50多个工具：

📄 发票

• get_invoices - 下载过滤发票列表
• get_invoice - 按ID下载单个发票
• create_invoice 创建新发票
• get_invoice_pdf - 下载PDF发票

👥 Kontrahenci

• get_contractors - 承包商名单
• create_contractor -Dodawanie kontrahenta
• get_contractor_by_nip 寻找 NIP

📦 杂志

• get_stock - 库存状态
• get_warehouses - 仓库列表

💰 Finanse

• get_financial_summary 财务摘要
• get_expenses - 支出清单
• get_payments - 付款
• predict_payments - 付款预测

🤖 与AI Agent集成

您也可以使用此工作流与 AI Agent （LangChain） 节点一起创建智能会计助理：

┌─────────────┐     ┌───────────┐     ┌─────────────────┐
│   Webhook   │ ──▶ │  AI Agent │ ──▶ │ MCP wFirma Tool │
└─────────────┘     └───────────┘     └─────────────────┘
                          │
                          ▼
                   ┌─────────────┐
                   │   Response  │
                   └─────────────┘

AI Agent查询示例：

• “给我看最近5张未付账单”
• “生成2024年1月财务报告”
• “查找NIP 1234567890的承包商”
• “这个月发票的金额是多少？”

🔧 解决问题

❌ 错误：“凭据无效”

• 检查标头中的JSON格式 x-wfirma-credentials
• 请确保 companyId 数字（不是字符串）

❌ 错误：“需要订阅API密钥”

• 添加 subscriptionApiKey 做凭证
• 请检查密钥是否已激活 facto.app

❌ 错误：“超时”

• 增加超时 设置 → 执行 → 超时 （60000毫秒）

❌ 错误：“找不到工具”

• 检查 URL 是否以 /stream
• 使用正确的端点： https://fakto.app/wfirma/stream

📚 文档

• 🌐 facto.app API密钥门户
• 📧 Wsparcie：contact@nulline.pl

📝 许可证

MIT License - 文件详情 许可证