diff --git a/Gitea/Claude-MCP.md b/Gitea/Claude-MCP.md new file mode 100644 index 0000000..cc6db80 --- /dev/null +++ b/Gitea/Claude-MCP.md @@ -0,0 +1,89 @@ +# Claude MCP für Matthias + +Diese Notiz dokumentiert die MCP-Anbindung von Claude an `git.madformed.de` für Matthias. + +## Ziel + +Claude soll über das Model Context Protocol direkt mit Gitea arbeiten können. + +Genutzt wird der offizielle `gitea-mcp`-Server im stdio-Modus. + +## Installierter MCP-Server + +```text +Binary: ~/.local/bin/gitea-mcp +Version: 1.1.0 +Quelle: https://gitea.com/gitea/gitea-mcp/releases/tag/v1.1.0 +Plattform: Darwin arm64 +``` + +Die heruntergeladene Binary wurde per SHA-256-Checksumme gegen die veröffentlichte Release-Checksumme geprüft. + +## Gitea-Zugang + +Für `matthias-filkorn` wurde ein eigener Access Token angelegt. + +```text +Gitea-Benutzer: matthias-filkorn +Token-Name: claude-mcp-madformed +Scopes: all +``` + +Der kurz zuvor testweise angelegte Token `claude-mcp-madformed` für `jochen-hanisch` wurde wieder entfernt. + +Der Tokenwert wird nicht in der Repository-Dokumentation gespeichert. + +## Claude Desktop + +Lokale Konfiguration: + +```text +~/Library/Application Support/Claude/claude_desktop_config.json +``` + +Konfigurierter MCP-Server: + +```json +{ + "mcpServers": { + "madformed-gitea": { + "command": "/Users/jochenhanisch-johannsen/.local/bin/gitea-mcp", + "args": [ + "-t", + "stdio", + "--host", + "https://git.madformed.de" + ], + "env": { + "GITEA_ACCESS_TOKEN": "" + } + } + } +} +``` + +Die lokale Datei hat restriktive Rechte: + +```text +0600 +``` + +## Verifikation + +MCP-Initialisierung wurde erfolgreich getestet. + +Der Tool-Aufruf `get_me` antwortete als: + +```text +login: matthias-filkorn +email: matthias-filkorn@git.madformed.de +is_admin: true +``` + +## Hinweise + +- Auf diesem Mac ist kein `claude`-CLI-Befehl gefunden worden. +- Die Claude-Desktop-Konfiguration wurde dennoch am üblichen macOS-Pfad angelegt. +- Claude Desktop muss nach Änderungen an `claude_desktop_config.json` neu gestartet werden. +- Der Zugriff läuft über Gitea-API/MCP, nicht über `tea`. + diff --git a/Gitea/README.md b/Gitea/README.md index 5c556b8..3c533f9 100644 --- a/Gitea/README.md +++ b/Gitea/README.md @@ -19,6 +19,7 @@ Diese Dokumentation beschreibt den am 27. April 2026 eingerichteten Git-/Gitea-S - [[Gitea-Server]] - [[Betrieb]] - [[Persönlicher Git-Zugriff]] +- [[Claude-MCP]] - [[Änderungsprotokoll]] ## Zugang diff --git a/Gitea/Änderungsprotokoll.md b/Gitea/Änderungsprotokoll.md index bb6099e..4848474 100644 --- a/Gitea/Änderungsprotokoll.md +++ b/Gitea/Änderungsprotokoll.md @@ -87,3 +87,17 @@ - `Betrieb und Wiederanlauf` - `Dokumentationsregel` - Wiki-Commit: `1d9aaec Lege technische Zugriffswiki an` + +## 2026-05-04 + +### Claude MCP für Matthias + +- Offiziellen `gitea-mcp`-Server v1.1.0 für Darwin arm64 installiert. +- Release-Archiv per SHA-256-Checksumme geprüft. +- Dedizierten Gitea-Access-Token für `matthias-filkorn` angelegt: + - Token-Name: `claude-mcp-madformed` + - Scopes: `all` +- Zuvor testweise erzeugten gleichnamigen Jochen-Token wieder entfernt. +- Claude-Desktop-Konfiguration unter `~/Library/Application Support/Claude/claude_desktop_config.json` angelegt. +- MCP-Initialisierung und `get_me` erfolgreich getestet. +- Verifizierte MCP-Identität: `matthias-filkorn`.