🌟 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.
- Praktisch alle Proffix Funktionen via MCP Tools
- JSON-RPC 2.0 Transport für alle MCP-Clients
- Kostenloser API Key (Beta)
- Claude, ChatGPT, Gemini Ready
Der pfx MCP Server ist offiziell im Model Context Protocol Registry von Anthropic gelistet:
📦 Package: ch.pfx/mcp-server
🔗 Registry: registry.modelcontextprotocol.io
💻 GitHub: github.com/pitwch/pfx-mcp-server
✅ Status: Active • Version 1.1.8• Published 13.11.2025
💡 Praktische Anwendungsfälle
Entdecke, wie pfx MCP deine tägliche Arbeit mit Proffix Px5 revolutioniert:
📊 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.
💼 Kundenanalysen
Beispiel: "Analysiere die Umsatzentwicklung von Kunde 1001"
Detaillierte Kundenprofile mit Umsatzhistorie, Bestellungen und Trends.
📦 Lagerverwaltung
Beispiel: "Zeige mir alle Artikel mit Lagerbestand unter 10"
Bestandsüberwachung und automatische Warnungen bei niedrigen Lagerständen.
🔄 Workflow-Automatisierung
Beispiel: "Erstelle eine neue Adresse für Firma XY mit Kontaktdaten"
Automatisiere wiederkehrende Aufgaben durch natürliche Sprachbefehle.
📋 Multi-System-Abfragen
Beispiel: "Vergleiche Proffix-Daten mit unserem CRM"
Kombiniere Daten aus mehreren Systemen für umfassende Analysen.
🎯 Endpoint-Discovery
Beispiel: "Welche API-Endpoints gibt es für Aufträge?"
Fuzzy-Search über Funktionen - finde schnell die richtige API-Operation.
- Rechnungswesen: "Zeige alle unbezahlten Rechnungen älter als 30 Tage"
- Vertrieb: "Liste alle Angebote aus Q4 2024 mit Status 'Offen'"
- Einkauf: "Welche Bestellungen sind überfällig?"
- Controlling: "Erstelle eine Umsatzübersicht nach Produktgruppen"
- Support: "Finde alle Servicefälle von Kunde XY"
- Entwicklung: "Dokumentiere alle verfügbaren Proffix-Endpoints"
🤖 AI/KI Integration für Proffix Px5
Gemini und Claude im Einsatz mit Proffix Px5 - Natürliche Sprachabfragen direkt auf deine ERP-Daten
Verbinde deine Forterro Proffix Px5 Installation mit führenden AI/KI-Assistenten. Der pfx MCP Server unterstützt alle MCP-kompatiblen AI-Plattformen für intelligente Proffix Px5 Datenabfragen:
🤖 Claude Desktop
Anthropic's Claude Desktop App mit nativer MCP-Unterstützung.
🧠 OpenAI / ChatGPT
ChatGPT mit MCP-Integration über Custom Actions oder API.
✨ Google Gemini
Google's Gemini AI mit MCP-Integration über API.
💎 Gemini CLI
Google's Gemini mit nativer MCP-Unterstützung via CLI.
💻 Cursor IDE
AI-powered Code Editor mit MCP-Unterstützung.
🔍 MCP Inspector
Offizielles MCP Testing und Debugging Tool.
⚙️ Custom Client
Eigene Integration mit JavaScript, Python, etc.
- ChatGPT MCP-Integration: Erfordert aktuell einen bezahlten ChatGPT-Plan mit Developer Mode (z.B. Plus/Team/Enterprise). Die Verfügbarkeit kann sich ändern.
- OpenAI API-Integration: Funktioniert ohne ChatGPT Premium. Benötigt lediglich einen OpenAI API Key (Pay-as-you-go).
🔑 Sichere Authentifizierung für Forterro Proffix Px5
Der pfx MCP Server verwendet sichere, parameterbasierte Authentifizierung für deine Proffix Px5 REST API. Zugangsdaten werden verschlüsselt als HTTP-Header übertragen und niemals gespeichert.
→ Jetzt kostenlosen API Key anfordern (30 Sekunden)
✨ Kostenlos während der Beta • Ein Key pro E-Mail • Unkompliziert • Schützt nur vor Bots/SPAM (kein Datenzugriff)
🚀 So verwendest du deinen API Key:
{
"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_HIER",
"PROFFIX_USERNAME": "dein-user",
"PROFFIX_PASSWORD": "dein-passwort",
"PROFFIX_URL": "https://dein-proffix.com",
"PROFFIX_PORT": "dein-port",
"PROFFIX_DATABASE": "deine-db"
}
}
}
}
Authorization: Bearer pfx_abc123...xyz789
oder
X-API-Key: pfx_abc123...xyz789
curl -H "Authorization: Bearer DEIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' \
https://mcp.pfx.ch/api/server
X-Proffix-Username(Header)- Dein Proffix API Benutzername
X-Proffix-Password(Header)- Dein Proffix API Passwort (oder API-Key, je nach Instanz)
💡 Tipp: Unterstützt sowohl Klartext-Passwörter als auch SHA256-Hashes (64 Hex-Zeichen) X-Proffix-Url(Header)- Die Basis-URL deines Proffix REST API Servers, ohne
/pxapi/... X-Proffix-Port(Header, optional)- Port des Proffix API Servers (z.B.
11011) X-Proffix-Database(Header, optional)- Proffix Datenbankname
X-Proffix-Modules(Header, optional)-
Proffix Module für die Session (Default:
VOL). Komma‑separiert oder mehrfach.Beispiele:VOL·AUF
🔌 Model Context Protocol API für Proffix Px5
Der pfx MCP Server implementiert das standardisierte Model Context Protocol über JSON-RPC 2.0 für nahtlose AI/KI-Integration mit Forterro Proffix Px5:
initialize
Handshake zwischen Client und Server. Tauscht Capabilities und Protokollversion aus.
tools/list
Listet alle verfügbaren Proffix-Operationen auf. Erfordert Authentifizierung.
tools/call
Führt eine Proffix-Operation aus. Parameter werden in arguments übergeben.
https://mcp.pfx.ch/api/server🔒 Transport: HTTP POST mit JSON-RPC 2.0
🔑 Auth: HTTP Headers (X-Proffix-*)
🔒 Sicherheit für Proffix Px5 AI/KI-Integration
- Zugangsdaten werden bei jeder Anfrage übertragen und nicht gespeichert
- Keine Benutzerverwaltung oder Session-Speicherung
- HTTPS-Verschlüsselung wird empfohlen
- Umfassende .htaccess Sicherheitsregeln
- Schutz sensibler Dateien und Konfigurationen
- Verwende immer HTTPS für die Kommunikation
- Speichere Zugangsdaten niemals im Client-Code
- Implementiere Rate-Limiting auf Client-Seite
- Überwache API-Zugriffe regelmässig
- Verwende starke Passwörter für Proffix API Benutzer
🚀 Schnellstart - In 5 Minuten startklar
Verbinde deinen AI-Assistenten mit Proffix Px5 in wenigen Schritten. Die Forterro ERP-Lösung wird so intelligent nutzbar.
- Proffix Px5 Zugang: Username, Passwort, Server-URL, Port, Datenbank
- AI-Client: Claude Desktop (empfohlen), ChatGPT, Gemini oder anderer MCP-Client
- API Key: Kostenlos anfordern (30 Sekunden)
🎯 Empfohlen: One-Click Installation (Claude Desktop)
Die schnellste Methode - keine manuelle Konfiguration nötig!
- API Key holen: Besuche request-api-key.html und fordere deinen kostenlosen Key an (per E-Mail)
- MCPB Bundle laden: pfx-mcp-server.mcpb herunterladen
- Installieren: In Claude Desktop: Einstellungen → Erweiterungen → Erweiterte Einstellungen (Bereich Extension Developer) → Erweiterung installieren… → die
.mcpbDatei auswählen und den Anweisungen folgen - Zugangsdaten eingeben: API Key + deine Proffix Px5 Credentials (Username, Passwort, URL, Port, Datenbank)
- Fertig! Claude neu starten und testen: "Zeige mir alle Adressen aus Zürich aus Proffix Px5"
Ein MCPB (Model Context Protocol Bundle) enthält alle nötigen Dateien und Konfigurationen. Die Installation erfolgt in Claude Desktop über Einstellungen → Erweiterungen → Erweiterte Einstellungen → Erweiterung installieren…. Danach nur noch deine Zugangsdaten eingeben.
⚙️ Alternative: Manuelle Installation
Für andere MCP-Clients (Cursor, Windsurf, Gemini CLI, etc.) oder wenn du die Konfiguration selbst verwalten möchtest:
- API Key anfordern: request-api-key.html
- Bridge-Script laden: mcp-http-bridge.txt herunterladen und zu
mcp-http-bridge.jsumbenennen - Config-Datei öffnen: Je nach Client (z.B.
%APPDATA%\Claude\claude_desktop_config.jsonfür Claude) - Server hinzufügen: Siehe Beispiel-Config unten
- Client neu starten und testen
{
"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-user",
"PROFFIX_PASSWORD": "dein-passwort",
"PROFFIX_URL": "https://dein-proffix.com",
"PROFFIX_PORT": "11011",
"PROFFIX_DATABASE": "deine-db"
}
}
}
}
⚙️ Technische Details
- Transport: JSON-RPC 2.0
- Methoden: initialize, tools/*, prompts/*
- HTTP POST zu
/api/server
- API Key:
Authorization: Bearer - Proffix: HTTP Headers (
X-Proffix-*) - Keine Sessions, keine Speicherung
- Version: {{VERSION}}
- Build: {{BUILD_DATE}}
- Base: mcp.pfx.ch
/api/server- MCP JSON-RPC 2.0 Endpoint/api/version- Server Version & Build Info
- Kompakte Antworten: GET-Responses entfernen Null-/leere Felder automatisch
- Describe-API mit Detailstufen:
overview,compact,full(für schnelle, LLM-freundliche Ergebnisse) - Mehrteilige Inhalte: Klar getrennte Markdown- und JSON-Codeblöcke
- Best Practices:
fieldsnutzen,limit/offsetsetzen,filtereinschränken,depthklein halten
📞 Fragen und Support
Hast du Fragen zu pfx MCP oder benötigst du Unterstützung bei der Integration mit Proffix Px5? Unser Team steht dir gerne zur Verfügung!
Pedrett IT+Web AG
Murgtalstrasse 20
9542 Münchwilen
Schweiz
📞 Telefon: 071 966 66 00
✉️ E-Mail: [email protected]
🌐 Website: www.pitw.ch
- Integration von pfx MCP mit deiner Proffix Px5 Installation
- Konfiguration von AI-Clients (Claude, ChatGPT, Gemini)
- Custom MCP-Entwicklung und Anpassungen für Forterro Proffix
- Troubleshooting und technischem Support
- Schulungen und Workshops