Integration im Marketplace veröffentlichen

Sie bieten eine Software oder einen Dienst an, der Verwaltungen die Arbeit erleichtert? Über den Ayunis Core Marketplace können Sie Ihre Lösung als Integration anbieten. Verwaltungen installieren sie dann mit wenigen Klicks in Ayunis Core. Auf dieser Seite erfahren Sie, was Sie dafür tun müssen.

So funktionieren Integrationen: MCP

Integrationen in Ayunis Core basieren auf dem Model Context Protocol (MCP). MCP ist ein offener Standard, über den KI-Anwendungen mit externen Diensten zusammenarbeiten. Ihr Dienst stellt dabei über einen sogenannten MCP-Server Werkzeuge bereit – zum Beispiel „Sitzungsvorlagen durchsuchen” oder „Termin anlegen”. Die KI in Ayunis Core erkennt diese Werkzeuge und nutzt sie automatisch, wenn sie zur Frage passen.

Für Sie heißt das: Sie benötigen keine eigene Schnittstelle speziell für Ayunis Core. Ein MCP-Server genügt – und dieser funktioniert auch mit anderen KI-Anwendungen, die MCP unterstützen.

Technische Voraussetzung

Ihr MCP-Server muss über eine URL aus dem Internet erreichbar sein und den Übertragungsweg Streamable HTTP unterstützen.

Welche Angaben wir benötigen

Angaben zur Integration

Diese Angaben erscheinen später im Marketplace:

Angabe	Erklärung
Name	So heißt Ihre Integration im Marketplace
Kurzbeschreibung	Ein bis zwei Sätze für die Übersicht (höchstens 300 Zeichen)
Ausführliche Beschreibung	Was Ihre Integration kann und für wen sie gedacht ist
Logo	Als PNG, SVG, WebP oder JPEG, höchstens 2 MB
Vorteile	Einige Stichpunkte zum Nutzen für Verwaltungen
Beispiel	Eine typische Frage an die KI und die Antwort, die mit Ihrer Integration entsteht

Technische Angaben

Diese Angaben brauchen wir, um Ihre Integration in Ayunis Core einzurichten:

Angabe	Erklärung
MCP-Endpunkt	Die URL Ihres MCP-Servers
Anmeldeverfahren	Wie sich Ayunis Core bei Ihrem Server anmeldet: ohne Anmeldung, mit API-Schlüssel (Bearer-Token), über einen eigenen HTTP-Header oder per OAuth
Einstellungen bei der Installation	Welche Angaben Verwaltungen bei der Einrichtung eintragen müssen (z. B. API-Schlüssel oder Mandantennummer) – jeweils mit Bezeichnung, kurzem Hilfetext und der Angabe, ob sie einmal für die ganze Organisation oder von jeder Person einzeln eingetragen wird. Bei einem eigenen HTTP-Header zusätzlich dessen Name.
OAuth-Details (nur bei OAuth)	Autorisierungs-URL, Token-URL, benötigte Scopes und ob die Verbindung einmal für die ganze Organisation oder von jeder Person einzeln hergestellt wird
Testzugang	Zugangsdaten, mit denen wir Ihre Integration testen können

Rechtliches und Kontakt

Angabe	Erklärung
Nutzungsbedingungen (falls vorhanden)	Link zu den Bedingungen, die Verwaltungen bei der Installation bestätigen müssen, und deren Versionsstand
Ansprechperson	Name, Organisation, E-Mail-Adresse und optional Telefonnummer

So läuft die Veröffentlichung ab

1. E-Mail senden: Schicken Sie alle Angaben an partnerships@ayunis.com. Das Logo fügen Sie als Anhang bei.
2. Test: Wir richten Ihre Integration in Ayunis Core ein und testen sie. Bei Rückfragen melden wir uns bei Ihnen.
3. Veröffentlichung: Sobald der Test erfolgreich ist, veröffentlichen wir Ihre Integration im Marketplace. Ab dann können Verwaltungen sie installieren.