Client Setup — pfx MCP für Proffix Px5

← Zurück

Gemeinsame Voraussetzungen

MCP API Key (kostenlos) — Header Authorization: Bearer …
Proffix: User (optional bei LoginToken), Passwort/Token, URL, Port, Datenbank — als X-Proffix-* bzw. Bridge-Env
Standard-Tools: px_*. Legacy: X-Legacy-Mode: 1
Verbindung prüfen: API testen

Client wählen

Webview Chatbot

Zero-Install Demo — Proffix serverseitig, LLM-Key in den Einstellungen.

Chatbot öffnen
⚙️ Einstellungen: LLM-Provider + Key (optional MCP Key / eigener Mandant)
Fragen stellen, z.B. „Zeig offene Debitoren“

URL-Parameter (optional)

https://mcp.pfx.ch/webview/chatbot.html?demo=1
https://mcp.pfx.ch/webview/chatbot.html?mcpkey=…&geminikey=…&pxdb=…&pxurl=…&pxpass=…

Jetzt testen

Claude Desktop

Empfohlen: MCPB One-Click.

API Key anfordern
pfx-mcp-server.mcpb laden
Claude → Einstellungen → Erweiterungen → Erweiterung installieren… → Bundle wählen
API Key + Proffix-Credentials eingeben, Claude neu starten

Manuell (Bridge + Config, Windows)

Bridge: mcp-http-bridge.txt → als mcp-http-bridge.js speichern (z.B. C:\mcp\).

Config: %APPDATA%\Claude\claude_desktop_config.json

{
  "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"
      }
    }
  }
}

LoginToken: PROFFIX_USERNAME weglassen, Token als PROFFIX_PASSWORD.

Verbindung testen

Cursor IDE

Settings → Features → Model Context Protocol
Server hinzufügen:

{
  "mcpServers": {
    "pfx-mcp": {
      "url": "https://mcp.pfx.ch/api/server",
      "headers": {
        "Authorization": "Bearer DEIN_API_KEY",
        "X-Proffix-Username": "IHR_USERNAME",
        "X-Proffix-Password": "IHR_PASSWORT",
        "X-Proffix-Url": "https://ihr-proffix-server.com",
        "X-Proffix-Port": "11011",
        "X-Proffix-Database": "IHRE_DATENBANK"
      }
    }
  }
}

Ctrl/Cmd+Shift+P → Reload Window

Gemini CLI

npm install -g @google/gemini-cli
Bridge laden und als mcp-http-bridge.js speichern
Config ~/.config/gemini/mcp_config.json:

{
  "mcpServers": {
    "pfx-mcp": {
      "command": "node",
      "args": ["/path/to/mcp-http-bridge.js", "https://mcp.pfx.ch/api/server"],
      "env": {
        "HTTP_AUTHORIZATION": "Bearer DEIN_API_KEY",
        "PROFFIX_USERNAME": "IHR_USERNAME",
        "PROFFIX_PASSWORD": "IHR_PASSWORT",
        "PROFFIX_URL": "https://ihr-proffix-server.com",
        "PROFFIX_PORT": "11011",
        "PROFFIX_DATABASE": "IHRE_DATENBANK"
      }
    }
  }
}

ChatGPT / OpenAI

ChatGPT-MCP braucht oft einen bezahlten Plan mit Developer Mode. Alternativ: OpenAI API + eigener Client gegen /api/server.

Gleiche Header wie unter Voraussetzungen. Zum Ausprobieren ohne ChatGPT: Webview Chatbot.

MCP Inspector

npx @modelcontextprotocol/inspector
Transport HTTP → URL https://mcp.pfx.ch/api/server
Custom Headers: API Key + X-Proffix-*
tools/list / tools/call ausführen

Details & CURL

Windsurf

MCP analog zu Cursor: HTTP-URL https://mcp.pfx.ch/api/server mit Authorization- und Proffix-Headern.

Continue.dev

Continue-Config öffnen und MCP-Server mit Bridge (stdio) oder HTTP wie bei Claude/Cursor eintragen.

MCP SuperAssistant

Browser-Extension: Server-URL und Header wie oben setzen. Details in der Extension-Doku.

Custom Client

POST https://mcp.pfx.ch/api/server mit JSON-RPC Body und Headern. Beispiele: debug.html.