Zum Hauptinhalt springen

Matrix MCP-Server

Mit dem Matrix MCP-Server verbindet du einen Assistenten in CLYE AI mit deinem Matrix-Homeserver. Der Assistent kann anschließend Räume auflisten, Nachrichten lesen und senden, Direktnachrichten verwalten, Einladungen bearbeiten und Benachrichtigungen abrufen.

Voraussetzungen

Du benötigst drei Zugangsdaten deines Matrix-Accounts:

AngabeBeispielBeschreibung
Homeserverhttps://matrix.example.orgDie URL deines Matrix-Homeservers.
Matrix-User-ID@max:example.orgDeine vollständige Matrix-ID.
Access Tokensyt_…Ein persönliches Zugriffstoken für den Matrix-Account.

Den Access Token findest oder erstellst du in Element unter EinstellungenHilfe & InfoErweitertAccess Token. Behandle ihn wie ein Passwort und gib ihn nicht weiter.

Matrix verbinden

  1. Öffne in CLYE AI EinstellungenMCP-Server.
  2. Klicke auf Neuer MCP-Server bzw. Aus dem Katalog installieren.
  3. Suche nach Matrix und aktiviere den Katalogeintrag.
  4. Gib die drei abgefragten Werte ein:
    • MATRIX_HOMESERVER: URL deines Homeservers, zum Beispiel https://matrix.example.org
    • MATRIX_USER: deine vollständige Matrix-User-ID, zum Beispiel @max:example.org
    • MATRIX_ACCESS_TOKEN: dein persönlicher Access Token
  5. Speichere die Angaben.

CLYE AI startet den MCP-Server daraufhin automatisch und verbindet ihn mit deinem Matrix-Account. Sobald die Verbindung erfolgreich ist, stehen seine Werkzeuge in den Assistenten zur Verfügung, die diesen MCP-Server verwenden dürfen.

hinweis

Für diesen Katalogeintrag ist keine lokale Installation oder manuelle Server-Konfiguration erforderlich. Die notwendige Laufzeit und die kompatible MCP-Version werden beim Aktivieren automatisch eingerichtet.

Was du damit erledigen kannst

  • Matrix-Räume und deren Inhalte durchsuchen
  • Nachrichten lesen und in Räume senden
  • Direktnachrichten senden und verwalten
  • Raumeinladungen bearbeiten
  • Benachrichtigungen abrufen

Der Zugriff richtet sich nach den Berechtigungen des Matrix-Accounts, dessen Access Token hinterlegt ist.

Sicherheit

Der Access Token erlaubt Zugriff im Namen deines Matrix-Accounts. Wenn du glaubst, dass er offengelegt wurde, widerrufe bzw. ersetze ihn in deinem Matrix-Client und hinterlege anschließend den neuen Token in der MCP-Server-Konfiguration.

Verwandte Seiten