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`.
+
@@ -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
@@ -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`.