Das Model Context Protocol (MCP) macht bestdesq für KI-Assistenten lesbar und bedienbar. Dieser Beitrag zeigt, wie du deinen KI-Agenten mit deinem bestdesq-Account verbindest – und was er danach für dich erledigt.

Worum es geht

Viele arbeiten inzwischen mit einem KI-Assistenten wie Claude oder mit einem Code-Editor, der KI eingebaut hat, etwa Cursor. Solche Assistenten schreiben Texte, fassen zusammen und beantworten Fragen. An deine Projekte, Aufgaben und Rechnungen kommen sie aber nicht heran. Die liegen in bestdesq, und davon weiß der Assistent nichts.

Das Model Context Protocol ist ein offener Standard, der genau diese Lücke schließt. Man kann es sich als gemeinsamen Stecker vorstellen: Eine Anwendung bietet über diesen Stecker ihre Funktionen an, und jeder KI-Assistent, der den Stecker kennt, kann sie benutzen. bestdesq hat einen solchen Stecker eingebaut, einen MCP-Server. Ein Assistent, der darüber mit bestdesq verbunden ist, heißt im Folgenden KI-Agent: Er kann in bestdesq nachsehen und dort auch etwas anlegen oder ändern.

Im Alltag sieht das so aus: Du schreibst deinem Agenten „Welche Projekte laufen gerade über Budget?“, und er schaut in bestdesq nach und antwortet mit den Zahlen. Du schreibst „Buche 90 Minuten auf die Aufgabe Wireframes“, und die Zeit steht in deiner Zeiterfassung. Du musst dafür nicht zwischen Chat und bestdesq hin- und herwechseln.

38

Werkzeuge stellt der MCP-Server bereit – für Projekte, Aufgaben, Zeiterfassung, Rechnungen und Kontakte.

Die Kontrolle bleibt dabei bei dir:

• Der Agent arbeitet mit einem persönlichen Zugangsschlüssel, den du selbst anlegst und jederzeit widerrufst.
• Er darf nie mehr als du selbst in bestdesq.
• Er wird nur tätig, wenn du ihn darum bittest.
• Rechnungen legt er an, verschickt sie aber nicht.

KI in der App oder KI von außen

Es gibt zwei Wege, KI mit einer Geschäftsanwendung zusammenzubringen. Viele Anwendungen bauen einen eigenen Assistenten ein: ein Chatfenster in der App, hinter dem ein KI-Anbieter steht, den der Hersteller ausgesucht hat. bestdesq geht den anderen Weg. Es hat keinen eingebauten Assistenten, sondern öffnet sich über MCP für den Assistenten, den du ohnehin benutzt.

KI von außen über MCP

• Du arbeitest mit dem Assistenten, den du schon kennst.
• Du wählst den KI-Anbieter – und damit, wer deine Daten zu sehen bekommt.
• Ein Assistent für mehrere Werkzeuge: Im Code-Editor buchst du die Zeit, ohne ihn zu verlassen.
• Kein KI-Aufschlag im Preis von bestdesq.

KI in der App

• Sofort da, ohne Einrichtung.
• Anbieter und Modell legt der Hersteller fest.
• Kennt nur diese eine Anwendung.
• Die Kosten stecken im Preis oder kommen als Aufpreis dazu.

Der Weg von außen hat seinen Preis: Du brauchst ein KI-Programm, das MCP beherrscht, und richtest die Verbindung einmal ein. Wie gut die Antworten sind, hängt von deinem Assistenten ab, nicht von bestdesq.

Ich halte ihn trotzdem für den besseren, weil die KI so dein Werkzeug bleibt und nicht meins. Du entscheidest, welchen Assistenten du nutzt, was er kostet und welchem Anbieter du deine Daten anvertraust. Und wenn morgen ein besserer Assistent erscheint, wechselst du, ohne dass sich an bestdesq etwas ändern muss.

FunktionMCP-Server / KI

Was du brauchst

