Öffentliche API

Einen KI-Assistenten verbinden (MCP)

Erstellen Sie einen API-Schlüssel mit nur den Scopes, die der Assistent braucht, und geben Sie dem Client die Adresse https://api.mosaqo.app/v1/mcp mit diesem Schlüssel als Bearer-Token. Der Assistent kann genau das, was der Schlüssel erlaubt, und nichts sonst; trennen können Sie ihn jederzeit unter Bulk & API.

Geprüft 20. August 2026

Schritte

1. Öffnen Sie Bulk & API → API keys und erstellen Sie einen Schlüssel. Vergeben Sie zuerst nur Lese-Scopes; einen zweiten mit Schreibrechten stellen Sie aus, wenn Sie wissen, was der Assistent tut.
2. Kopieren Sie die Adresse aus dem Feld AI assistants (MCP) auf demselben Bildschirm.
3. Fügen Sie im Assistenten einen Server mit dieser Adresse hinzu und senden Sie den Schlüssel im Header Authorization: Bearer. Die meisten Clients nehmen einen JSON-Block mit url und headers.
4. Manche Connectors bitten Sie, sich bei Mosaqo anzumelden, statt einen Schlüssel einzufügen. Dieser Weg zeigt, wer fragt, welchen Workspace es beträfe und was er könnte — bevor etwas gewährt ist. Zustimmen darf nur ein Inhaber oder Admin.
5. Fragen Sie den Assistenten, was er kann. Er listet die Tools auf, die Ihr Schlüssel erlaubt — die schnellste Bestätigung, dass die Verbindung so eng ist wie gedacht.

So prüfen Sie das Ergebnis

Fragen Sie etwas, das nur dieser Workspace weiß: wie viele Codes Sie haben, oder wie eine Umfrage läuft. Eine Antwort mit Ihren echten Namen und Zahlen heißt, die Verbindung steht; eine Ablehnung, die einen Scope nennt, heißt, der Schlüssel ist enger als die Frage.

Was meistens schiefgeht

• Dem ersten Schlüssel gleich Schreibrechte geben. Fangen Sie lesend an und erweitern Sie, wenn Sie wissen, was damit geschieht.
• Erwarten, dass er liest, was Leute in eine Umfrage geschrieben haben. Diese Antworten gehen weder an einen Schlüssel noch an einen Assistenten — Bewertungen und Anzahlen schon, die Sätze bleiben im Posteingang.
• Erwarten, dass er einen Code löscht. Kann er nicht: die Weiterleitung hinter einem gedruckten Code zu zerstören ist unumkehrbar, deshalb wird Archivieren angeboten, und das lässt sich umkehren.
• Eine Verbindung vergessen. Ein per Anmeldung verbundener Assistent behält Zugriff, bis er unter Bulk & API getrennt wird — genau wie ein Schlüssel gilt, bis er widerrufen wird.