AI导哈

n8n wFirma MCP集成工作流

一个演示如何通过HTTP Streamable协议将n8n与wFirma MCP服务器集成，用于自动化会计操作和发票管理的技术工作流。

  • by nulline-apps
  • 云端部署
  • 更新于
在 GitHub 查看 nulline-apps/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） 与以下标头：

header 值 描述
Content-Type application/json 内容类型
mcp-protocol-version 2025-11-05 MCP协议版本
x-wfirma-credentials JSON 对象 身份验证数据

格式 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 - 文件详情 许可证

相关 MCP