Du brauchst einen bestdesq-Account mit aktivem Abo; die kostenlose Testphase zählt dazu. Dazu kommt ein KI-Programm, das MCP-Server über das Internet anbinden kann (im MCP-Jargon: Streamable HTTP). Unten beschreibe ich die Einrichtung für Claude Code und Cursor. Andere Programme funktionieren nach demselben Muster, wenn sie erlauben, der Verbindung eine eigene Anmeldezeile mitzugeben (einen Header).

Die Einrichtung dauert etwa zehn Minuten. Ab hier wird es technischer.

Einrichtung Schritt für Schritt

1. Zugangsschlüssel in bestdesq anlegen

   Der Agent meldet sich bei bestdesq mit einem persönlichen Zugangsschlüssel an, einem API-Token. Öffne über dein Profilbild Profil, dann links Einstellungen und dort den Reiter API-Tokens. Mit + Token legst du einen neuen an.

   Unter Profil › Einstellungen › API-Tokens. Die Liste zeigt für jedes Token, wann es zuletzt benutzt wurde und wann es abläuft.

   

   Im Dialog vergibst du drei Dinge:

   • Token-Name: ein Name, an dem du das Token später wiedererkennst, zum Beispiel „Claude Code Laptop“.
   • Ablauf: 30 Tage, 90 Tage, 1 Jahr oder kein Ablauf. Vorgewählt sind 90 Tage.
   • Berechtigungen: Vorgewählt ist Vollzugriff, also alles, was du selbst in bestdesq darfst. Nimmst du das Häkchen heraus, wählst du einzeln aus, was der Agent lesen oder bearbeiten darf. Welche Auswahl wofür reicht, steht unten im Abschnitt Berechtigungen.

   Nach Erstellen zeigt bestdesq das Token genau einmal an. Kopiere es sofort und bewahre es auf wie ein Passwort. Es beginnt mit bdq_pat_.

2. Adresse deines MCP-Servers

   Der MCP-Server deines Accounts hat diese Adresse; statt dein-account steht dort der Name, mit dem du dich auch bei bestdesq anmeldest:

   https://dein-account.bestdesq.app/mcp

3. KI-Programm verbinden

   Claude Code: Ein Befehl im Terminal genügt. Setze deine Adresse und dein Token ein:

   claude mcp add --transport http bestdesq https://dein-account.bestdesq.app/mcp \
     --header "Authorization: Bearer bdq_pat_DEIN_TOKEN"

   Ohne weitere Angabe gilt die Verbindung für das Projekt, in dem du den Befehl ausführst, und nur für dich. Mit --scope user steht bestdesq in allen deinen Projekten bereit.

   Soll ein ganzes Team die Verbindung nutzen, gehört sie in die Datei .mcp.json im Projekt. Das Token schreibst du dort nicht hinein, sondern verweist auf eine Umgebungsvariable, die jeder bei sich setzt. So landet kein Schlüssel im Repository:

   {
     "mcpServers": {
       "bestdesq": {
         "type": "http",
         "url": "https://dein-account.bestdesq.app/mcp",
         "headers": {
           "Authorization": "Bearer ${BESTDESQ_TOKEN}"
         }
       }
     }
   }

   Cursor: Trage die Verbindung in ~/.cursor/mcp.json ein (für alle Projekte) oder in .cursor/mcp.json im Projektordner. Umgebungsvariablen schreibt Cursor als ${env:NAME}:

   {
     "mcpServers": {
       "bestdesq": {
         "url": "https://dein-account.bestdesq.app/mcp",
         "headers": {
           "Authorization": "Bearer ${env:BESTDESQ_TOKEN}"
         }
       }
     }
   }

   Speichern und Cursor neu starten.

4. Verbindung prüfen

   In Claude Code zeigt claude mcp list im Terminal, ob der Server verbunden ist; innerhalb einer Sitzung öffnet /mcp dieselbe Übersicht. In Cursor findest du die Server unter Customize › MCPs.

   Dann die erste Frage an den Agenten, zum Beispiel: „Welche Aufgaben in bestdesq sind überfällig?“ Antwortet er mit deinen Aufgaben, steht die Verbindung.

Tipp

