Claude via MCP verbinden

TskVlo enthält einen eingebauten MCP-Server (Model Context Protocol), mit dem KI-Assistenten wie Claude deine Projektdaten in Echtzeit lesen und schreiben können. Diese Anleitung führt durch die vollständige Einrichtung und zeigt, wie du anfängst, Aufgaben über natürliche Konversation zu verwalten.

Was ist MCP?

MCP ist ein offener Standard von Anthropic zum Verbinden von KI-Sprachmodellen mit externen Tools und Datenquellen. Der KI-Client (Claude) verbindet sich mit einem MCP-Server (TskVlo), der eine Reihe benannter Tools bereitstellt. Wenn du die KI bittest, etwas mit deinen Aufgaben zu tun, ruft sie die entsprechenden Tools auf und die Ergebnisse fließen zurück in dein Gespräch.

Der entscheidende Vorteil gegenüber traditionellen Integrationen ist, dass die KI strukturierten, Live-Zugriff auf deine Daten hat — nicht nur Text, den du hineinkopiert hast. Sie kann den aktuellen Status abfragen, Änderungen vornehmen und mehrere Operationen basierend auf einer einzigen Anweisung verketten.

Voraussetzungen

Ein TskVlo-Konto mit der Rolle Eigentümer oder Admin in dem Workspace, den du verbinden möchtest — nur sie können einen KI-Client autorisieren oder API-Schlüssel erstellen
Ein MCP-kompatibler KI-Client: Claude (claude.ai, Claude Desktop, Claude Code), Cursor oder ein anderer Client, der Remote-MCP-Server unterstützt

Die MCP-Server-URL

Egal, wie du dich verbindest — der TskVlo MCP-Server ist erreichbar unter:

https://dash.tskvlo.app/api/mcp

Du findest die Adresse auch in TskVlo unter Workspace-Einstellungen → API-Schlüssel im Abschnitt MCP-Server.

Zwei Wege zur Verbindung

	OAuth (empfohlen)	Workspace-API-Schlüssel
Einrichtung	URL eingeben, anmelden, bestätigen	Schlüssel erstellen, in die Client-Konfiguration einfügen
Handelt als	Du — Kommentare und Uploads tragen deinen Namen	Kein Nutzer — Inhalte erscheinen als von „MCP User” verfasst
Benachrichtigungs-Tools	✅	❌ (ein Schlüssel hat keinen Nutzer und damit keinen Posteingang)
Nur-Lesen-Option	Grant read-only access auf dem Zustimmungsbildschirm ankreuzen	Beim Erstellen Nur Lesen wählen
Ideal für	Benutzerdefinierte Connectors in Claude und andere OAuth-fähige Clients	Skripte und Clients ohne OAuth-Unterstützung

Option A: Verbindung per OAuth (empfohlen)

Unterstützt dein Client OAuth für Remote-MCP-Server — wie die benutzerdefinierten Connectors in Claude —, musst du dich um keine Schlüssel kümmern.

Öffne in Claude Einstellungen → Connectors und wähle Benutzerdefinierten Connector hinzufügen
Nenne ihn TskVlo und gib die URL https://dash.tskvlo.app/api/mcp ein
Klicke auf Verbinden — im Browser öffnet sich eine TskVlo-Seite. Melde dich an, falls du es noch nicht bist (Zwei-Faktor-Authentifizierung funktioniert wie gewohnt)
Wähle auf dem Bildschirm Authorize MCP access unter Workspace den Workspace, den die Verbindung nutzen soll. Angezeigt werden nur Workspaces, in denen du Eigentümer oder Admin bist
Prüfe die angeforderten Berechtigungen. Soll die KI nur lesen und nie etwas ändern dürfen, setze den Haken bei Grant read-only access
Klicke auf Authorize — du landest wieder in Claude, und die TskVlo-Tools stehen bereit

Hinweis: Der Zustimmungsbildschirm ist derzeit nur auf Englisch verfügbar.

Im Hintergrund registriert sich der Client automatisch bei TskVlo und meldet sich mit PKCE an. Access-Tokens sind kurzlebig und werden im Hintergrund erneuert — solange du die Verbindung nutzt, musst du dich nicht erneut anmelden.

