Einrichtung
1. Persönlichen API-Token erstellen
Öffne in bestdesq Profil → Einstellungen → API-Tokens und klicke + Token.
- Name: sprechender Bezeichner, z. B. Claude Code MacBook
- Berechtigungen: Vollzugriff (empfohlen für eigene, vertrauenswürdige Clients) oder einzelne Scopes auswählen
- Ablauf: 30 Tage / 90 Tage / 1 Jahr / Kein Ablauf
Das Token wird nur einmal im Klartext angezeigt. Direkt unter dem Token erscheint ein fertiges JSON-Snippet für die MCP-Client-Konfiguration – du kannst es mit einem Klick kopieren.
2. MCP-Client konfigurieren
Der MCP-Endpoint deines bestdesq-Accounts lautet:
https://[dein-account].bestdesq.app/mcpClaude Code – ~/.config/claude-code/.mcp.json oder projektlokal .mcp.json:
{
"mcpServers": {
"bestdesq": {
"type": "http",
"url": "https://[dein-account].bestdesq.app/mcp",
"headers": {
"Authorization": "Bearer bdq_pat_DEIN_TOKEN_HIER"
}
}
}
}Cursor – in den Settings unter MCP dieselbe Struktur eintragen. Cursor erkennt den Server beim nächsten Chat-Start automatisch.
Nach dem Speichern den Client neu starten. Wenn die Verbindung steht, meldet sich der Agent mit einer Bestätigung – oder du fragst einfach: „Verbinde dich mit bestdesq."
3. bestdesq-Skill hinterlegen (empfohlen)
Der bestdesq-Skill ist eine Textdatei, die deinem KI-Agenten erklärt, wie bestdesq funktioniert – Abläufe, Konventionen, wann er handeln soll und wann er nachfragen soll. Ohne Skill können Agenten die Tools zwar nutzen, müssen aber mehr improvisieren.
Den Skill stellst du einmalig in deiner KI-Umgebung bereit. Er ist eine einfache Textdatei und kann an deine eigenen Abläufe angepasst werden.
Verfügbare Tools
bestdesq stellt 32 MCP-Tools bereit, aufgeteilt nach Bereichen. Welche Tools ein Token sieht, hängt von den konfigurierten Berechtigungen ab – ein Read-only-Token sieht bestdesq_create_task gar nicht erst.
Projekte & Übersicht
| Tool | Was es tut |
|---|---|
bestdesq_list_projects | Alle Projekte auflisten, filterbar nach Status |
bestdesq_get_project_summary | Projektdetails mit Task-Statistik, Budget und Zeitauslastung |
bestdesq_get_dashboard | Persönlicher Überblick: offene Tasks, Deadlines, Projektgesundheit, fällige Rechnungen |
bestdesq_get_status_keys | Gültige Status-Werte für ein Projekt-Workflow abfragen |
Typische Anfragen:
„Welche Projekte sind aktiv und wo gibt es Budgetprobleme?"
„Gib mir meinen Tagesüberblick mit allen offenen Tasks und fälligen Rechnungen."
Tasks
| Tool | Was es tut |
|---|---|
bestdesq_list_tasks | Tasks eines Projekts auflisten, filterbar nach Status und Priorität |
bestdesq_get_task | Task-Details inkl. Kommentare und Checklisten |
bestdesq_search_tasks | Volltext-Suche über Task-Titel |
bestdesq_find_overdue_tasks | Überfällige Tasks finden |
bestdesq_create_task | Neuen Task anlegen |
bestdesq_update_task | Task ändern – Status, Titel, Priorität, Zuweisung |
bestdesq_create_task_heading | Überschrift / Gruppe im Projekt anlegen |
bestdesq_add_comment | Kommentar zu einem Task hinzufügen |
bestdesq_add_checklist | Checklisten-Gruppe auf einem Task anlegen |
bestdesq_add_checklist_items | Punkte zu vorhandener Checkliste hinzufügen |
bestdesq_toggle_checklist_item | Einzelnen Punkt abhaken oder aufheben |
Typische Anfragen:
„Lege im Projekt Website-Relaunch einen Task ‚Hero-Section überarbeiten' mit Priorität hoch an."
„Welche Tasks in Projekt 26-004 sind überfällig und wem sind sie zugewiesen?"
„Markiere Task 1234 als erledigt."
Zeiterfassung
| Tool | Was es tut |
|---|---|
bestdesq_log_time | Zeit auf einem Task buchen |
bestdesq_get_time_summary | Zeitauswertung nach Projekt, User oder Zeitraum |
Typische Anfragen:
„Buche 90 Minuten auf Task ‚Wireframes' in Projekt 26-002, heute, Beschreibung: Konzept überarbeitet."
„Wie viel Zeit hat das Team im April auf das TMV-Portal gebucht?"
Ausgangsrechnungen
| Tool | Was es tut |
|---|---|
bestdesq_list_planned_invoices | Geplante Rechnungen auflisten |
bestdesq_get_invoicing_status | Übersicht: fällig, überfällig, kürzlich erstellt |
bestdesq_get_invoice | Einzelne Rechnung lesen |
bestdesq_generate_invoice | Geplante Rechnung in echte Rechnung umwandeln |
bestdesq_update_planned_invoice | Geplante Rechnung anpassen |
Typische Anfragen:
„Welche Rechnungen sind diesen Monat fällig?"
„Erstelle die Abschlagsrechnung für Projekt Müller GmbH, Leistungszeitraum Mai 2026."
Eingangsrechnungen
| Tool | Was es tut |
|---|---|
bestdesq_fetch_incoming_invoices | Neue Rechnungen aus dem E-Mail-Postfach holen; E-Rechnungen werden automatisch geparst |
bestdesq_parse_incoming_invoice | PDF oder XML-Datei parsen und Belegdaten extrahieren |
bestdesq_list_incoming_invoices | Gespeicherte Eingangsrechnungen auflisten |
bestdesq_get_incoming_invoice | Einzelne Eingangsrechnung lesen |
bestdesq_import_incoming_invoices | Geparste Belege als Eingangsrechnungen speichern |
bestdesq_update_incoming_invoice | Gespeicherte Eingangsrechnung bearbeiten |
bestdesq_upload_incoming_invoice_attachment | Anhang zu einer Eingangsrechnung verknüpfen |
Typische Anfragen:
„Hole neue Eingangsrechnungen aus dem Postfach und zeig mir die extrahierten Beträge."
„Importiere die geparsten Rechnungen – Lieferant ist bereits zugeordnet."
Kontakte
| Tool | Was es tut |
|---|---|
bestdesq_list_organisations | Kunden und Lieferanten auflisten |
bestdesq_search_organisations | Nach Name, Kürzel oder USt-ID suchen |
bestdesq_create_organisation | Neue Organisation anlegen |
Typische Anfragen:
„Gibt es schon einen Lieferanten-Eintrag für Muster AG?"
„Lege einen neuen Kunden-Eintrag für Digital Studios GmbH an."
Berechtigungen
Jeder API-Token hat Scopes, die festlegen, welche Tools er nutzen darf. Scopes folgen dem Schema entity:action – ein Token mit task:write darf implizit auch lesen.
Der effektive Zugriff ist immer die Schnittmenge aus Token-Scopes und der Rolle des Benutzers. Ein Token kann nie mehr, als der Benutzer in der bestdesq-UI sehen würde.
Empfohlene Scope-Profile:
| Anwendungsfall | Scopes |
|---|---|
| Nur lesen und recherchieren | project:read, task:read, time-record:read |
| Task-Arbeit und Zeiterfassung | project:read, task:write, time-record:write |
| Ausgangsrechnungen | zusätzlich invoice:read, invoice:write |
| Eingangsrechnungen | incoming-invoice:read, incoming-invoice:write, organisation:read |
| Vollzugriff (eigene, vertrauenswürdige Clients) | keine Scopes auswählen |
Was der Agent nicht tut
- Rechnungen werden nicht versendet. Der Agent kann Rechnungen erstellen – der Versand liegt bei dir.
- Der Agent handelt im Rahmen deines Tokens. Was dein Token nicht darf, sieht der Agent nicht einmal als verfügbares Tool.
- Keine automatischen Aktionen. Der Agent führt Tool-Calls nur auf explizite Aufforderung hin aus – er überwacht nicht im Hintergrund.
Weiterführend
- API-Dokumentation – vollständige REST-API-Referenz
- MCP-Integration im Überblick – was der MCP-Server ermöglicht