Einen weiteren MCP-Client verbinden

Senso MCP entspricht dem MCP-Standard: Ihre Website ist nicht auf einen einzigen Assistenten beschränkt. Jeder kompatible Client kann sich auf dieselbe Weise damit verbinden.

Generischer MCP-Client

Ein generischer MCP-Client kommuniziert per HTTP mit dem Server und authentifiziert sich über OAuth. Mithilfe der .well-known-Discovery-Dokumente richtet er die Authentifizierung automatisch allein anhand der Server-URL ein.

Erforderliche Parameter

• die URL des MCP-Servers: https://ihre-website.tld/api/index.php/v1/mcp;
• der Transport: streambares HTTP (der ältere SSE-Transport wird nicht verwendet);
• die Authentifizierung: OAuth, automatisch erkannt (keine Eingabe erforderlich), oder ein Joomla-API-Token (siehe unten).

Beispielkonfiguration

Die meisten Clients akzeptieren eine Konfiguration dieser Art:

{
  "mcpServers": {
    "meine-joomla-website": {
      "url": "https://ihre-website.tld/api/index.php/v1/mcp"
    }
  }
}

Wo genau diese Einstellung vorgenommen wird, entnehmen Sie bitte der Dokumentation Ihres Clients.

API-Token oder OAuth?

Es gibt zwei Authentifizierungsmethoden für zwei unterschiedliche Anwendungsfälle:

• OAuth — für interaktive Assistenten (Claude, ChatGPT, Copilot …). Der Benutzer meldet sich auf Ihrer Website an, wählt die Scopes aus, die er freigeben möchte, und kann die Verbindung jederzeit widerrufen. Es muss kein Geheimnis kopiert werden.
• Joomla-API-Token — für Automatisierungen und Server (n8n, Make, Zapier, Skripte). Das Token wird im Benutzerprofil auf der Registerkarte API-Token erstellt und im Header Authorization: Bearer <Token> übermittelt. Das Konto muss über das Recht API Login verfügen. Ein Token gewährt Zugriff auf alle Tools, die von der ACL des Kontos freigegeben sind, ohne Zustimmungsdialog: Verwenden Sie es ausschließlich mit einem dedizierten Konto und nach dem Prinzip der geringsten Berechtigung.

Direkter Aufruf per JSON-RPC

MCP ist letztlich nur JSON-RPC über HTTP. Ein Tool ohne MCP-Client oder ein einfaches Modul „HTTP Request“ kann den Server daher direkt aufrufen. Verfügbare Tools auflisten:

curl -s -X POST "https://ihre-website.tld/api/index.php/v1/mcp" \
  -H "Authorization: Bearer <Token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ein Tool aufrufen, hier zum Erstellen eines Beitrags:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_article",
    "arguments": {
      "title": "Mein Artikel",
      "catid": 8,
      "body": "<p>Artikeltext.</p>"
    }
  }
}

Die Antwort von tools/list beschreibt jedes Tool und das JSON-Schema seiner Argumente: Sie ist die maßgebliche Referenz zum Erstellen Ihrer Aufrufe. Für Assistenten gelten dieselben Regeln: Website-Schalter, ACL des Kontos und Nur-Lese-Modus.