|
| 1 | +# Sicherheitsinformationen / Security Information |
| 2 | + |
| 3 | +## Warnung bei Installation / Installation Warning |
| 4 | + |
| 5 | +### 🇩🇪 Deutsch |
| 6 | + |
| 7 | +**Warnung:** "Die Installation gewährt Zugriff auf alles auf deinem Computer." |
| 8 | + |
| 9 | +#### Warum diese Warnung? |
| 10 | + |
| 11 | +Diese Warnung erscheint, weil der MCP Server: |
| 12 | +1. **Node.js ausführt** - Ein vollwertiges Programm mit Dateisystemzugriff |
| 13 | +2. **Auf deine Proffix-Daten zugreift** - Über die REST API |
| 14 | +3. **Netzwerkverbindungen herstellt** - Zu deinem Proffix-Server und mcp.pfx.ch |
| 15 | + |
| 16 | +#### Was macht der Server wirklich? |
| 17 | + |
| 18 | +Der pfx MCP Server: |
| 19 | +- ✅ **Verbindet** sich nur mit `mcp.pfx.ch` (unser Remote-Server) |
| 20 | +- ✅ **Leitet** deine Proffix-Credentials sicher als HTTP-Header weiter |
| 21 | +- ✅ **Speichert KEINE Daten** lokal auf deinem Computer |
| 22 | +- ✅ **Liest KEINE anderen Dateien** außer seiner eigenen Konfiguration |
| 23 | +- ✅ **Ändert NICHTS** an deinem System |
| 24 | + |
| 25 | +#### Technische Details |
| 26 | + |
| 27 | +**Was der Server tut:** |
| 28 | +``` |
| 29 | +Claude Desktop → mcp-http-bridge.js → https://mcp.pfx.ch/api/server → Dein Proffix |
| 30 | +``` |
| 31 | + |
| 32 | +**Berechtigungen die benötigt werden:** |
| 33 | +- **Netzwerk**: Verbindung zu mcp.pfx.ch und deinem Proffix-Server |
| 34 | +- **Umgebungsvariablen**: Lesen der Proffix-Credentials aus der Konfiguration |
| 35 | +- **Keine Dateisystem-Operationen** außer dem Laden des Scripts selbst |
| 36 | + |
| 37 | +#### Ist das sicher? |
| 38 | + |
| 39 | +✅ **JA**, weil: |
| 40 | +1. **Open Source**: Der gesamte Code ist auf GitHub einsehbar |
| 41 | +2. **Keine Datenspeicherung**: Weder lokal noch auf unserem Server |
| 42 | +3. **Direkte Verbindung**: Deine Credentials gehen direkt an deinen Proffix-Server |
| 43 | +4. **Verschlüsselt**: Alle Verbindungen über HTTPS |
| 44 | +5. **Minimaler Code**: Nur ~200 Zeilen JavaScript, leicht überprüfbar |
| 45 | + |
| 46 | +#### Code-Review |
| 47 | + |
| 48 | +Du kannst den kompletten Source Code hier prüfen: |
| 49 | +- **Bridge Script**: [mcp-http-bridge.js](https://github.com/pitwch/pfx-mcp-server/blob/main/mcp-http-bridge.js) |
| 50 | +- **Manifest**: [bundle/manifest.json](https://github.com/pitwch/pfx-mcp-server/blob/main/bundle/manifest.json) |
| 51 | + |
| 52 | +--- |
| 53 | + |
| 54 | +### 🇬🇧 English |
| 55 | + |
| 56 | +**Warning:** "Installation grants access to everything on your computer." |
| 57 | + |
| 58 | +#### Why this warning? |
| 59 | + |
| 60 | +This warning appears because the MCP server: |
| 61 | +1. **Runs Node.js** - A full program with filesystem access |
| 62 | +2. **Accesses your Proffix data** - Via the REST API |
| 63 | +3. **Makes network connections** - To your Proffix server and mcp.pfx.ch |
| 64 | + |
| 65 | +#### What does the server actually do? |
| 66 | + |
| 67 | +The pfx MCP Server: |
| 68 | +- ✅ **Connects** only to `mcp.pfx.ch` (our remote server) |
| 69 | +- ✅ **Forwards** your Proffix credentials securely as HTTP headers |
| 70 | +- ✅ **Stores NO data** locally on your computer |
| 71 | +- ✅ **Reads NO other files** except its own configuration |
| 72 | +- ✅ **Changes NOTHING** on your system |
| 73 | + |
| 74 | +#### Technical Details |
| 75 | + |
| 76 | +**What the server does:** |
| 77 | +``` |
| 78 | +Claude Desktop → mcp-http-bridge.js → https://mcp.pfx.ch/api/server → Your Proffix |
| 79 | +``` |
| 80 | + |
| 81 | +**Required permissions:** |
| 82 | +- **Network**: Connection to mcp.pfx.ch and your Proffix server |
| 83 | +- **Environment variables**: Read Proffix credentials from configuration |
| 84 | +- **No filesystem operations** except loading the script itself |
| 85 | + |
| 86 | +#### Is it safe? |
| 87 | + |
| 88 | +✅ **YES**, because: |
| 89 | +1. **Open Source**: All code is visible on GitHub |
| 90 | +2. **No data storage**: Neither locally nor on our server |
| 91 | +3. **Direct connection**: Your credentials go directly to your Proffix server |
| 92 | +4. **Encrypted**: All connections via HTTPS |
| 93 | +5. **Minimal code**: Only ~200 lines of JavaScript, easy to verify |
| 94 | + |
| 95 | +#### Code Review |
| 96 | + |
| 97 | +You can review the complete source code here: |
| 98 | +- **Bridge Script**: [mcp-http-bridge.js](https://github.com/pitwch/pfx-mcp-server/blob/main/mcp-http-bridge.js) |
| 99 | +- **Manifest**: [bundle/manifest.json](https://github.com/pitwch/pfx-mcp-server/blob/main/bundle/manifest.json) |
| 100 | + |
| 101 | +--- |
| 102 | + |
| 103 | +## Datenschutz / Privacy |
| 104 | + |
| 105 | +### Was wird übertragen? / What is transmitted? |
| 106 | + |
| 107 | +**An mcp.pfx.ch:** |
| 108 | +- ✅ API Key (zur Authentifizierung) |
| 109 | +- ✅ Proffix Credentials (als HTTP Headers) |
| 110 | +- ✅ MCP Anfragen (z.B. "Zeige Adressen") |
| 111 | + |
| 112 | +**NICHT übertragen / NOT transmitted:** |
| 113 | +- ❌ Keine lokalen Dateien / No local files |
| 114 | +- ❌ Keine Browserdaten / No browser data |
| 115 | +- ❌ Keine anderen Programme / No other programs |
| 116 | + |
| 117 | +### Datenfluss / Data Flow |
| 118 | + |
| 119 | +``` |
| 120 | +1. Claude fragt: "Zeige Adressen" |
| 121 | +2. Bridge leitet weiter an mcp.pfx.ch |
| 122 | +3. mcp.pfx.ch ruft dein Proffix ab |
| 123 | +4. Antwort geht zurück zu Claude |
| 124 | +5. KEINE Speicherung irgendwo |
| 125 | +``` |
| 126 | + |
| 127 | +--- |
| 128 | + |
| 129 | +## Häufige Fragen / FAQ |
| 130 | + |
| 131 | +### 🇩🇪 Kann der Server meine Dateien lesen? |
| 132 | + |
| 133 | +**Technisch ja**, aber der Code tut das nicht. Du kannst den Source Code selbst überprüfen - es sind nur ~200 Zeilen. |
| 134 | + |
| 135 | +### 🇩🇪 Warum nicht lokal ohne Remote-Server? |
| 136 | + |
| 137 | +Der Remote-Server bei mcp.pfx.ch: |
| 138 | +- Verwaltet 120+ Proffix Endpoints |
| 139 | +- Stellt Fuzzy-Search bereit |
| 140 | +- Wird zentral aktualisiert |
| 141 | +- Du musst nichts installieren oder warten |
| 142 | + |
| 143 | +### 🇩🇪 Kann ich den Server selbst hosten? |
| 144 | + |
| 145 | +Ja! Der Server-Code ist Open Source. Du kannst ihn auf deinem eigenen Server deployen und die URL im Manifest ändern. |
| 146 | + |
| 147 | +### 🇬🇧 Can the server read my files? |
| 148 | + |
| 149 | +**Technically yes**, but the code doesn't do that. You can review the source code yourself - it's only ~200 lines. |
| 150 | + |
| 151 | +### 🇬🇧 Why not local without remote server? |
| 152 | + |
| 153 | +The remote server at mcp.pfx.ch: |
| 154 | +- Manages 120+ Proffix endpoints |
| 155 | +- Provides fuzzy search |
| 156 | +- Is centrally updated |
| 157 | +- You don't need to install or maintain anything |
| 158 | + |
| 159 | +### 🇬🇧 Can I self-host the server? |
| 160 | + |
| 161 | +Yes! The server code is open source. You can deploy it on your own server and change the URL in the manifest. |
| 162 | + |
| 163 | +--- |
| 164 | + |
| 165 | +## Kontakt / Contact |
| 166 | + |
| 167 | +Bei Sicherheitsbedenken / For security concerns: |
| 168 | +- **Email**: security@pfx.ch |
| 169 | +- **GitHub Issues**: https://github.com/pitwch/pfx-mcp-server/issues |
| 170 | +- **Website**: https://mcp.pfx.ch/#kontakt |
0 commit comments