TrackWork MCP- und REST-API-Integration

Verbinden Sie Ihr TrackWork-Konto per persönlichem API-Token mit kompatiblen MCP-Clients oder greifen Sie über REST auf Projektdaten zu.

Zuletzt aktualisiert:

1. Persönlichen API-Token erstellen

Erstellen Sie in den Dashboard-Einstellungen einen API-Token. Der Klartextwert wird nur einmal angezeigt. Der Token gewährt Zugriff auf Ihre Kontodaten; veröffentlichen Sie ihn nicht in Repositories, Chats oder Kundenlinks. Widerrufen Sie ungenutzte oder offengelegte Tokens in den Einstellungen.

2. MCP-Client verbinden

Tragen Sie Serveradresse und Authorization-Header in einem MCP-Client mit Streamable-HTTP-Unterstützung ein. Ersetzen Sie YOUR_TOKEN nur in Ihrer lokalen Clientkonfiguration durch Ihren Token. Authentifizierungs- und Transportunterstützung unterscheiden sich je nach Client.

{
  "mcpServers": {
    "trackwork": {
      "url": "https://trackwork.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

3. Eine lesende REST-Anfrage testen

Derselbe Bearer-Token funktioniert mit den /api/v1-Endpunkten. Die folgenden Beispiele lesen nur Konto und Projektliste. Setzen Sie TRACKWORK_API_TOKEN in Ihrer sicheren lokalen Umgebung.

curl https://trackwork.app/api/v1/me \
  -H "Authorization: Bearer $TRACKWORK_API_TOKEN"

curl https://trackwork.app/api/v1/projects \
  -H "Authorization: Bearer $TRACKWORK_API_TOKEN"

Unterstützte Vorgänge

REST v1 umfasst das Auflisten von Konto und Kunden; Auflisten, Erstellen und Aktualisieren von Projekten; Hinzufügen und Aktualisieren von Schritten und Unteraufgaben sowie das Erfassen von Zahlungen und Tagesstatus. Schreibvorgänge ändern echte Kontodaten. Prüfen Sie in Automatisierungen das Zielprojekt.

  • GET /api/v1/me
  • GET /api/v1/clients
  • GET veya POST /api/v1/projects
  • GET veya PATCH /api/v1/projects/:id
  • POST /api/v1/projects/:id/steps
  • PATCH /api/v1/steps/:id
  • POST /api/v1/steps/:id/sub-steps
  • PATCH /api/v1/sub-steps/:id
  • POST /api/v1/projects/:id/payments
  • POST /api/v1/today-status