Dokumentation
So arbeitest du mit Projektraum
Von der ersten Einladung bis zum geprüften Ergebnis. Konkrete Anleitungen für Kunden, Projektteams und verbundene KI-Agenten.
Erste Schritte
Ein Projektraum bündelt die Zusammenarbeit mit einem Kunden. Boards ordnen die Arbeit innerhalb dieses Projektraums.
Projektraum anlegen
Erstelle im Dashboard einen Projektraum für deinen Kunden oder dein Projekt. Gib ihm einen klaren Namen, zum Beispiel „Website-Relaunch“.
Board auswählen
Lege ein Board an: Kanban für Statusspalten, Projekt-Board für Tabellen und Bereiche, Kalender für Termine oder Timeline für Zeiträume. Mehrere Boards können zum selben Projektraum gehören.
Kunden einladen
Lade die zuständigen Personen ein. Kunden öffnen ihren persönlichen Einladungslink und benötigen kein eigenes Konto. Ihre Rechte werden in den Projekteinstellungen festgelegt. Teile einen Einladungslink nur mit der vorgesehenen Person.
Erste Aufgabe abstimmen
Lege ein Ticket mit Ziel, Verantwortlichem und Termin an. Der Kunde kann im freigegebenen Projektraum Rückfragen beantworten und Ergebnisse ansehen.
Tickets und Zusammenarbeit
Ein Ticket beschreibt ein konkretes Ergebnis. Kommentare erklären den Verlauf; der Status zeigt, wo die Arbeit steht.
Aufgabe beschreiben
Schreibe, was erreicht werden soll und woran es als fertig erkannt wird. Ergänze Zuständigkeit, Priorität und Termine. Eine Checkliste hilft bei mehreren kleinen Schritten.
Rückfragen am Ticket halten
Nutze Kommentare für Fragen und Ergebnisse. Wähle beim Schreiben mit @ die richtige Person aus. Eine Erwähnung erscheint in deren Benachrichtigungen; E-Mails hängen von ihren Einstellungen ab.
Fortschritt sichtbar machen
Verschiebe das Ticket in die passende Spalte. Spalten sind je Board anpassbar. Erst nach Prüfung oder ausdrücklicher Abschlussmeldung als fertig markieren.
Dateien und Projektwissen
Allgemeine Unterlagen gehören zum Projektraum; Material für eine konkrete Aufgabe gehört zum Ticket.
Passend ablegen
Nutze den Dateienbereich für Briefings oder gemeinsame Unterlagen. Lade aufgabenbezogene Dateien direkt am Ticket oder als Kommentar-Anhang hoch, damit der Zusammenhang erhalten bleibt.
Fassung benennen
Benenne Dateien eindeutig, zum Beispiel „Startseite-v2.pdf“, und kommentiere, was sich geändert hat. Eine Kundenfreigabe gilt für den Inhalt zum Zeitpunkt der Anfrage.
Mit einer KI lesen
Ein verbundener Client kann erlaubte Dateien über MCP auflisten und herunterladen. Ob PDF oder Office-Dateien gelesen werden können, hängt von seinen Fähigkeiten ab. Projektraum extrahiert den Inhalt nicht automatisch.
Wann hilft welcher Workflow?
Die Bereiche lösen unterschiedliche Aufgaben im Projekt. Du musst nicht alle für jedes Ticket benutzen.
Anfrage → Ticket
Übernimm Text oder lies eine TXT-/Markdown-Datei lokal ins Anfragefeld ein. Ergänze Ziel, Checkliste und Termin. Die Vorbereitung setzt die erste Zeile als Titel und ergänzt Rückfragen. Prüfe den Entwurf vor der Übernahme ins Board; es ist keine automatische Dokumentanalyse.
KI-Auftrag → geprüftes Ergebnis
Gib eine klar beschriebene Aufgabe ausdrücklich für eine bestimmte MCP-Verbindung frei. Dein laufender Agent holt den Auftrag ab und meldet Fortschritt, Blockaden oder ein Ergebnis. Du prüfst das Ergebnis, bevor du den Auftrag abschließt.
Kundenfreigabe → Entscheidung
Bitte den Kunden, eine konkrete Fassung zu prüfen. Zustimmung und Änderungswunsch bleiben am Ticket sichtbar. Die Freigabe setzt den Ticketstatus nicht automatisch auf fertig.
Regeln und Berichte
Board-Regeln übernehmen unterstützte Handgriffe wie Priorität oder Zuweisung. Berichte zeigen den Projektstand und wartende Entscheidungen. Kunden sehen einen Bericht erst, wenn er für sie freigegeben ist.
Zwei konkrete Kundenprojekte
Verfolge, wer den nächsten Schritt übernimmt und welche Information dabei mitgeht.
Website: ein zusätzliches Telefonfeld
Marc möchte ein optionales Telefonfeld. Lara klärt die mobile Darstellung und hält Abnahmekriterien fest. Sie erstellt ein Ticket, beauftragt bei Bedarf ihren laufenden Agenten, prüft dessen Ergebnis und bittet Marc um Freigabe. Erst danach entscheidet sie über den Abschluss.
Design: Produktbilder aufhellen
Sina benennt die beiden Bilder und die gewünschte Änderung. Lara klärt die genaue Fassung, überarbeitet die Dateien selbst und legt sie erneut zur Freigabe vor. Der Änderungswunsch und die Entscheidung bleiben beim Ticket. Dafür ist kein KI-Agent nötig.
Was die Demo zeigt
Die geführten Beispiele erklären die Übergaben. Beispieldaten und Aktionen bleiben lokal in der Demo; sie starten keine echte Bearbeitung und verschicken keine Nachrichten.
MCP einrichten
MCP verbindet deinen KI-Client mit einem bestimmten Projektraum. Der Client kann nur die Werkzeuge und Daten innerhalb der vergebenen Rechte nutzen.
Verbindungsschlüssel erstellen
Projektinhaber öffnen die KI-/MCP-Einstellungen und wählen den Projektraum. Eingeladene Kunden finden die Verbindung in den Einstellungen ihres Projektraums. Erstelle einen eigenen Schlüssel pro Client und benenne ihn eindeutig.
Rechte passend wählen
Wähle Lesen oder Lesen und Schreiben. Schreibzugriff erlaubt unter anderem Kommentare und Ticketänderungen, soweit dein Konto dazu berechtigt ist. Der volle Schlüssel wird nur einmal angezeigt; verwahre ihn sicher.
Verbindung testen
Richte den passenden Client unten ein. Frage anschließend: „Zeige mir die offenen Tickets und meine ungelesenen Erwähnungen in Projektraum.“ Prüfe zuerst, ob das richtige Projekt erscheint.
Zugriff verwalten
Widerrufe nicht mehr benötigte Schlüssel in den Einstellungen. Abgelaufene Schlüssel müssen ersetzt werden. Der Kommentarstil lässt sich pro Verbindung kurz oder ausführlich einstellen.
MCP-Serveradresse
https://projektraum.io/api/mcpNur ein Authentifizierungsverfahren verwenden. Der Schlüssel gehört weder in einen Chat noch in eine URL oder ein Git-Repository. prk_… ist nur ein Platzhalter: Ersetze ihn durch den vollständigen, einmal angezeigten Schlüssel, nicht nur durch das Präfix oder die Auslassungspunkte.
Claude
Wähle im benutzerdefinierten Konnektor die Serveradresse und „Keine Anmeldung“. Unter Request-Header den eingebauten Header x-api-key wählen und nur den vollständigen prk_-Schlüssel eintragen. Keine OAuth-Client-ID anlegen.
URL: https://projektraum.io/api/mcp
x-api-key: prk_…Falls dein Konto keine passenden Request-Header anbietet, nutze Claude Code. Sind gespeicherte Header nicht bearbeitbar, lege den Konnektor mit der richtigen Konfiguration neu an.
Offizielle AnleitungCodex
Trage die Konfiguration in ~/.codex/config.toml ein. PROJEKTRAUM_API_KEY enthält nur den Schlüssel und muss dem laufenden Codex-Prozess zur Verfügung stehen.
[mcp_servers.projektraum]
url = "https://projektraum.io/api/mcp"
bearer_token_env_var = "PROJEKTRAUM_API_KEY"Codex ergänzt Bearer selbst. Eine Variable in einem Terminal ist nicht automatisch in einer separat gestarteten Desktop-App vorhanden. Prüfe die Verbindung mit /mcp bzw. der MCP-Verbindungsanzeige.
Offizielle AnleitungClaude Code
Ergänze die Konfiguration in .mcp.json deines Arbeitsprojekts. Setze PROJEKTRAUM_API_KEY im Startumfeld von Claude Code.
{
"mcpServers": {
"projektraum": {
"type": "http",
"url": "https://projektraum.io/api/mcp",
"headers": {
"Authorization": "Bearer ${PROJEKTRAUM_API_KEY}"
}
}
}
}Vorhandene mcpServers-Einträge erhalten. Claude Code ersetzt den Variablenplatzhalter beim Start. Projektkonfiguration bestätigen und über /mcp prüfen oder neu verbinden.
Offizielle AnleitungChatGPT
Die aktuelle Projektraum-Anbindung unterstützt keine direkte geschützte Verbindung in ChatGPT Web. ChatGPT benötigt dafür OAuth; Projektraum verwendet hier einen API-Schlüssel.
Ein prk_-Schlüssel ist weder OAuth-Client-ID noch Client-Secret. „Keine Authentifizierung“ umgeht den Schutz nicht. Für die bestehende Anbindung kannst du Codex verwenden.
Offizielle AnleitungGeprüft am 31. Oktober 2026
MCP für Entwickler und Agenten
Der Endpunkt verwendet Streamable HTTP. Rufe zuerst tools/list auf, um die für deinen Schlüssel verfügbaren Werkzeuge und aktuellen Schemas zu erhalten.
Lesen vor dem Ändern
get_project liefert Boards, Spalten und Mitglieder. get_task und list_comments liefern Ticketkontext. Übernimm IDs und Statusschlüssel aus den Antworten, statt sie zu erraten. Listen unterstützen limit und offset.
Sichere Wiederholungen
Schreibaufrufe benötigen request_id als neue UUID. Bei einem Retry dieselbe ID und unveränderte Argumente wiederverwenden. Für Ticketänderungen den Wert task.updated_at aus get_task als expected_updated_at übergeben. Bei einem Konflikt neu lesen und Änderungen abgleichen.
Beschreibungen und Erwähnungen
append_task_description ergänzt bestehende Inhalte. update_task mit description ersetzt die gesamte Beschreibung. Kommentare sind Klartext; @ plus exakter Mitgliedername erzeugt eine Erwähnung. list_notifications liest sie, mark_notification_read bestätigt sie getrennt.
Dateien und Agentenaufträge
list_files liefert Datei-IDs und source. get_file gibt eine private Download-URL für 60 Sekunden zurück; bei Ablauf erneut abrufen. list_agent_jobs, claim_agent_job und update_agent_job bilden den Auftragsablauf. Claim-Token und Lease beachten; für review ist ein Ergebnisnachweis nötig.
Probleme lösen
Gehe vom konkreten Fehler aus. Ein gespeicherter Konnektor allein startet keinen Agenten auf deinem Computer.
Verbindung oder Anmeldung schlägt fehl
Prüfe die HTTPS-Adresse, den vollständigen Schlüssel, Ablauf und Widerruf. Für x-api-key nur den Schlüssel eintragen; für Authorization genau Bearer, ein Leerzeichen und den Schlüssel. Keine Anführungszeichen und nicht beide Header senden.
Lesen geht, Schreiben nicht
Prüfe Schreibrecht der Verbindung und aktuelle Projektrechte. Ein archiviertes oder gesperrtes Projekt kann Änderungen verhindern. Lege keinen größeren Zugriff an, nur um einen Fehler zu umgehen.
Nach Update fehlen Werkzeuge
Aktualisiere die Werkzeugliste im Client oder verbinde ihn neu. Starte gegebenenfalls einen neuen Chat. In Claude steht dies je nach Oberfläche im Konnektor-Menü; direkte CLI-Verbindungen können über /mcp neu verbunden oder neu gestartet werden.
Agent reagiert nicht von selbst
Der Agent muss laufen und Benachrichtigungen bzw. seine Aufträge abfragen. MCP ist der Zugang zum Projekt, kein automatischer Startdienst. Eine Erwähnung ist keine Erlaubnis, beliebige Aktionen auf dem Rechner auszuführen.