pfx

pfx MCP 服务适用于 Forterro Proffix Px5

🇩🇪 德语 | 🇬🇧 英语

适用于 Forterro Proffix Px5 ERP 的 Model Context Protocol 服务

用于将 AI 集成到 Proffix Px5 ERP 的通用接口

通过标准化的 MCP 协议，将 AI 助手（Claude、ChatGPT、Gemini）连接到你的 Proffix Px5。

JSON-RPC 2.0 传输 • 基于参数的身份验证 • 经过处理的 Proffix 端点

🌟 什么是 Model Context Protocol（MCP）？

Model Context Protocol（MCP）是 Anthropic 推出的开放标准，用于安全地集成 AI。AI 助手可以直接访问你的系统，无需手动复制数据或截图。

不使用 MCP：“向我展示所有未结发票”→ 你必须打开 Proffix、导出数据并将其复制到 AI 中

使用 MCP：“向我展示所有未结发票”→ AI 直接访问 Proffix 并提供答案

• **实时访问：**AI 使用你系统中的最新数据
• **安全性：**AI 不会存储任何数据，只进行临时访问
• **自动化：**AI 可以跨多个系统执行复杂任务
• **自然语言：**无需 SQL 或 API 知识
• **标准化：**适用于所有兼容 MCP 的 AI 助手

📋 什么是 pfx MCP？

pfx MCP 是首个适用于 Forterro Proffix Px5 的 MCP 服务。将 Claude、ChatGPT 和 Gemini 等 AI 助手连接到你的 ERP。通过自然语言直接访问数据、创建报告并自动化工作流。

• 通过 MCP 工具直接使用 Proffix 功能
• 为所有 MCP 客户端提供 JSON-RPC 2.0 传输
• 免费 API Key（Beta）
• 兼容 Claude、ChatGPT、Gemini

已正式列入 MCP Registry：

• 📦 Package：ch.pfx/mcp-server
• 🔗 Registry：registry.modelcontextprotocol.io
• 💻 GitHub：github.com/pitwch/pfx-mcp-server
• ✅ 状态：Active • 版本 1.0.0 • 发布于 2025-11-08

💡 实用场景

📊 智能数据查询

示例：“向我展示所有未结发票”

AI 直接访问你的 Proffix 数据并提供结构化结果，无需 SQL 或 API 知识。

🔍 复杂搜索

示例：“搜索名称中包含 ‘Laptop’ 且价格低于 1000 CHF 的商品”

自然语言查询会自动转换为精确的 API 调用。

📈 自动报告

示例：“生成一份按营业额排名的前 10 名客户报告”

AI 汇总数据、进行分析，并以专业格式呈现结果。

🔔 更改跟踪

示例：“本周哪些地址发生了更改？”

实时进行基于时间的查询和更改分析。

💼 更多场景

• 库存管理：“向我展示所有库存低于 10 的商品”
• 客户分析：“分析客户 1001 的营业额变化”
• 工作流自动化：“为 XY 公司创建一个新地址”
• 端点发现：“订单有哪些 API 端点？”
• 多系统查询：“将 Proffix 数据与我们的 CRM 进行比较”

🚀 快速开始

选项 1：一键安装（推荐）🎯

适用于 Claude Desktop 用户——最简单的安装方式！

最快捷的方式——无需手动配置！

1. 获取 API Key
   访问 request-api-key.html 并通过电子邮件申请免费密钥

2. 下载 MCPB Bundle
   下载 pfx-mcp-server.mcpb

3. 安装
   在 Claude Desktop 中：设置 → 扩展 → 高级设置（Extension Developer 区域）→ 安装扩展… → 选择 .mcpb 文件并按照说明操作

4. 输入凭据
   API Key + 你的 Proffix Px5 凭据（用户名、密码、URL、端口、数据库）

5. 完成！
   重启 Claude 并测试：“显示 Proffix Px5 中苏黎世的所有地址”

---

选项 2：手动安装（进阶）⚙️

适用于其他 MCP 客户端或高级配置

适用于其他 MCP 客户端（Cursor、Windsurf、Gemini CLI 等），或你希望自行管理配置的情况：

1. 申请 API Key
   request-api-key.html

2. 下载 Bridge 脚本
   下载 mcp-http-bridge.txt 并将其重命名为 mcp-http-bridge.js

3. 打开配置文件
   根据客户端选择：

   • Claude：%APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）
   • Cursor/Windsurf：参见 AI 客户端设置

4. 添加服务
   参见下方的配置示例：

