Dein Agent, triff dein Command Center
Der MCP-Server ist die Brücke zwischen deinem KI-Client — Claude Code oder jedem anderen MCP-fähigen Client — und dem Dashboard. Einmal anmelden, Verbindung freigeben, und der Agent arbeitet an den Projekten, die du siehst, mit dem Zugriff, den du gegeben hast, und einer Quittung für jeden Schreibzugriff.
Kein API-Schlüssel zum Einfügen — und damit auch keiner, der in der Shell-Historie landet.
Server-Endpunkt
https://mcp.grafizum.com/mcpEinrichtung
Server hinzufügen
In Claude Code den Befehl unten ausführen. Jeder MCP-Client: den Endpunkt oben als Server-URL verwenden (Streamable HTTP, OAuth 2.1). Wer MCP spricht, findet den Weg hierher.
claude mcp add --transport http grafizum https://mcp.grafizum.com/mcphttps://mcp.grafizum.com/mcp
Verbindung freigeben
Dein Client öffnet eine Freigabeseite mit einer Karte im Dashboard. Anmelden, den Agenten wählen, als der gehandelt wird, und autorisieren. Projekte und Zugriff gelten standardmäßig für den ganzen Agenten und bleiben danach änderbar.
Arbeiten
Der Agent kann nun Projekte, Aufgaben, Kalender und Wissen lesen — und im Rahmen seiner Scopes schreiben. Jeder Schreibzugriff landet im Aktivitätsprotokoll.
Sync-Modus umschalten
Eine Einstellung an der Verbindung entscheidet, ob der Agent das Board bei der Arbeit aktuell hält oder auf deine Aufforderung wartet. Sie liegt an der Verbindung, nicht im Client — der Agent, in dem du sie umschaltest, ist also nicht der einzige, für den sie gilt.
Auto
StandardHält das Dashboard aktuell, sobald verifizierte Arbeit fertig ist: die passende Aufgabe wird einmal mit dem echten Ergebnis aktualisiert. Keine doppelten Aufgaben, kein erfundener Fortschritt.
/gz-autoManuell
Auf AnfrageLiest weiter frei — Lesen ist, wie es dir antwortet — schreibt aber nur, wenn du es in diesem Turn verlangst. Sonst sagt es, was es synchronisieren würde, und wartet.
/gz-manual/gz-autoClaude Code CLI: der Skill, den der Grafizum-Installer hinzufügt. /gz-manual ist die andere Richtung./grafizum:autoJeder Client, der die Prompts des Servers auflistet. /grafizum:manual gibt es auch.switch Grafizum to manualJeder Agent — Codex CLI, Gemini CLI, Aider, ein reines Terminal —, weil die Verbindung ein set_sync_mode-Tool hat. „Zurück auf auto“ führt zurück.Der Modus ist eine Anweisung, die der Server dem Modell mitgibt, kein Verhalten, das er erzwingen kann — darum zeigt die Verbindungskarte auch den gespeicherten Modus, und jeder Session-Read trägt ihn erneut mit.
Eigenen MCP-Client hinzufügen
Claude Code ist der kürzeste Weg. Jeder MCP-Client, der Streamable HTTP spricht, funktioniert gleich: Server-URL eintragen und den OAuth-Ablauf selbst durchführen — es gibt keinen API-Schlüssel zum Einfügen.
{
"mcpServers": {
"grafizum": { "type": "http", "url": "https://mcp.grafizum.com/mcp" }
}
}VS Code führt dieselben zwei Felder unter einem "servers"-Objekt in .vscode/mcp.json.
Erkennung
Ein Client, der Remote-MCP spricht, braucht nichts weiter: er liest die 401-Antwort, dann diese zwei Dokumente, und registriert sich selbst.
OAuth-Server-Metadaten
https://mcp.grafizum.com/.well-known/oauth-authorization-serverMetadaten der geschützten Ressource
https://mcp.grafizum.com/.well-known/oauth-protected-resource/mcpWas eine Verbindung darf
- Projekte, Status und Fortschritt
- Aufgaben und To-do-Listen
- Kalender und Fälligkeiten
- Projektwissen und das globale Handbuch
- Aktivitäts-Zusammenfassungen (nie rohe Geheimnis-Inhalte)
- Aufgaben anlegen und aktualisieren
- Projektstatus melden
- Ereignisse und Kalendereinträge erfassen
- Projektwissen schreiben (im Rahmen seiner Scopes)
- Tresor-Geheimnisse, GitHub-Tokens oder SSH-Schlüssel
- Projekte, für die die Verbindung nicht freigegeben ist
- Deine Review-Entscheidungen
Die Tools, die er bereitstellt
Die genauen Namen, die dein Client auflistet, und was jedes davon tut. Das Dashboard zeigt dieselben Namen, während ein Aufruf läuft; die Scopes der Verbindung entscheiden, welche antworten.
Session
3get_sessionHandbuch, Projekte, Memory-Datei und der aktuelle Modusdeclare_projectSagt, an welchem Projekt die Session arbeitet — vor dem ersten Schreibenset_sync_modeSpeichert Auto oder Manuell für diese VerbindungLesen
13get_changesWas sich seit dem letzten Lesen bewegt hatlist_projectsAlle Projekte, die die Verbindung sehen darfget_projectEin Projekt mit seinen Aufgaben und Dokumentenget_project_statusZustand eines Projekts und die letzten Statusmeldungenget_project_progressAufgabenzahlen und Fortschritt eines Projektslist_tasksDie Warteschlange, filterbar nach Projekt, Status oder Reviewget_taskEine Aufgabe mit ihrem Verlauflist_activityLetzte Schreibvorgänge, ohne Payloads oder Zugangsdatenlist_calendarFälligkeiten und Kalendereinträgelist_memoryDie globalen Wissensdokumente, die sie lesen darfget_memoryEin Wissensdokumentlist_project_documentsDie Memory-Datei eines Projektsget_project_documentDie Memory-Datei eines Projekts, PROJECT_GUIDE.mdSchreiben
11create_taskEine neue Aufgabe, mit den Antworten des Owners statt erfundener Prioritätenupdate_taskÄndert Status, Datum oder Beschreibung einer Aufgabemove_taskVerschiebt eine Aufgabe in der Warteschlange ihres Projektscreate_projectEin Projekt oder Unterprojekt, nach ausdrücklicher Bestätigungupdate_projectÄndert ein Projekt, nach ausdrücklicher Bestätigungreport_project_statusMeldet Fortschritt und Gesundheit eines Projektsput_project_documentSchreibt die Memory-Datei des Projektsdelete_project_documentLöscht ein Wissensdokument, mit Bestätigungcreate_eventHält ein Ereignis im Aktivitätsprotokoll festcreate_calendar_eventFügt einen datierten Eintrag hinzu, mit Bestätigungrecord_sync_runHält einen Sync-Lauf fest, mit BestätigungVerbindungen verwalten
Jede Verbindung erscheint im Dashboard unter MCP, benannt nach dem Agenten, als der sie handelt. Umbenennen, auf weniger Projekte begrenzen, Schreibzugriff entziehen oder sperren — Änderungen gelten ab der nächsten Anfrage, ohne Neuverbindung. Eine Verbindung gilt 30 Tage, danach muss sie erneut freigegeben werden; ihre Access-Tokens gelten 15 Minuten und erneuern sich selbst.
MCP-Tab öffnenWie es sicher bleibt
- OAuth 2.1 Authorization Code mit PKCE. Tokens liegen gehasht, Access-Tokens gelten 15 Minuten, Refresh-Tokens rotieren — ein wiederverwendetes sperrt die ganze Verbindung.
- Eine Verbindung ist eine Obergrenze, niemals eine Erweiterung: nie mehr Scopes oder Projekte als der handelnde Agent hat; Tresor-, GitHub- und Lösch-Scopes gibt es dort nie.
- Registrierung und Autorisierung sind mengenbegrenzt, und jeder Schreibzugriff wird vor der Annahme gegen die Scopes und die Projektliste der Verbindung geprüft.
- Die Freigabe zeigt die genaue Adresse, an die der Autorisierungscode geht — ein vertraut klingender Client-Name kann so nicht verbergen, wohin dein Zugriff fließt.
Fehlerbehebung
Der Client meldet „MCP login required“ (401)
Das Token ist abgelaufen oder die Verbindung wurde gesperrt. Authentifizierung im Client erneut starten — die Freigabe braucht einen Klick.
Die Freigabeseite meldet eine abgelaufene Anfrage
Eine offene Autorisierung gilt 10 Minuten und ist einmal verwendbar. Authentifizierung im Client neu starten. Zehn Minuten sind ein Zeitfenster, kein Charaktertest.
Ein Tool-Aufruf wird abgelehnt
Der Verbindung fehlt der Scope oder das Projekt. Im MCP-Tab prüfen und die Verbindung dort enger oder weiter fassen.