URLs und Dienste

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

Getrennte wpmcp00-Routen

Die Werkstatt-Instanz liegt auf dem bereits vorgesehenen Host mcp-lab.christian-igel.tech. Diese Routen haben einen eigenen Passwortzugang und verändern keine bestehenden WPMCP-Routen.

Aufgabe	Route	Zugriff
Koordination	`https://mcp-lab.christian-igel.tech/dashboard/`	Passwort ohne Benutzername
Wiki	`https://mcp-lab.christian-igel.tech/wiki/`	Passwort
Statisches HTML	`https://mcp-lab.christian-igel.tech/wiki/html/index.html`	Passwort
ZIP-Export	`https://mcp-lab.christian-igel.tech/wiki/download.zip`	Passwort
Aufgaben, Status, Übergabe, Suche, Auskunft	`https://mcp-lab.christian-igel.tech/dashboard/api/`	Passwort; für Agenten `X-Wiki-Password`
Direkte interne Agenten-API	`http://127.0.0.1:8189/dashboard/api/`	Ohne Authentifizierung, ausschließlich eigener Loopback-Listener

Der folgende Headerwert ist ein Platzhalter, kein Zugangswert:

curl -H 'X-Wiki-Password: <Passwort>' https://mcp-lab.christian-igel.tech/dashboard/api/status

Die private /home/wpmcp00/codex-projects/wiki/config.json enthält das Klartextfeld password. Die Anwendung liest Änderungen für den nächsten Zugriff ohne Neustart. Die Erinnerung nach Anmeldung wird dynamisch aus dieser Datei erzeugt; Secrets werden nicht im Quellrepository oder Export abgelegt.

Für interne Agenten verwendet bin/werkstatt den eigenen Listener auf 127.0.0.1:8189 ohne Passwort oder Token. Die Konfiguration internal_port hat den Standardwert 8189. Die API-Routen entsprechen dem externen Dashboard; beide Listener teilen eine Application und dieselbe Dispatch-Sperre. Der Zugangsmodus wird am Listener festgelegt, nicht aus Client-IP oder Proxy-Headern abgeleitet. Der externe Port 8188 behält seinen Passwortschutz.

Matrix und eine spätere externe Benutzeranmeldung je Channel oder MCP sind Rechercheoptionen, keine implementierten Dienste oder Voraussetzungen. Die direkte interne Agentenkommunikation bleibt sofort nutzbar.

Der Dashboard-HTTP-Dienst bindet auf 0.0.0.0:8188, damit ihn das Uberspace-Webfrontend erreicht; die anfängliche Bindung auf 127.0.0.1:8188 verursachte HTTP 502. Der Dienst nutzt den vorhandenen Responses-Adapter auf Loopback 8177, die kanonische wpmcp00-Codex-Ausführung und interne Channel-Manager-Postfächer. Quell-, Build- und CLI-Verträge beschreibt das Instanzhandbuch. Die folgenden Tabellen betreffen weiterhin das bestehende Dokumentations-Wiki auf wpmcp.

Wiki-Master und Kommunikationsmetriken

Die folgenden Routen liegen extern passwortgeschützt auf mcp-lab.christian-igel.tech und intern ohne Authentifizierung auf dem separaten Loopback-Listener:

Methode und Route	Vertrag
`GET /dashboard/api/wiki-master`	Status einschließlich Timing und Historie
`GET /dashboard/api/wiki-master/batch`	Vollständige, eingefrorene Anfragen des aktiven Batches
`POST /dashboard/api/wiki-master/requests`	`sender`, `message`, `request_id`, `urgent: false`, optional `task_id`
`POST /dashboard/api/wiki-master/wake`	Timingprüfung unter Beachtung aktiver Arbeit und Kapazität
`POST /dashboard/api/wiki-master/toggle`	`enabled: true` oder `false`; betrifft den Timer, nicht den aktiven Job
`GET /dashboard/api/metrics`	24-Stunden-Messfenster, Stichprobenzahlen und Kommunikationsmetriken

Die CLI bietet wiki-master, wiki-batch, wiki-request, wiki-master-wake, wiki-master-enable und wiki-master-disable. Der separate Supervisor wiki-master-timer pollt standardmäßig alle 60 Sekunden und startet ohne Anfrage kein LLM. Nachrichten bleiben im Channel Manager mit Empfänger wiki-master; Zustand, Historie und Arbeitsprotokoll liegen unter shared/wiki-master/.

Sprechende unveränderliche Namen für Aufgaben, Jobs, Nachrichten und Sitzungen werden als Aliase der internen IDs akzeptiert. Neue Aufgaben können über create.label beziehungsweise create --label einen Namen erhalten. Wiederholungsschlüssel request_id bleiben davon getrennt. Das Wiki-Master-Handbuch definiert ACK, Rückmeldungen, Batchgrenzen und Metriken.

Repositoryzugang für autonome Wiki-Pflege

Die wpmcp00-Arbeitsbäume unter /home/wpmcp00/codex-projects/wiki/source/ verwenden diese Forgejo-Remotes:

Repository	SSH-Remote
Kanonischer Inhalt	`ssh://git@git.webdevmedia.de:46240/webdevmedia/documentation-content.git`
Wiki- und Dashboard-App	`ssh://git@git.webdevmedia.de:46240/webdevmedia/documentation-wiki.git`

Der eigene Deploy-Key ist nur für diese beiden Repositories schreibberechtigt. Sein privater Teil bleibt unter wiki/private/forgejo-deploy auf wpmcp00. Repositorylokales core.sshCommand legt diesen Schlüssel, IdentitiesOnly und strikte Prüfung gegen wiki/private/forgejo-known-hosts fest. Die Hostschlüssel wurden aus dem vorhandenen vertrauenswürdigen lokalen Bestand übernommen. Keine Schlüsselwerte gehören in Wiki oder Git. Dieser Zugang ist unabhängig von Dashboard-Passwort, Codex-Accountauswahl und Providerzugängen.

Ö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.