marble work stellt einen eigenen MCP-Server bereit. MCP (Model Context Protocol) ist der offene Standard, über den KI-Assistenten wie Claude, Claude Code oder Cursor externe Werkzeuge nutzen. Einmal verbunden, kann dein KI-Assistent direkt in marble work arbeiten: Kunden, Projekte und Aufgaben anlegen, Aufgabenketten aufbauen, Agenten und Wissen pflegen und Ergebnisse auslesen.
<aside> 🚀 REST-API und MCP-Server setzen den Plan „Rocket“ voraus.
</aside>
Ein Beispiel: Du sagst in Claude Code „Leg in marble work eine Aufgabe an: Blogartikel zum Thema X, Recherche durch Wilma, danach Freigabe durch mich", und der Assistent erledigt das über die Tools dieses Servers.
<aside> 🔀
Der MCP-Server und die REST-API bieten dieselben Operationen mit denselben Rechten und Limits. MCP ist der richtige Weg für KI-Assistenten, die REST-API der richtige für eigene Skripte und Integrationen. Siehe die Seite marble work » REST-API 🇩🇪
</aside>
<https://mcp.marblework.app>
| Eigenschaft | Wert |
|---|---|
| Transport | Streamable HTTP, zustandslos (kein SSE-Stream, kein Session-Header) |
| HTTP-Methode | Nur POST mit JSON-RPC 2.0 im Body |
| Protokollversion | 2025-03-26 |
| Capabilities | tools und resources |
| Unterstützte Methoden | initialize, ping, tools/list, tools/call, resources/list, resources/templates/list, resources/read |
| Batch-Requests | Nicht unterstützt (ein Request pro Aufruf) |
Der Server nutzt die API-Keys von marble work. Einen Key erstellt ein Organisations-Admin in der App unter Einstellungen → Organisation → API-Zugriff; dort wählst du auch die Scopes (welche Tool-Gruppen der Key nutzen darf). Der Key wird nur einmal angezeigt.
Schicke den Key als Header, in einer der beiden Formen:
Authorization: Bearer mw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
x-api-key: mw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Die Metadaten-Methoden (initialize, ping, tools/list, resources/list, resources/templates/list) funktionieren ohne Key, damit Clients die Verbindung aufbauen können. Erst tools/call und resources/read verlangen ihn; ohne gültigen Key antwortet der Server mit HTTP 401 und dem JSON-RPC-Fehlercode -32001.
Wichtig: Die Tool-Liste zeigt immer alle Tools, unabhängig von den Scopes deines Keys. Ob ein Aufruf erlaubt ist, entscheidet sich erst beim tools/call (Fehlercode missing_scope).
Ersetze in allen Beispielen den Platzhalter durch deinen echten Key.