Andere OAuth-fähige Clients funktionieren genauso: Füge https://dash.tskvlo.app/api/mcp als Remote-MCP-Server (HTTP) hinzu, und der Client startet die Anmeldung beim ersten Zugriff. In Claude Code zum Beispiel:

claude mcp add --transport http tskvlo https://dash.tskvlo.app/api/mcp

Anschließend authentifizierst du dich in Claude Code mit /mcp.

Eine OAuth-Verbindung beenden

Entferne oder trenne den Connector in deinem KI-Client, damit er TskVlo nicht mehr verwendet.
Eine Verbindung funktioniert nicht mehr, sobald du die Eigentümer- oder Admin-Rolle in diesem Workspace verlierst oder aus ihm entfernt wirst.
Verbindungen, die 30 Tage nicht genutzt werden, laufen von selbst ab — du wirst dann einfach erneut um Autorisierung gebeten.

Option B: Verbindung mit einem Workspace-API-Schlüssel

Für Clients ohne OAuth-Unterstützung oder für eigene Skripte:

Schritt 1: API-Schlüssel erstellen

Öffne Workspace-Einstellungen → API-Schlüssel (nur Eigentümer und Admins)
Klicke auf Schlüssel erstellen und gib einen Namen ein, z. B. „Cursor”
Wähle den Zugriff:
- Lesen & Schreiben — kann Boards, Einträge und Wiki-Seiten lesen und ändern
- Nur Lesen — kann nur lesen; Schreibanfragen werden abgelehnt und MCP-Schreib-Tools ausgeblendet
Klicke auf Schlüssel erstellen und kopiere den Schlüssel sofort — er wird nicht erneut angezeigt

API-Schlüssel gelten nur für den Workspace, in dem sie erstellt wurden. Auf derselben Seite siehst du, wann jeder Schlüssel zuletzt verwendet wurde, und kannst ihn jederzeit widerrufen.

Schritt 2: Server im Client eintragen

Clients mit einer JSON-Konfiguration aus URL und Headern — zum Beispiel Cursors mcp.json — sehen so aus:

{
  "mcpServers": {
    "tskvlo": {
      "url": "https://dash.tskvlo.app/api/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_API_SCHLUESSEL"
      }
    }
  }
}

Ersetze DEIN_API_SCHLUESSEL durch den kopierten Schlüssel. Statt des Authorization-Headers kannst du den Schlüssel auch als x-api-key: DEIN_API_SCHLUESSEL senden.

In Claude Code:

claude mcp add --transport http tskvlo https://dash.tskvlo.app/api/mcp \
  --header "Authorization: Bearer DEIN_API_SCHLUESSEL"

Starte deinen Client nach einer Konfigurationsänderung neu oder lade sie neu.

Verbindung überprüfen

Starte ein neues Gespräch und tippe:

Liste die Boards in meinem TskVlo-Workspace auf.

Funktioniert die Verbindung, ruft die KI das list_boards-Tool auf und gibt deine Boards zurück. Bei einem Fehler hilft der Abschnitt zur Fehlerbehebung unten.

Verfügbare Tools

Nach der Verbindung stehen der KI rund 40 TskVlo-Tools zur Verfügung:

Kategorie	Tools
Mitglieder	auflisten
Boards	auflisten, erstellen, aktualisieren, löschen
Gruppen	auflisten, erstellen, aktualisieren, löschen
Einträge	auflisten, abrufen, erstellen, aktualisieren (auch auf ein anderes Board verschieben), löschen, archivieren, wiederherstellen
Felder	auflisten, erstellen, aktualisieren, löschen
Feldwerte	setzen, mehrere setzen, leeren
Dateianhänge	auflisten, hochladen, löschen
Kommentare	auflisten, erstellen
Benachrichtigungen	auflisten, als gelesen markieren — nur mit OAuth
Automatisierungsregeln	auflisten, abrufen, erstellen, aktualisieren, löschen, ausführen
Wiki-Seiten	auflisten, abrufen, erstellen, aktualisieren, verschieben, löschen

