Was ist ein MCP-Server für awork?
Ein MCP-Server für awork verbindet KI-Agenten über das offene Model Context Protocol mit Ihrem awork-Workspace. Das KI-Modell kann dann standardisiert auf die awork Public API zugreifen, Projekte abfragen, Aufgaben anlegen oder verschieben, Zeiteinträge auswerten und Auslastung pro Team prüfen — alles im Rahmen klar definierter Tools und Berechtigungen.
awork ist ein Hamburger Projektmanagement-Tool — passend zur Workflow-Agentur (Sitz: Hamburg) und besonders beliebt bei Agenturen, Beratungen und projektgetriebenen Mittelständlern, die ein modernes, deutsches Tool als Alternative zu Asana, ClickUp oder Monday einsetzen wollen. Laut AVV läuft awork in Azure-Rechenzentren in Frankfurt am Main und Berlin, der AVV ist Standard — eine gute Grundlage für ein datenschutzgerechtes Setup.
awork bietet einen eigenen MCP-Server an: Endpunkt https://api.awork.com/api/v1/mcp, Anmeldung per OAuth 2.1 (auch mit Dynamic Client Registration) oder per API-Key als Bearer-Token. Laut awork-Doku arbeitet der Server mit denselben Ressourcen, Rechten und Rate-Limits wie die Public API. Für den schnellen Einstieg mit Claude oder ChatGPT ist das der direkte Weg.
Einen eigenen MCP-Server setzen wir ein, wenn Sie mehr Kontrolle brauchen: fest definierte Werkzeuge statt freiem API-Zugriff, Freigabeschritte vor dem Schreiben, ein eigenes Protokoll jedes Zugriffs oder ein Modell auf eigener Infrastruktur. Beide Wege nutzen die awork Public API v1 (REST/JSON).
Kurz: awork + MCP heißt: „Wie steht es um Projekt Mustermann?" — Agent zieht Status, offene Tasks, gebuchte vs. budgetierte Stunden und letzte Aktivität direkt aus awork und gibt eine kompakte Antwort.
Use Cases: Was kann ein awork-MCP-Server konkret?
- Projekt-Status-Reports per Sprache „Gib mir den Stand aller aktiven Kundenprojekte" — der Agent zieht aus awork pro Projekt: Fortschritt, offene Aufgaben, verbrauchte vs. geplante Stunden, nächste Deadlines. Output als sauberer Text-Block oder als Wochen-Report für die Geschäftsführung.
- Automatisches Task-Routing Neue Anfrage trifft per Mail oder Formular ein. Der Agent klassifiziert, ordnet sie dem passenden Projekt zu, legt eine Aufgabe in awork an, verteilt sie an die zuständige Person und setzt eine realistische Deadline auf Basis der aktuellen Auslastung.
- Zeiterfassungs-Auswertung „Wer hat diese Woche schon was gebucht — und wo fehlen Stunden?" Der Agent gleicht die Zeiteinträge gegen Kapazität und Soll-Stunden ab, zeigt Lücken, schlägt sinnvolle Nachbuchungen vor. Mitarbeitende bestätigen den Vorschlag mit einem Klick.
- Onboarding neuer Projekte Neukunde unterschreibt das Angebot? Der Agent legt das Projekt in awork an, klont die passende Projekt-Vorlage, weist Team-Mitglieder zu, legt Milestones an und richtet die ersten Zeitbuchungs-Kategorien ein — in Sekunden statt in langer Klick-Arbeit.
- Auslastung & Kapazitätsplanung Vor der Annahme eines neuen Projekts fragt der Vertrieb den Agenten: „Haben wir im Juni noch 60 Stunden Frontend frei?" — der Agent zieht Soll-Auslastung aus awork und antwortet konkret.
- Eskalation überfälliger Aufgaben Der Agent läuft täglich über alle awork-Aufgaben, identifiziert überfällige Tasks, schreibt einen freundlichen Nudge an die zuständige Person und eskaliert nach definierten Regeln an den Projektleiter — nichts geht mehr unter.
So funktioniert die Integration
Architektur:
KI-Agent ↔ MCP-Server (offiziell von awork oder eigener EU-Host) ↔ awork Public API v1 (REST/JSON, OAuth oder API-Key)
Konkrete Schritte:
- API-Zugang & Token: Laut awork ist ein API-Key nicht nutzerbezogen und hat Admin-Zugriff auf den Workspace. Minimale Rechte gibt es nur über OAuth: Das Token gilt dann pro Person und respektiert deren Rollen. Nutzen wir einen API-Key, begrenzen wir die Rechte im eigenen MCP-Server über fest definierte Werkzeuge.
- Tool-Definitionen: Typische Tools:
list_projects,get_project_status,create_task,update_task,list_time_entries,get_team_capacity. Jede mit JSON-Schema. - Datenminimierung: Der Agent erhält nur die Projekte und Felder, die der Use Case wirklich braucht — vertrauliche Kundenprojekte können ausgeschlossen werden.
- Write-Operations & Freigabe: Task-Anlage und Statuswechsel sind in den meisten Setups direkt OK. Zeitbuchungen erfolgen typischerweise als Vorschlag mit Bestätigung durch die Mitarbeitenden.
- Webhooks-Anbindung: Optional — bei neuen Tasks, Statuswechseln oder fertigen Projekten kann der Agent reaktiv aktiv werden, etwa um den nächsten Workflow-Schritt auszulösen.
DSGVO, Hosting & Sicherheit
awork läuft laut AVV in deutschen Azure-Rechenzentren. Das gilt für die awork-Daten selbst; wo das KI-Modell läuft, entscheidet der gewählte KI-Anbieter. Unser Standard für awork-MCP:
- EU-Hosting für den MCP-Server, kein US-Edge.
- OAuth pro Person, wo möglich; ein API-Key mit Admin-Zugriff liegt nur verschlüsselt auf dem MCP-Server und wird regelmäßig rotiert.
- Datenminimierung: Auch innerhalb erlaubter Scopes filtern wir Felder weg, die der konkrete Use Case nicht braucht — Stundensätze und interne Kommentare standardmäßig ausgenommen.
- AVV mit KI-Anbieter, EU-Datenresidenz (Claude über AWS Bedrock EU, Azure OpenAI in einer EU-Region etc.).
- Logging: Jeder Tool-Call ist mit Zeitstempel, betroffenem Projekt und auslösender Person dokumentiert — Audit-Trail jederzeit nachvollziehbar.
- Betriebsrat-Einbindung: Bei mitarbeiterbezogenen Auswertungen (Auslastung pro Person) liefern wir eine Vorlage zur Information.
Typische Setups
- Agentur: Projekt-Status-Reports + automatisches Task-Routing aus dem Posteingang. Realistisch als klar abgegrenztes Paket umsetzbar.
- Beratung: Auslastung + Kapazitätsplanung + Zeiterfassungs-Assistent. Realistisch als eigene Stufe.
- Engineering-Team: awork als Project-Layer, MCP-Server als Brücke zu Slack und Outlook — Tickets aus dem Chat werden direkt zu awork-Tasks.
Was kostet das?
- Use-Case-orientiertes Vorgehen: Erst ein konkreter Workflow produktiv — dann Erweiterung.
- Erste Ergebnisse mit einem klar abgegrenzten Use Case realistisch.
Verwandte Ratgeber
Häufige Fragen
Welche awork-API nutzt der MCP-Server?
Die offizielle awork Public API v1 (REST/JSON). Zugang per OAuth mit den Rechten der jeweiligen Person oder per API-Key mit Admin-Zugriff auf den Workspace. Sie deckt Projekte, Aufgaben, Zeiteinträge, Teams, Tags und Vorlagen ab.
Gibt es einen offiziellen awork-MCP-Server?
Ja. awork betreibt einen eigenen MCP-Server unter https://api.awork.com/api/v1/mcp. Die Anmeldung läuft über OAuth 2.1 (auch mit Dynamic Client Registration) oder über einen API-Key als Bearer-Token. Mit OAuth handelt der Agent mit den Rechten der angemeldeten Person; ein API-Key ist laut awork nicht nutzerbezogen und hat Admin-Zugriff. Einen eigenen MCP-Server bauen wir, wenn Sie feste Werkzeuge statt freiem API-Zugriff, ein eigenes Protokoll oder ein Modell auf eigener Infrastruktur brauchen.
Ist awork DSGVO-konform hostbar?
Ja, wenn die Kette stimmt: awork verarbeitet die Daten laut AVV in Azure-Rechenzentren in Frankfurt am Main und Berlin, ein AVV ist Standard. Für die KI-Anbindung kommen ein EU-gehosteter MCP-Server und ein KI-Anbieter mit AVV und EU-Datenresidenz dazu. Beim offiziellen awork-MCP-Server gelten zusätzlich die Bedingungen Ihres KI-Clients.
Kann der KI-Agent Zeiteinträge anlegen?
Ja. In der Praxis arbeiten wir mit einem Vorschlags-Modell: Der Agent erstellt Zeitbuchungs-Vorschläge auf Basis von Kalenderdaten, Slack-Aktivität oder Mitschriften, die Mitarbeitenden bestätigen mit einem Klick.
Funktioniert das mit awork-Webhooks?
Ja. Der MCP-Server kann auf Events wie „neue Aufgabe", „Statuswechsel" oder „Projekt abgeschlossen" reaktiv reagieren — etwa um Folge-Workflows auszulösen.
Sehen Agenten alle Projekte des Workspaces?
Nein. Mit OAuth sieht der Agent nur, was die angemeldete Person sehen darf. Ein API-Key dagegen hat laut awork Admin-Zugriff auf den Workspace; in dem Fall begrenzen wir Projekte und Felder im eigenen MCP-Server pro Use Case. Vertrauliche Projekte oder interne Pakete lassen sich so ausschließen.
Sie wollen einen MCP-Server für Ihr System?
30 Minuten Erstberatung — wir prüfen, ob Ihre Systeme MCP-tauglich sind, und schätzen den Projektaufwand ab.
KI-Check buchen arrow_forward