ch.pfx/mcp-server

Install

Config snippet generator goes here (5 client tabs)

README

# pfx MCP Server für Forterro Proffix Px5

**🇩🇪 Deutsch | [🇬🇧 English](README.en.md)**

**Model Context Protocol Server für Forterro Proffix Px5 ERP**

Die universelle Schnittstelle für AI/KI-Integration mit deinem Proffix Px5 ERP

Verbinde AI-Assistenten (Claude, ChatGPT, Gemini) mit deinem Proffix Px5 über standardisiertes MCP-Protokoll.

**JSON-RPC 2.0 Transport • Parameterbasierte Auth • Aufbereitete Proffix Endpoints**

## 🌟 Was ist das Model Context Protocol (MCP)?

Model Context Protocol (MCP) ist ein offener Standard von Anthropic für sichere AI-Integration. KI-Assistenten greifen direkt auf deine Systeme zu - ohne manuelle Datenkopien oder Screenshots.

**Ohne MCP:** "Zeig mir alle offenen Rechnungen" → Du musst Proffix öffnen, Daten exportieren, in die KI kopieren

**Mit MCP:** "Zeig mir alle offenen Rechnungen" → Die KI greift direkt auf Proffix zu und liefert die Antwort

- **Echtzeit-Zugriff:** KI arbeitet mit aktuellen Daten aus deinen Systemen
- **Sicherheit:** Keine Daten werden in der KI gespeichert - nur temporärer Zugriff
- **Automatisierung:** KI kann komplexe Aufgaben über mehrere Systeme hinweg ausführen
- **Natürliche Sprache:** Keine SQL oder API-Kenntnisse erforderlich
- **Standardisiert:** Funktioniert mit allen MCP-kompatiblen KI-Assistenten

## 📋 Was ist pfx MCP?

pfx MCP ist der erste MCP Server für Forterro Proffix Px5. Verbinde AI-Assistenten wie Claude, ChatGPT und Gemini mit deinem ERP. Greife auf Daten zu, erstelle Berichte und automatisiere Workflows - direkt über natürliche Sprache.

- **Proffix Funktionen** direkt via MCP Tools
- **JSON-RPC 2.0 Transport** für alle MCP-Clients
- **Kostenloser API Key** (Beta)
- **Claude, ChatGPT, Gemini Ready**

**Offiziell gelistet im MCP Registry:**
- 📦 Package: `ch.pfx/mcp-server`
- 🔗 Registry: [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)
- 💻 GitHub: [github.com/pitwch/pfx-mcp-server](https://github.com/pitwch/pfx-mcp-server)
- ✅ Status: Active • Version 1.0.0 • Published 2025-11-08

## 💡 Praktische Anwendungsfälle

### 📊 Intelligente Datenabfragen
**Beispiel:** "Zeige mir alle offenen Rechnungen"

Die KI greift direkt auf deine Proffix-Daten zu und liefert strukturierte Ergebnisse - ohne SQL oder API-Kenntnisse.

### 🔍 Komplexe Suchen
**Beispiel:** "Suche Artikel mit 'Laptop' im Namen und Preis unter 1000 CHF"

Natürliche Sprachabfragen werden automatisch in präzise API-Calls umgewandelt.

### 📈 Automatische Berichte
**Beispiel:** "Erstelle einen Bericht über die Top 10 Kunden nach Umsatz"

Die KI aggregiert Daten, erstellt Analysen und formatiert Ergebnisse professionell.

### 🔔 Änderungsverfolgung
**Beispiel:** "Welche Adressen haben sich diese Woche geändert?"

Zeitbasierte Abfragen und Änderungsanalysen in Echtzeit.

### 💼 Weitere Anwendungsfälle
- **Lagerverwaltung:** "Zeige mir alle Artikel mit Lagerbestand unter 10"
- **Kundenanalysen:** "Analysiere die Umsatzentwicklung von Kunde 1001"
- **Workflow-Automatisierung:** "Erstelle eine neue Adresse für Firma XY"
- **Endpoint-Discovery:** "Welche API-Endpoints gibt es für Aufträge?"
- **Multi-System-Abfragen:** "Vergleiche Proffix-Daten mit unserem CRM"

## 🚀 Quick Start

### Option 1: One-Click Installation (Empfohlen) 🎯

**Für Claude Desktop Benutzer - Einfachste Installation!**

Die schnellste Methode - keine manuelle Konfiguration nötig!

1. **API Key holen**  
   Besuche [request-api-key.html](https://mcp.pfx.ch/request-api-key.html) und fordere deinen kostenlosen Key an (per E-Mail)

2. **MCPB Bundle laden**  
   [pfx-mcp-server.mcpb herunterladen](https://github.com/pitwch/pfx-mcp-server/releases/latest/download/pfx-mcp-server.mcpb)

3. **Installieren**  
   In Claude Desktop: Einstellungen → Erweiterungen → Erweiterte Einstellungen (Bereich Extension Developer) → Erweiterung installieren… → die `.mcpb` Datei auswählen und den Anweisungen folgen

4. **Zugangsdaten eingeben**  
   API Key + deine Proffix Px5 Credentials (Username, Passwort, URL, Port, Datenbank)

5. **Fertig!**  
   Claude neu starten und testen: *"Zeige mir alle Adressen aus Zürich aus Proffix Px5"*

---

### Option 2: Manuelle Installation (Fortgeschritten) ⚙️

**Für andere MCP-Clients oder erweiterte Konfiguration**

Für andere MCP-Clients (Cursor, Windsurf, Gemini CLI, etc.) oder wenn du die Konfiguration selbst verwalten möchtest:

1. **API Key anfordern**  
   [request-api-key.html](https://mcp.pfx.ch/request-api-key.html)

2. **Bridge-Script laden**  
   [mcp-http-bridge.txt](https://mcp.pfx.ch/bridge/mcp-http-bridge.txt) herunterladen und zu `mcp-http-bridge.js` umbenennen

3. **Config-Datei öffnen**  
   Je nach Client:
   - Claude: `%APPDATA%\Claude\claude_desktop_config.json` (Windows) oder `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
   - Cursor/Windsurf: Siehe [AI Client Setup](https://mcp.pfx.ch/ai-clients.html)

4. **Server hinzufügen**  
   Siehe Beispiel-Config unten:

```json
{
  "mcpServers": {
    "pfx-mcp": {