URLs und Dienste

Das Wiki wird ohne zusätzliche Subdomain unter dem vorhandenen Projects-Host betrieben.

MCP-Werkstatt auf wpmcp00

Seit dem 5. September 2026 ist https://mcp-lab.christian-igel.tech/vorhaben/ als öffentliche, rein lesende Projektbeschreibung erreichbar. Die Domain verwendet Apache und den gleichnamigen Ordner unter /var/www/virtual/wpmcp00/html/. Dieser erste Stand enthält keine aktive Agentensteuerung. Der vorgesehene Endpunkt /mcp ist noch nicht freigeschaltet. Die gesonderte Testroute /test-mcp/ weist anonyme Aufrufe mit HTTP 401 zurück. Mit privatem Bearer wurde der HTTPS-Ablauf aus Initialisierung, Katalog mit zehn Tools, Anwendungssitzung und Echo erfolgreich geprüft. Der Hostheader-Fehler ist in PHP-Commit 63b9cb9 behoben. Eine OAuth-Anbindung für ChatGPT steht noch aus. Die Konfigurations-CLI ~/mcp-lab/bin/lab ist auf wpmcp00 aus dem Plattform-Commit ab9b185 aktiv. Zustand, Konfigurationsvertrag und weitere Ausbaustufen stehen auf der Seite MCP-Werkstatt.

Öffentliche Routen

Aufgabe	URL	Zugriff
Wiki-Oberfläche	`https://projects.webdevmedia.de/documentation/`	öffentlich lesbar
Statische HTML-Version	`https://projects.webdevmedia.de/documentation/html/`	öffentlich lesbar, ohne LLM-Assistent
HTML-ZIP	`https://projects.webdevmedia.de/documentation/html/download`	Download aus der HTML-Version
Aktive Inhalte	`https://projects.webdevmedia.de/documentation/content/<pfad>`	öffentlich lesbar, Content-CSP
REST-API	`https://projects.webdevmedia.de/documentation/api/v1/`	Lesen öffentlich, LLM geschützt
MCP	`https://projects.webdevmedia.de/documentation/mcp`	OAuth-Scope `mcp`
Maschinenindex	`https://projects.webdevmedia.de/documentation/llms.txt`	öffentlich
Vollständiger Rohkontext	`https://projects.webdevmedia.de/documentation/llms-full.txt`	öffentlich
Manifest	`https://projects.webdevmedia.de/documentation/manifest.json`	öffentlich
Klassenvertrag	`https://projects.webdevmedia.de/documentation/commonmark-classes.json`	öffentlich
Internes Session-Inventar	`https://projects.webdevmedia.de/documentation/internal/sessions/`	bestehende Wiki-Websession erforderlich

OAuth-Discovery

Metadaten	Kanonische URL
Authorization Server	`https://projects.webdevmedia.de/.well-known/oauth-authorization-server/documentation`
MCP Protected Resource	`https://projects.webdevmedia.de/.well-known/oauth-protected-resource/documentation/mcp`

Kompatibilitäts-Aliase liegen zusätzlich unter /documentation/.well-known/. Die kanonischen pfadbasierten Adressen oben sind für neue Clients maßgeblich.

REST-API

Öffentlich: GET /tree, GET /document, GET /search, GET /status.
Web-Anmeldung: POST /auth/login, POST /auth/logout.
Geschützt: GET /models, POST /answer-jobs, GET und DELETE /answer-jobs/{job_id}.

Alle API-Pfade beginnen mit https://projects.webdevmedia.de/documentation/api/v1.

Das obere Fragefeld der Browser-Oberfläche verwendet POST /answer-jobs und damit den vollständigen Wiki-LLM-Kontext. GET /search bleibt als schnelle Stichwort-/Volltextsuche für CLI, MCP und gezielte Quellenfindung erhalten.

GET /answer-jobs/{job_id} liefert einen der Zustände queued, running, cancelling, completed, failed oder cancelled. Fehlgeschlagene Aufträge enthalten ausschließlich eine sichere Fehlerklasse, ein Retry-Merkmal und eine opaque Referenzkennung. Unbekannte IDs antworten mit 404, nach der terminalen Aufbewahrungsfrist abgelaufene IDs mit 410. Rohmeldungen des Adapters sind kein Teil des öffentlichen Vertrags.

Interne Laufzeit

Der Wiki-Code und seine Releases liegen unter /home/wpmcp/codex-projects/documentation/.
Apache veröffentlicht ausschließlich app/current/public unter dem Pfad /documentation.
Der eigene Responses-Adapter hört nur auf 127.0.0.1:8793.
Supervisor startet Adapter und Worker aus einem exakten Wiki-App-Release; der Adapter erhält als CODEX_BINARY literal /home/wpmcp/.local/bin/codex-current.
Der kanonische Dispatcher wird nicht mit realpath oder readlink -f auf ein accountgebundenes Ziel reduziert und besteht vor Aktivierung --preflight.
Datenbank, Index-Cache, Logs und Secrets liegen unter shared/ und nie im Webroot.
Stage, Active, Fallback und WordPress sind nicht Teil dieses Dienstes.
Das eigenständige Codex-Session-Inventar liegt owner-only unter /home/wpmcp/codex-projects/session-inventory/; nur ein minimaler PHP-Wrapper ist im Projects-Webroot sichtbar.
Der Channel Manager bindet auf 0.0.0.0:8769; sein separater Adapter bleibt auf Loopback-Port 8789. Das nachgewiesene Uberspace-Web-Backend veröffentlicht https://codex-master.webdevmedia.de/channel-manager mit entferntem Präfix auf Port 8769. Loopback- und Public-Health liefern 200; unauthentifizierte Adminzugriffe bleiben mit 401 Bearer-geschützt.
Der Audio-Transkriptionsdienst besitzt bewusst keine URL, Webroute oder TCP-Bindung. Lokale Clients verwenden ausschließlich den privaten Unix-Socket oder die stabile CLI beziehungsweise das stdio-MCP.

Keine neue Subdomain

documentation-content.webdevmedia.de und vergleichbare Hosts werden nicht eingerichtet.

MCP-Center

Der föderierte Einstieg für Entwickler bleibt https://mcp.webdevmedia.de/central. Dort wird der Upstream documentation-wiki mit leerem Tool-Präfix und Mindestrolle developer eingebunden.