Nur-Lesen-Verbindungen sehen ausschließlich die lesenden Tools. Änderungen über MCP — neue Einträge, geänderte Automatisierungsregeln, gelesene Benachrichtigungen — erscheinen in der geöffneten TskVlo-App ohne Neuladen.

Beispiel-Prompts

Diese Prompts funktionieren gut, sobald die Verbindung steht:

Daten abfragen:

„Welche Boards gibt es in diesem Workspace?”
„Zeige mir alle mir zugewiesenen Einträge, die diese Woche fällig sind.”
„Was steht auf der Wiki-Seite ‚Onboarding’?”

Erstellen und Aktualisieren:

„Erstelle ein neues Board namens ‚Q3-Roadmap’.”
„Füge einen Bug-Report hinzu: Titel ‚Login-Button reagiert nicht in Safari’, weise ihn Emma zu, setze die Priorität auf Hoch.”
„Verschiebe die Aufgabe ‚Rechnungsexport’ vom Support-Board in die Gruppe ‚Backlog’ des Entwicklungs-Boards.”

Benachrichtigungen (OAuth):

„Welche ungelesenen Benachrichtigungen habe ich? Gruppiere sie nach Board.”
„Markiere alle Benachrichtigungen zum Marketing-Board als gelesen.”

Automatisierungen:

„Liste die Automatisierungsregeln auf dem Support-Board auf und erkläre, was jede macht.”
„Lege auf dem Vertriebs-Board eine Regel an: Wenn ein Eintrag in ‚Neue Leads’ erstellt wird, weise ihn der Person zu, die ihn erstellt hat.”

Weitere Ideen findest du in der Anleitung zu KI-Prompts.

Tipps für beste Ergebnisse

Sei spezifisch bei Board- und Gruppennamen. „Die Gruppe Backlog auf dem Marketing-Board” ist eindeutig.

Nutze es für Stapelarbeit. Wo Durchklicken mühsam ist — zehn ähnliche Einträge anlegen, Status massenhaft ändern, denselben Feldwert für eine Gruppe von Aufgaben setzen —, erledigt die KI es mit einer einzigen Anweisung.

Lass dir destruktive Aktionen vorher bestätigen. Bevor du massenhaft löschst oder verschiebst, lass die KI zuerst auflisten, was sie ändern wird.

Starte mit Nur Lesen. Wenn du nur Antworten und Berichte brauchst, verbinde dich schreibgeschützt. Eine zweite Verbindung mit Schreibrechten kannst du jederzeit später autorisieren.

Nutze den Kontext. Die KI erinnert sich an das Gespräch. Nach dem Auflisten von Einträgen kannst du sagen „Erstelle jetzt drei Unteraufgaben unter dem ersten Eintrag”, und sie weiß, welcher gemeint ist.

Fehlerbehebung

Der Zustimmungsbildschirm zeigt keinen Workspace: Du brauchst in mindestens einem Workspace die Rolle Eigentümer oder Admin, um einen MCP-Client zu autorisieren. Bitte einen Workspace-Eigentümer, deine Rolle zu ändern oder die Verbindung für dich einzurichten.

Fehler „Unauthorized”: Der API-Schlüssel wurde möglicherweise widerrufen, oder die OAuth-Verbindung ist abgelaufen bzw. hat ihre Berechtigung verloren. Erstelle einen neuen Schlüssel oder verbinde den Connector neu.

Die KI kann nichts erstellen oder ändern: Die Verbindung ist schreibgeschützt. Erstelle einen Schlüssel mit Lesen & Schreiben oder verbinde dich per OAuth neu, ohne Grant read-only access anzukreuzen.

Benachrichtigungs-Tools fehlen oder schlagen fehl: Sie brauchen eine OAuth-Verbindung. API-Schlüssel gehören keinem Nutzer und haben keinen Posteingang.

Die KI scheint die TskVlo-Tools nicht zu nutzen: Starte deinen Client vollständig neu. Prüfe bei einer JSON-Konfiguration, ob sie gültig ist (keine überzähligen Kommas, korrekte Klammern).

Änderungen werden nicht angezeigt: TskVlo-Daten sind live — fragt die KI direkt nach einer Änderung ab, sollte sie den neuen Stand sehen. Siehst du veraltete Daten, bitte sie, die Daten erneut abzurufen.