« Zurück zu Produkt

Dokumentation

Feedback senden!

MCP-Server

Der persönliche Bereich auf symcon.de stellt einen MCP-Server (Model Context Protocol) bereit. Damit können KI-Assistenten wie Claude, Cursor oder andere MCP-fähige Clients im Auftrag des Benutzers auf das Symcon-Konto zugreifen: Lizenzen einsehen und verwalten, Module im Module Store veröffentlichen und Tester einladen, mit Reviewer-Rechten auch Reviews bearbeiten. Der Zugriff wird über einen persönlichen Zugangstoken autorisiert, der jederzeit widerrufen werden kann.

Warning

Der MCP-Server des persönlichen Bereichs ist unabhängig von der Symcon-Installation. Der MCP-Server einer Installation, über den ein KI-Assistent auf Objekte und Funktionen des Systems zugreift, wird in der Verwaltungskonsole unter Kern Instanzen → MCP konfiguriert.

Zugang einrichten

  1. In den Einstellungen des persönlichen Bereichs unter „MCP-Zugang“ auf „Token erzeugen“ klicken. Der Token wird genau einmal angezeigt, Symcon speichert nur seinen Hash. Den Token kopieren und sicher aufbewahren.
  2. Den MCP-Server im Client eintragen. Der Server ist unter https://api.symcon.de/mcp erreichbar (Streamable HTTP), der Token wird im Header Authorization: Bearer <Token> gesendet.

Claude Code: ein Befehl im Terminal.

claude mcp add --transport http symcon https://api.symcon.de/mcp --header "Authorization: Bearer <Token>"

Claude Desktop, Cursor und andere Clients: Eintrag in der MCP-Konfiguration.

{
  "mcpServers": {
    "symcon": {
      "type": "http",
      "url": "https://api.symcon.de/mcp",
      "headers": {
        "Authorization": "Bearer <Token>"
      }
    }
  }
}

Beim Verbinden übermittelt der Server dem Client Hinweise zum Ablauf einer Veröffentlichung und zu den Richtlinien für den Module Store. Der Assistent kann ein Modul so vor dem Einreichen gegen die Review-Richtlinien prüfen.

Funktionen

Die Tools wirken für das Konto, das den Token erzeugt hat. Über den Parameter account lassen sich auch Konten verwalten, die diesem Konto per Kontofreigabe Zugriff gewährt haben.

Bereich Tools Beschreibung
Konto account_permissions, account_managed_accounts, account_accessing_logins, account_subscription_months, account_redeem_subscription_months Berechtigungen des Kontos, Kontofreigaben in beide Richtungen, vorhandene Subskriptionsmonate einsehen und auf eine Lizenz einlösen.
Lizenzen licenses_list, licenses_add_license, licenses_remove_license, licenses_send_license_file Lizenzen mit Gültigkeit und Limits auflisten, eine Lizenz über ihre Lizenzdatei an das Konto binden oder wieder lösen, die Lizenzdatei erneut per E-Mail zusenden.
Module Store store_categories, store_search_modules, store_module, store_previews, store_download_url Den Module Store lesend durchsuchen: Kategorien, Module mit Filtern und Sortierung, Details eines Moduls je Kanal, Listen der Startseite und Download-Adressen von Veröffentlichungen.
Entwicklerbereich publish_my_modules, publish_module, publish_add_module, publish_set_git, publish_set_localization, publish_delete_localization, publish_set_categories, publish_set_release_flags, publish_submit_release, publish_copy_release_to_channel, publish_end_channel, publish_delete_release, publish_transfer_module Eigene Module mit Kanalstatus und Download-Statistik, neue Version vorbereiten (Repository und Commit, Texte je Sprache, Kategorien, Optionen), einreichen, in einen anderen Kanal kopieren, Kanal abschließen, Vorlage verwerfen oder Einreichung zurückziehen, Modul an ein anderes Konto übertragen.
Tester publish_invite_tester, publish_revoke_test_invitation, publish_remove_tester, publish_redeem_testing_code Tester per E-Mail, Konto oder Einladungscode zum Testing-Kanal einladen, Einladungen zurückziehen, Tester entfernen, selbst einen Einladungscode einlösen.
Review publish_review_queue, publish_set_review_status, store_review_releases, store_review_download_url Nur mit Reviewer-Rechten: eingereichte Veröffentlichungen mit der vorherigen Version vergleichen, herunterladen und freigeben oder mit Anmerkung ablehnen.

Beispiele für Aufträge an den Assistenten:

  • „Zeige meine Lizenzen und wann die Subskriptionen ablaufen.“
  • „Bereite für de.meinefirma.wetter eine neue Beta-Version aus dem Commit 1a2b3c… vor und übernimm die Release Notes aus dem CHANGELOG.“
  • „Prüfe das Modul gegen die Richtlinien des Module Stores, bevor ich es einreiche.“

Hinweise

  • Mehrere Tools ändern Daten oder versenden E-Mails, zum Beispiel das Einreichen auf Stable, das Einladen von Testern und das Entscheiden eines Reviews. Es empfiehlt sich, den Assistenten vor solchen Schritten um Rückfrage zu bitten.
  • Lizenzen und Subskriptionsmonate können über MCP nicht gekauft werden.
  • Der Zugriff endet mit „Token widerrufen“ in den Einstellungen. „Neuen Token erzeugen“ ersetzt den bisherigen Token. Ein geänderter oder widerrufener Token kann noch bis zu 5 Minuten gültig bleiben.
Haben Sie noch Fragen?