Leg für jedes Gerät und jedes Programm ein eigenes Token an. Geht ein Laptop verloren, widerrufst du genau dieses eine, und die übrigen Verbindungen laufen weiter.

Was dein Agent danach kann

Der MCP-Server bietet dem Agenten 38 Werkzeuge an (im MCP-Jargon Tools). Du musst sie nicht kennen, der Agent sucht sich selbst das passende aus. Die Übersicht hilft dir aber einzuschätzen, was du fragen kannst. Die Werkzeuge liefern ihre Texte in der Sprache deines Accounts.

Überblick und Projekte

Werkzeug	Was es tut
bestdesq_daily_briefing	Tagesüberblick: überfällige Aufgaben, Projekte mit Problemen, anstehende Rechnungen, Leads ohne Aktivität
bestdesq_get_dashboard	Dein persönliches Dashboard
bestdesq_list_projects	Projekte auflisten, nach Status oder Nummer gefiltert
bestdesq_get_project_summary	Überblick über ein Projekt; Geldbeträge je nach deiner Rolle
bestdesq_update_project	Titel, Beschreibung, Status, Termine oder Budget eines Projekts ändern
bestdesq_project_close_readiness	Prüfen, ob ein Projekt abgeschlossen werden kann

„Gib mir meinen Tagesüberblick.“ „Welche Projekte laufen über Budget?“

Aufgaben

Werkzeug	Was es tut
bestdesq_list_tasks	Aufgaben eines Projekts, nach Status oder Priorität gefiltert
bestdesq_get_task	Eine Aufgabe mit Beschreibung, Kommentaren, Checkliste und Unteraufgaben
bestdesq_search_tasks	Volltextsuche über alle Projekte
bestdesq_find_overdue_tasks	Aufgaben über dem Termin, die noch nicht erledigt sind
bestdesq_get_status_keys	Die gültigen Status eines Projekts
bestdesq_create_task	Aufgabe anlegen
bestdesq_update_task	Status, Priorität und Felder ändern, Aufgaben verschieben
bestdesq_create_task_heading	Überschrift zum Gruppieren anlegen, bis zu drei Ebenen
bestdesq_add_comment	Kommentar schreiben, in deinem Namen
bestdesq_add_checklist	Checkliste an eine Aufgabe hängen
bestdesq_add_checklist_items	Punkte zu einer Checkliste hinzufügen
bestdesq_toggle_checklist_item	Punkt abhaken oder wieder öffnen

„Lege im Projekt Website-Relaunch die Aufgabe ‚Startseite überarbeiten‘ mit hoher Priorität an.“ „Markiere die Aufgabe Wireframes als erledigt.“

Zeiterfassung

Werkzeug	Was es tut
bestdesq_log_time	Minuten auf eine Aufgabe buchen
bestdesq_get_time_summary	Gebuchte Zeit je Person und Aufgabe

„Buche 90 Minuten auf die Aufgabe Wireframes, heute, Beschreibung: Konzept überarbeitet.“

Ausgangsrechnungen

Werkzeug	Was es tut
bestdesq_get_invoicing_status	Diesen Monat fällig, überfällig, zuletzt erstellt
bestdesq_list_planned_invoices	Geplante Rechnungen, etwa Abschläge
bestdesq_invoicing_readiness	Welche geplanten Rechnungen bereit sind und welche woran hängen
bestdesq_get_invoice	Eine Rechnung im Detail
bestdesq_update_planned_invoice	Geplante Rechnung korrigieren, bevor sie erstellt wird
bestdesq_generate_invoice	Aus einer geplanten Rechnung eine echte machen
bestdesq_convert_due_invoices	Alle fälligen, bereiten Rechnungen auf einmal erstellen – auf Wunsch erst als Vorschau
bestdesq_payment_followup	Überfällige, unbezahlte Rechnungen; legt auf Wunsch interne Erinnerungsaufgaben an

„Welche Rechnungen sind diesen Monat fällig?“ „Erstelle die Abschlagsrechnung für die Müller GmbH, Leistungszeitraum Mai.“

Eingangsrechnungen

