{
  "markdown": "# pfx MCP Server für Forterro Proffix Px5\n\n**🇩🇪 Deutsch | [🇬🇧 English](README.en.md)**\n\n**Model Context Protocol Server für Forterro Proffix Px5 ERP**\n\nDie universelle Schnittstelle für AI/KI-Integration mit deinem Proffix Px5 ERP\n\nVerbinde AI-Assistenten (Claude, ChatGPT, Gemini) mit deinem Proffix Px5 über standardisiertes MCP-Protokoll.\n\n**JSON-RPC 2.0 Transport • Parameterbasierte Auth • Aufbereitete Proffix Endpoints**\n\n## 🌟 Was ist das Model Context Protocol (MCP)?\n\nModel 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.\n\n**Ohne MCP:** \"Zeig mir alle offenen Rechnungen\" → Du musst Proffix öffnen, Daten exportieren, in die KI kopieren\n\n**Mit MCP:** \"Zeig mir alle offenen Rechnungen\" → Die KI greift direkt auf Proffix zu und liefert die Antwort\n\n- **Echtzeit-Zugriff:** KI arbeitet mit aktuellen Daten aus deinen Systemen\n- **Sicherheit:** Keine Daten werden in der KI gespeichert - nur temporärer Zugriff\n- **Automatisierung:** KI kann komplexe Aufgaben über mehrere Systeme hinweg ausführen\n- **Natürliche Sprache:** Keine SQL oder API-Kenntnisse erforderlich\n- **Standardisiert:** Funktioniert mit allen MCP-kompatiblen KI-Assistenten\n\n## 📋 Was ist pfx MCP?\n\npfx 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.\n\n- **Proffix Funktionen** direkt via MCP Tools\n- **JSON-RPC 2.0 Transport** für alle MCP-Clients\n- **Kostenloser API Key** (Beta)\n- **Claude, ChatGPT, Gemini Ready**\n\n**Offiziell gelistet im MCP Registry:**\n- 📦 Package: `ch.pfx/mcp-server`\n- 🔗 Registry: [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)\n- 💻 GitHub: [github.com/pitwch/pfx-mcp-server](https://github.com/pitwch/pfx-mcp-server)\n- ✅ Status: Active • Version 1.0.0 • Published 2025-11-08\n\n## 💡 Praktische Anwendungsfälle\n\n### 📊 Intelligente Datenabfragen\n**Beispiel:** \"Zeige mir alle offenen Rechnungen\"\n\nDie KI greift direkt auf deine Proffix-Daten zu und liefert strukturierte Ergebnisse - ohne SQL oder API-Kenntnisse.\n\n### 🔍 Komplexe Suchen\n**Beispiel:** \"Suche Artikel mit 'Laptop' im Namen und Preis unter 1000 CHF\"\n\nNatürliche Sprachabfragen werden automatisch in präzise API-Calls umgewandelt.\n\n### 📈 Automatische Berichte\n**Beispiel:** \"Erstelle einen Bericht über die Top 10 Kunden nach Umsatz\"\n\nDie KI aggregiert Daten, erstellt Analysen und formatiert Ergebnisse professionell.\n\n### 🔔 Änderungsverfolgung\n**Beispiel:** \"Welche Adressen haben sich diese Woche geändert?\"\n\nZeitbasierte Abfragen und Änderungsanalysen in Echtzeit.\n\n### 💼 Weitere Anwendungsfälle\n- **Lagerverwaltung:** \"Zeige mir alle Artikel mit Lagerbestand unter 10\"\n- **Kundenanalysen:** \"Analysiere die Umsatzentwicklung von Kunde 1001\"\n- **Workflow-Automatisierung:** \"Erstelle eine neue Adresse für Firma XY\"\n- **Endpoint-Discovery:** \"Welche API-Endpoints gibt es für Aufträge?\"\n- **Multi-System-Abfragen:** \"Vergleiche Proffix-Daten mit unserem CRM\"\n\n## 🚀 Quick Start\n\n### Option 1: One-Click Installation (Empfohlen) 🎯\n\n**Für Claude Desktop Benutzer - Einfachste Installation!**\n\nDie schnellste Methode - keine manuelle Konfiguration nötig!\n\n1. **API Key holen**  \n   Besuche [request-api-key.html](https://mcp.pfx.ch/request-api-key.html) und fordere deinen kostenlosen Key an (per E-Mail)\n\n2. **MCPB Bundle laden**  \n   [pfx-mcp-server.mcpb herunterladen](https://github.com/pitwch/pfx-mcp-server/releases/latest/download/pfx-mcp-server.mcpb)\n\n3. **Installieren**  \n   In Claude Desktop: Einstellungen → Erweiterungen → Erweiterte Einstellungen (Bereich Extension Developer) → Erweiterung installieren… → die `.mcpb` Datei auswählen und den Anweisungen folgen\n\n4. **Zugangsdaten eingeben**  \n   API Key + deine Proffix Px5 Credentials (Username, Passwort, URL, Port, Datenbank)\n\n5. **Fertig!**  \n   Claude neu starten und testen: *\"Zeige mir alle Adressen aus Zürich aus Proffix Px5\"*\n\n---\n\n### Option 2: Manuelle Installation (Fortgeschritten) ⚙️\n\n**Für andere MCP-Clients oder erweiterte Konfiguration**\n\nFür andere MCP-Clients (Cursor, Windsurf, Gemini CLI, etc.) oder wenn du die Konfiguration selbst verwalten möchtest:\n\n1. **API Key anfordern**  \n   [request-api-key.html](https://mcp.pfx.ch/request-api-key.html)\n\n2. **Bridge-Script laden**  \n   [mcp-http-bridge.txt](https://mcp.pfx.ch/bridge/mcp-http-bridge.txt) herunterladen und zu `mcp-http-bridge.js` umbenennen\n\n3. **Config-Datei öffnen**  \n   Je nach Client:\n   - Claude: `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) oder `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)\n   - Cursor/Windsurf: Siehe [AI Client Setup](https://mcp.pfx.ch/ai-clients.html)\n\n4. **Server hinzufügen**  \n   Siehe Beispiel-Config unten:\n\n```json\n{\n  \"mcpServers\": {\n    \"pfx-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"C:\\\\mcp\\\\mcp-http-bridge.js\", \"https://mcp.pfx.ch/api/server\"],\n      \"env\": {\n        \"HTTP_AUTHORIZATION\": \"Bearer DEIN_API_KEY\",\n        \"PROFFIX_USERNAME\": \"dein-username\",\n        \"PROFFIX_PASSWORD\": \"dein-passwort\",\n        \"PROFFIX_URL\": \"https://dein-proffix.com\",\n        \"PROFFIX_PORT\": \"11011\",\n        \"PROFFIX_DATABASE\": \"deine-db\",\n        \"RESPONSE_FORMAT\": \"json\"\n      }\n    }\n  }\n}\n```\n\n5. **Client neu starten und testen**  \n   Frage deinen AI-Assistenten: *\"Zeige mir alle Adressen aus Proffix\"*\n\n## 📚 Dokumentation\n\nVollständige Setup-Anleitungen für alle AI-Clients:\n- **[Hauptdokumentation](https://mcp.pfx.ch)**\n- **[AI Client Setup](https://mcp.pfx.ch/ai-clients.html)** (Claude, ChatGPT, Gemini, Cursor, Windsurf, Continue.dev)\n- **[Testing & Debug](https://mcp.pfx.ch/debug.html)**\n\n## 🔧 Unterstützte MCP-Clients\n\n- ✅ Claude Desktop\n- ✅ Cursor IDE\n- ✅ Windsurf IDE\n- ✅ Continue.dev (VS Code/JetBrains)\n- ✅ Gemini CLI\n- ⚡ ChatGPT (experimentell)\n- ✅ Custom Clients (via MCP SDK)\n\n## 🔒 Sicherheit\n\n### Authentifizierung\n- **API Key** für Zugriffskontrolle (kostenlos während Beta)\n- **Proffix Credentials** als HTTP Headers (verschlüsselt übertragen)\n- **Keine Datenspeicherung** auf MCP Server\n- **Parameterbasierte Auth** ohne Sessions\n- Zugangsdaten werden bei jeder Anfrage übertragen und nicht gespeichert\n\n### Best Practices\n- Verwende immer HTTPS für die Kommunikation\n- Speichere Zugangsdaten niemals im Client-Code\n- Implementiere Rate-Limiting auf Client-Seite\n- Überwache API-Zugriffe regelmäßig\n- Verwende starke Passwörter für Proffix API Benutzer\n\n### Server-Sicherheit\n- Umfassende .htaccess Sicherheitsregeln\n- Schutz sensibler Dateien und Konfigurationen\n- HTTPS-Verschlüsselung wird empfohlen\n\n## 🌐 Remote Server\n\nDer pfx MCP Server läuft als **hosted service** unter:\n```\nhttps://mcp.pfx.ch/api/server\n```\n\n**Transport:** JSON-RPC 2.0 via HTTP  \n**Status:** [https://mcp.pfx.ch/api/version](https://mcp.pfx.ch/api/version)\n\n## 🔌 Model Context Protocol API\n\nDer pfx MCP Server implementiert das standardisierte Model Context Protocol über JSON-RPC 2.0:\n\n### MCP Methoden\n- **initialize** - Handshake zwischen Client und Server. Tauscht Capabilities und Protokollversion aus.\n- **tools/list** - Listet alle verfügbaren Proffix-Operationen auf. Erfordert Authentifizierung.\n- **tools/call** - Führt eine Proffix-Operation aus. Parameter werden in `arguments` übergeben.\n\n### Verfügbare Proffix Tools\n- `proffix_search_endpoints` - Fuzzy-Search über 120+ Endpoints\n- `proffix_call_endpoint` - Direkter Endpoint-Aufruf\n- `proffix_describe_endpoint` - Endpoint-Dokumentation\n- Alle spezifischen Proffix API Endpoints (Adressen, Artikel, Aufträge, etc.)\n\n### Response Formate\n\nDer Server unterstützt zwei Antwortformate:\n\n- **JSON** (Standard) - Strukturierte JSON-Antworten direkt von der Proffix API\n- **TOON** (AI-optimiert) - Angereicherte Antworten mit natürlichsprachigen Beschreibungen, optimiert für AI-Verarbeitung\n\n**Format-Aktivierung:**\n\n1. **Global** (empfohlen) - Gilt für alle Aufrufe:\n```json\n{\n  \"name\": \"proffix_call_endpoint\",\n  \"arguments\": {\n    \"endpointId\": 9,\n    \"format\": \"toon\",\n    \"params\": {\n      \"limit\": 10\n    }\n  }\n}\n```\n\n2. **Per-Call** - Überschreibt globale Einstellung:\n```json\n{\n  \"name\": \"proffix_call_endpoint\",\n  \"arguments\": {\n    \"endpointId\": 9,\n    \"params\": {\n      \"limit\": 10,\n      \"format\": \"toon\"\n    }\n  }\n}\n```\n\n**Priorität:** `params.format` > `arguments.format` > `\"json\"` (Standard)\n\n**Server URL:** `https://mcp.pfx.ch/api/server`\n\n[🔧 Test-Beispiele & Debugging](https://mcp.pfx.ch/debug.html)\n\n## 💡 Beispiel-Abfragen\n\n### Allgemeine Abfragen\n```\n\"Zeige mir alle offenen Rechnungen\"\n\"Suche Artikel mit 'Laptop' im Namen\"\n\"Welche Adressen haben sich diese Woche geändert?\"\n\"Erstelle einen Bericht über Umsätze nach Kunde\"\n```\n\n### Abteilungsspezifische Beispiele\n- **Rechnungswesen:** \"Zeige alle unbezahlten Rechnungen älter als 30 Tage\"\n- **Vertrieb:** \"Liste alle Angebote aus Q4 2024 mit Status 'Offen'\"\n- **Einkauf:** \"Welche Bestellungen sind überfällig?\"\n- **Controlling:** \"Erstelle eine Umsatzübersicht nach Produktgruppen\"\n- **Support:** \"Finde alle Servicefälle von Kunde XY\"\n- **Entwicklung:** \"Dokumentiere alle verfügbaren Proffix-Endpoints\"\n\n## 🔗 Links\n\n- **Website:** [https://mcp.pfx.ch](https://mcp.pfx.ch)\n- **API Key:** [https://mcp.pfx.ch/request-api-key.html](https://mcp.pfx.ch/request-api-key.html)\n- **Status:** [https://mcp.pfx.ch/api/version](https://mcp.pfx.ch/api/version)\n\n## 📄 License\n\nMIT License - See LICENSE file for details\n\n## 🆘 Support\n\nBei Fragen: [https://mcp.pfx.ch/#kontakt](https://mcp.pfx.ch/#kontakt)\n\n---\n\n**Hinweis:** Erfordert Zugang zur Forterro Proffix Px5 REST API.\n",
  "bytes": 9762,
  "sha": "f033511ed3278f2ca7d7e2b70dd092c4a8620c1a956bb1136dd4e597bd831a79",
  "repo_slug": "pitwch/pfx-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ch_pfx_mcp_server_76afa555/readme"
}