1. Voraussetzungen

• Aktiver Deubner-Account (Login auf https://mcp.ki-deubner.de)
• Claude Desktop, Cursor oder einen anderen MCP-fähigen KI-Assistenten

2. API-Key erstellen

1. Melde dich an: https://mcp.ki-deubner.de
2. Klicke im Menü auf deinen Namen → API-Keys MCP
3. Gib eine Bezeichnung ein, z. B. Claude Desktop Büro
4. Klicke Key erstellen
5. Der Key wird einmalig im Klartext angezeigt — kopiere ihn sofort

3. Claude Desktop einrichten

node --version
npx --version

{
  "mcpServers": {
    "deubner-ki": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.ki-deubner.de/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <dein-api-key>"
      }
    }
  }
}

Cursor IDE

Konfiguration in .cursor/mcp.json im Projektordner oder global unter ~/.cursor/mcp.json:

{
  "mcpServers": {
    "deubner-ki": {
      "url": "https://mcp.ki-deubner.de/mcp",
      "headers": {
        "Authorization": "Bearer <dein-api-key>"
      }
    }
  }
}

VS Code — GitHub Copilot (ab Version 1.99)

Öffne die User-Settings: Strg+Shift+P → Open User Settings JSON. Füge folgenden Eintrag hinzu:

{
  "mcp": {
    "servers": {
      "deubner-ki": {
        "type": "http",
        "url": "https://mcp.ki-deubner.de/mcp",
        "headers": {
          "Authorization": "Bearer <dein-api-key>"
        }
      }
    }
  }
}

Nach dem Speichern erscheinen die Deubner-KI-Tools in der Copilot-Seitenleiste unter Tools.

Microsoft Copilot Studio

Microsoft Copilot Studio verbindet sich nicht per Konfigurationsdatei, sondern über einen Onboarding-Assistenten in der Weboberfläche. Dein API-Key wird dort als API-Schlüssel hinterlegt — kein OAuth nötig.

1. Öffne deinen Agenten in Copilot Studio → Reiter Tools → Ein Tool hinzufügen → Neues Tool → Model Context Protocol (MCP).
2. Trage bei Server-URL ein: https://mcp.ki-deubner.de/mcp
3. Wähle als Authentifizierungstyp API-Schlüssel (nicht OAuth 2.0).
4. Typ: Header. Name des Headers: Authorization. Als Wert trägst du beim Verbinden Bearer <dein-api-key> ein (mit Bearer und Leerzeichen davor).
5. Klicke Erstellen, dann im Test-Chat auf Open Connection Manager → Connect und gib den Wert aus Schritt 4 ein.

4. Verfügbare Tools

5. Beispiele

Benutze ask_taxki:
"Welche Voraussetzungen gelten für den Abzug von
 Homeoffice-Kosten bei Arbeitnehmern in 2024?"

Benutze ask_lokia:
"Wie wird ein geldwerter Vorteil bei der Überlassung
 eines Firmenfahrzeugs berechnet?"

Benutze ask_taxki:
"Erstelle einen Mandantenbrief über die steuerliche
 Behandlung von Photovoltaikanlagen ab 2023."

Benutze ask_taxki:
question:        "Kürze den Brief auf maximal eine DIN-A4-Seite."
conversation_id: "<conversation_id aus der vorherigen Antwort>"

6. API für Entwickler

Wer Token-Erstellung und MCP-Zugriffe vollständig per API steuern möchte, durchläuft zwei Schritte.

Schritt 1 — Einloggen und Token holen

POST https://mcp.ki-deubner.de/api/auth/login
Content-Type: application/json

{
  "email": "deine@email.de",
  "password": "deinPasswort"
}

Response: {"token": "1|AbCdEfGh..."}

Schritt 2 — MCP-Tool aufrufen (JSON-RPC 2.0)

• ask_taxki
• Folgefrage (conversation_id)
• tools/list

POST https://mcp.ki-deubner.de/mcp
Authorization: Bearer 1|AbCdEfGh...
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ask_taxki",
    "arguments": {
      "question": "Welche Voraussetzungen gelten für den Homeoffice-Pauschbetrag?"
    }
  }
}

POST https://mcp.ki-deubner.de/mcp
Authorization: Bearer 1|AbCdEfGh...
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "ask_taxki",
    "arguments": {
      "question": "Gilt die Regelung auch für Selbstständige?",
      "conversation_id": "<conversation_id aus der vorherigen Antwort>"
    }
  }
}

POST https://mcp.ki-deubner.de/mcp
Authorization: Bearer 1|AbCdEfGh...
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/list",
  "params": {}
}

7. API-Key löschen

Unter API-Keys MCP (Menü oben rechts nach Login) sind alle aktiven Keys aufgelistet. Jeder Key zeigt:

• Bezeichnung — der beim Erstellen vergebene Name
• Erstellt am
• Zuletzt verwendet — wann der Key zuletzt für einen MCP-Zugriff genutzt wurde

Mit Löschen wird der Key sofort deaktiviert — alle Verbindungen, die diesen Key verwenden, werden damit ungültig.

8. Fehlerbehebung