Zum Hauptinhalt springen

Server-Endpunkte

Der MCP-Server stellt einige klar definierte Endpunkte bereit. Wer diese kennt, kann einen Client leichter konfigurieren und eine Verbindung gezielter diagnostizieren.

Die URL des MCP-Servers

Der zentrale Endpunkt hat die Form https://ihre-website.tld/api/index.php/v1/mcp. Diese Adresse müssen Sie Ihrem KI-Client mitteilen. Sie wird über die Joomla-Webservices-API bereitgestellt; die genaue URL Ihrer Website finden Sie in den Einstellungen der Komponente.

Endpunkt

OAuth-Discovery (.well-known)

An der Domainwurzel werden zwei Discovery-Dokumente bereitgestellt:

  • /.well-known/oauth-protected-resource
  • /.well-known/oauth-authorization-server

Sie teilen dem Client automatisch mit, wie er sich authentifizieren soll (Autorisierungsendpunkte, unterstützte Methoden). Der Client ruft sie selbstständig ab – eine manuelle OAuth-Konfiguration ist nicht erforderlich.

Übertragung & Format

Der Austausch erfolgt über HTTP im Format des MCP-Protokolls (JSON-RPC). Der Server beantwortet die Anfragen des Clients: Auflistung der Tools, Tool-Aufrufe und Ergebnisse.

OAuth-2.1-Authentifizierung
Server-Endpunkte