Werkzeug	Was es tut
bestdesq_fetch_incoming_invoices	Neue Rechnungen aus dem dafür eingerichteten Postfach holen und auslesen
bestdesq_parse_incoming_invoice	Eine einzelne XRechnung, ZUGFeRD- oder PDF-Datei auslesen
bestdesq_import_incoming_invoices	Ausgelesene Belege als Eingangsrechnungen speichern
bestdesq_list_incoming_invoices	Eingangsrechnungen auflisten
bestdesq_get_incoming_invoice	Eine Eingangsrechnung im Detail
bestdesq_update_incoming_invoice	Lieferant, Konto, Fälligkeit, Status oder Projekt korrigieren
bestdesq_upload_incoming_invoice_attachment	PDF oder Bild an eine Eingangsrechnung hängen

„Hol die neuen Rechnungen aus dem Postfach und zeig mir die Beträge.“

Kontakte

Werkzeug	Was es tut
bestdesq_list_organisations	Kunden und Lieferanten auflisten
bestdesq_search_organisations	Nach Name, Kürzel oder USt-ID suchen
bestdesq_create_organisation	Organisation anlegen

„Gibt es schon einen Lieferanten Muster AG?“

Berechtigungen

Jedes Token trägt Berechtigungen. Sie folgen dem Muster Bereich und Stufe, etwa Projekte lesen oder Projekte bearbeiten; wer bearbeiten darf, darf auch lesen. Der Agent sieht nur die Werkzeuge, die seine Berechtigungen erreichen. Ein Token, das nur lesen darf, bekommt das Werkzeug zum Anlegen von Aufgaben gar nicht erst angeboten.

Eine Besonderheit gilt für Aufgaben. In bestdesq hängen Aufgaben an Projekten, Leads oder Angeboten. Die Aufgaben-Werkzeuge brauchen deshalb Berechtigungen für alle drei Bereiche: Projekte, Leads und Angebote. Fehlt einer, sieht der Agent keine Aufgaben.

Wofür	Berechtigungen
Nur nachsehen	Projekte, Leads und Angebote lesen; Zeiterfassung lesen
Aufgaben und Zeiterfassung	Projekte, Leads und Angebote bearbeiten; Zeiterfassung bearbeiten
Ausgangsrechnungen	zusätzlich Rechnungen lesen oder bearbeiten
Eingangsrechnungen	Eingangsrechnungen bearbeiten, Organisationen lesen
Eigene, vertrauenswürdige Programme	Vollzugriff

Über allem steht deine Rolle. bestdesq sagt es selbst im Dialog: „Ein Token kann nie mehr als du selbst: deine Rolle begrenzt immer das, worauf das Token zugreifen darf – auch bei Vollzugriff.“

Was der Agent nicht tut

• Er verschickt nichts. Rechnungen legt er als offen an. Prüfen und versenden tust du in bestdesq. Auch bei überfälligen Rechnungen schickt er keine Mahnung, sondern legt dir höchstens eine Aufgabe zur Erinnerung an.
• Er arbeitet nicht im Hintergrund. Der Server wird nur tätig, wenn dein Agent eine Anfrage stellt. Es gibt keine Überwachung und keine Automatik.
• Er bleibt in deinem Rahmen. Was Token und Rolle nicht erlauben, kann er nicht. Über deine Tokens gehen höchstens 1.000 Anfragen pro Stunde.

Wenn du den Zugang beenden willst

Unter Profil › Einstellungen › API-Tokens siehst du alle Tokens mit dem Zeitpunkt ihrer letzten Nutzung. Mit Widerrufen endet ein Zugang sofort; ein Programm, das dieses Token nutzt, kommt ab dann nicht mehr hinein. Deine Tokens sieht und verwaltet niemand außer dir, auch nicht, wer im Account die Rolle Owner hat.

Gleich selbst ausprobieren?

Die Demo läuft ohne Anmeldung.

Demo öffnen

Weiterführend

• MCP-Server im Überblick – was die KI-Anbindung in bestdesq möglich macht
• API-Dokumentation – die REST-Schnittstelle für eigene Entwicklungen