MCP Server einrichten Praxis Desk Kasse

Verbinde eine externe Anwendung mit dem Offisy MCP Server, um auf deine Praxisdaten zuzugreifen.

Voraussetzungen

• Du hast einen API Token erstellt.
• Die Zielanwendung unterstützt das MCP-Protokoll (z. B. Claude Code, Claude Desktop, Cursor).

Claude Code einrichten

1. Öffne die Datei ~/.claude/settings.json oder verwende den Befehl in deinem Terminal.
2. Füge folgende Konfiguration ein:

{
  "mcpServers": {
    "offisy": {
      "url": "https://my.offisy.at/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_TOKEN"
      }
    }
  }
}

Alternativ per Terminal:

claude mcp add-json offisy '{"url":"https://my.offisy.at/mcp","headers":{"Authorization":"Bearer DEIN_TOKEN"}}'

3. Ersetze DEIN_TOKEN durch den kopierten API Token.

Hinweis: Claude Code verwendet den Streamable HTTP Transport und verbindet sich direkt über die URL.

Claude Desktop einrichten

1. Öffne Claude Desktop und navigiere zu Einstellungen > Entwickler > Konfiguration bearbeiten.
2. Füge folgende Konfiguration ein:

{
  "mcpServers": {
    "offisy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://my.offisy.at/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer DEIN_TOKEN"
      }
    }
  }
}

3. Ersetze DEIN_TOKEN durch den kopierten API Token.

Hinweis: Claude Desktop benötigt Node.js auf deinem Rechner, da mcp-remote als stdio-Proxy verwendet wird.

Andere Anwendungen (Cursor, Windsurf)

Die Konfiguration hängt von der jeweiligen Anwendung ab. Du benötigst in jedem Fall:

• MCP Server URL: https://my.offisy.at/mcp
• Authorization Header: Bearer DEIN_TOKEN

Prüfe die Dokumentation deiner Anwendung, ob sie Streamable HTTP oder stdio als Transport unterstützt.

Einrichtung über Offisy

Du findest die Konfigurationsbeispiele auch direkt in Offisy:

1. Öffne Einstellungen > MCP API Tokens.
2. Klicke auf Einrichtung.
3. Wähle deine Anwendung (Claude Code oder Claude Desktop).
4. Kopiere die angezeigte Konfiguration.

Verwandte Artikel

• API Token erstellen
• API Tokens verwalten