quickfile-mcp

MCP-Server für die Quickfile REST API v2. Multi-Account, mit Secret-Isolation.

Features

• 45 Tools -- eines pro API-operationId, generiert aus der eingebetteten spec.json.

• Multi-Account -- mehrere Quickfile-Konten konfigurierbar; jedes Tool akzeptiert einen account-Parameter.

• Beide Auth-Modi -- statische persönliche Bearer-Tokens und OAuth 2.0 (Auto-Refresh + Persistenz rotierender Refresh-Tokens).

• Secret-Isolation -- Tokens liegen in accounts.json (gitignored), niemals dem KI-Agenten offengelegt. Tool-Schemas legen nur einen account-Selektor + Endpunkt-Parameter offen.

Related MCP server: iikoServer MCP Server

Setup

1. npm install

2. cp accounts.example.json accounts.json und Kontozugangsdaten eintragen.

3. npm run build

4. Konfigurieren Sie Ihren MCP-Client (Claude Desktop usw.):

{
  "mcpServers": {
    "quickfile": {
      "command": "node",
      "args": ["path/to/quickfile-mcp/dist/index.js"],
      "cwd": "path/to/quickfile-mcp"
    }
  }
}

Der Server liest accounts.json aus dem Arbeitsverzeichnis (oder die Umgebungsvariable QF_ACCOUNTS_FILE für einen benutzerdefinierten Pfad). OAuth-Token-Material (accessToken, refreshToken, expiresAt) liegt in einer separaten internen tokens.json (oder QF_TOKENS_FILE), die der Server verwaltet — Sie müssen sie nie von Hand bearbeiten.

Authentifizierung

Statisches Token (eigenes Konto)

Generieren Sie ein Personal Bearer Token in QuickFile: Account Settings -> Third Party Integration -> API. Setzen Sie in accounts.json "type": "static" und "token": "<your token>".

OAuth (Partner-App)

1. Registrieren Sie eine App in QuickFile, um clientId / clientSecret zu erhalten. Tragen Sie diese in accounts.json mit "type": "oauth" ein.

2. Führen Sie den OAuth-Autorisierungs- und Token-Austausch-Flow out-of-band durch (eine kleine CLI oder manuelles Einfügen), um die ersten accessToken, refreshToken und expiresAt zu erhalten.

3. Befüllen Sie tokens.json einmal:

   { "beta": { "accessToken": "...", "refreshToken": "...", "expiresAt": 0 } }

   Danach müssen Sie tokens.json nie wieder anfassen — der Server aktualisiert ablaufende Zugriffstokens automatisch und schreibt das rotierte Refresh-Token zurück.

Kontenauswahl

Jedes Tool akzeptiert einen optionalen account-Parameter (Aufzählung der konfigurierten Bezeichnungen). Lassen Sie ihn weg, um defaultAccount aus accounts.json zu verwenden.

API-Referenz

Vollständige Endpunkt-Schemas: src/spec.json (Swagger 2.0, 45 Pfade). Quelle: Quickfile API-Dokumentation.