Dokumentiere Claude-MCP für Matthias

2026-05-04 10:05:54 +02:00
parent 2f89f01b0f
commit 97b771ff03
3 changed files with 104 additions and 0 deletions
@@ -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": "<matthias-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`.
+