{
  "mcpServers": {
    "pfx-mcp": {
      "command": "node",
      "args": ["C:\\mcp\\mcp-http-bridge.js", "https://mcp.pfx.ch/api/server"],
      "env": {
        "HTTP_AUTHORIZATION": "Bearer DEIN_API_KEY",
        "PROFFIX_USERNAME": "dein-username",
        "PROFFIX_PASSWORD": "dein-passwort",
        "PROFFIX_URL": "https://dein-proffix.com",
        "PROFFIX_PORT": "11011",
        "PROFFIX_DATABASE": "deine-db",
        "RESPONSE_FORMAT": "json"
      }
    }
  }
}

5. 重启客户端并测试
   向你的 AI 助手提问：“显示 Proffix 中的所有地址”

📚 文档

所有 AI 客户端的完整设置指南：

• 主文档
• AI 客户端设置（Claude、ChatGPT、Gemini、Cursor、Windsurf、Continue.dev）
• 测试与调试

🔧 支持的 MCP 客户端

• ✅ Claude Desktop
• ✅ Cursor IDE
• ✅ Windsurf IDE
• ✅ Continue.dev（VS Code/JetBrains）
• ✅ Gemini CLI
• ⚡ ChatGPT（实验性）
• ✅ 自定义客户端（通过 MCP SDK）

🔒 安全

身份验证

• API Key 用于访问控制（Beta 期间免费）
• Proffix 凭据作为 HTTP Headers 传输（加密传输）
• MCP 服务不存储任何数据
• 基于参数的身份验证，无需会话
• 每次请求都会传输凭据，且不会保存

最佳实践

• 始终使用 HTTPS 进行通信
• 切勿在客户端代码中存储凭据
• 在客户端实施速率限制
• 定期监控 API 访问
• 为 Proffix API 用户设置强密码

服务安全

• 全面的 .htaccess 安全规则
• 保护敏感文件和配置
• 建议使用 HTTPS 加密

🌐 远程服务

pfx MCP 服务作为托管服务运行于：

https://mcp.pfx.ch/api/server

**传输方式：**通过 HTTP 的 JSON-RPC 2.0
状态：https://mcp.pfx.ch/api/version

🔌 Model Context Protocol API

pfx MCP 服务通过 JSON-RPC 2.0 实现标准化的 Model Context Protocol：

MCP 方法

• initialize - 客户端与服务之间的握手。交换功能和协议版本。
• tools/list - 列出所有可用的 Proffix 操作。需要身份验证。
• tools/call - 执行一项 Proffix 操作。参数通过 arguments 传递。

可用的 Proffix 工具

• proffix_search_endpoints - 对 120+ 个端点进行模糊搜索
• proffix_call_endpoint - 直接调用端点
• proffix_describe_endpoint - 端点文档
• 所有特定的 Proffix API 端点（地址、商品、订单等）

响应格式

服务器支持两种响应格式：

• JSON（默认）- 直接来自 Proffix API 的结构化 JSON 响应
• TOON（针对 AI 优化）- 附带自然语言描述的增强响应，针对 AI 处理进行了优化

启用格式：

1. 全局（推荐）- 适用于所有调用：

{
  "name": "proffix_call_endpoint",
  "arguments": {
    "endpointId": 9,
    "format": "toon",
    "params": {
      "limit": 10
    }
  }
}

2. 单次调用 - 覆盖全局设置：

{
  "name": "proffix_call_endpoint",
  "arguments": {
    "endpointId": 9,
    "params": {
      "limit": 10,
      "format": "toon"
    }
  }
}

优先级： params.format > arguments.format > "json"（默认）

服务器 URL： https://mcp.pfx.ch/api/server

🔧 测试示例和调试

💡 示例查询

常规查询

"Zeige mir alle offenen Rechnungen"
"Suche Artikel mit 'Laptop' im Namen"
"Welche Adressen haben sich diese Woche geändert?"
"Erstelle einen Bericht über Umsätze nach Kunde"

各部门示例

• 会计：“显示所有超过 30 天未付款的发票”
• 销售：“列出 2024 年 Q4 状态为‘开放’的所有报价”
• 采购：“哪些订单已逾期？”
• 管理会计：“按产品组生成销售额概览”
• 支持：“查找客户 XY 的所有服务案例”
• 开发：“记录所有可用的 Proffix 端点”

🔗 链接

• 网站： https://mcp.pfx.ch
• API Key： https://mcp.pfx.ch/request-api-key.html
• 状态： https://mcp.pfx.ch/api/version

📄 许可证

MIT License - 详情请参阅 LICENSE 文件

🆘 支持

如有问题：https://mcp.pfx.ch/#kontakt

---

**注意：**需要访问 Forterro Proffix Px5 REST API。