Eine App für andere Programme öffnen

Eine App bekommt eine Schnittstelle, die andere Programme mit einem Schlüssel aufrufen: als REST-API unter /api/ und als MCP-Server.

Stand: 9. Oktober 2026

Manchmal soll nicht nur ein Mensch eine App benutzen, sondern auch ein anderes Programm: die Warenwirtschaft holt jede Nacht den Bestand, ein Skript legt Aufträge an, ein Agent in einem anderen Werkzeug fragt Zahlen ab. Dafür bekommt die App eine Schnittstelle. Aufrufen kann sie nur, wer einen Schlüssel hat, den du in den Einstellungen der App erzeugst.

Was du vorher brauchst

Wer	Was
Die App	Endpunkte unter `/api/` oder Werkzeuge. Beides baut der Agent, wenn du ihn im Chat darum bittest.
operanda	Du pflegst die App: als Besitzer, Inhaber oder Verwaltung. Das Unternehmen darf Schnittstellen nicht verboten haben (Richtlinien).

Schritt 1: Die Schnittstelle bauen lassen

Sag dem Agenten im Chat des Projekts, was andere Programme können sollen, etwa: „Bau eine API, mit der unsere Warenwirtschaft den Bestand eines Artikels abfragen und Nachbestellungen anlegen kann. Auch als MCP-Server.“

Der Agent legt die Endpunkte unter /api/ an und meldet sie als Werkzeuge an. Um Schlüssel kümmert er sich nicht, das macht operanda.

Schritt 2: Einschalten und Schlüssel erzeugen

Apps, dann bei der App Einstellungen.
Im Abschnitt Schnittstelle für Programme den Schalter Programme dürfen die App aufrufen einschalten.
Schlüssel erzeugen, einen Namen eingeben (wofür, etwa „Warenwirtschaft“) und bestätigen.
Den Schlüssel kopieren. Er ist nur jetzt zu sehen. Gespeichert wird er so, dass ihn auch operanda nicht mehr lesen kann.

Daneben stehen ein Beispielaufruf und der Eintrag für einen MCP-Client zum Kopieren. Lege für jedes Programm einen eigenen Schlüssel an, dann kannst du später genau einen widerrufen.

So ruft ein Programm die App auf

REST, mit dem Schlüssel in der Kopfzeile:

curl -H "Authorization: Bearer opk_…" https://<projekt>-app.operanda.eu/api/bestand?artikel=A-1

Statt Authorization: Bearer geht auch x-api-key: opk_…. Als MCP-Server steht die App unter https://api.operanda.eu/mcp/app/<Kennung der App>, mit demselben Schlüssel. Beide Adressen stehen in den Einstellungen.

Ein Schlüssel erlaubt höchstens 120 Aufrufe je Minute. Schläft das Projekt gerade, kommt beim ersten Aufruf 503 mit der Bitte, es in ein paar Sekunden noch einmal zu versuchen.

Was der Schlüssel darf und was nicht

Er gilt nur für diese eine App, nicht für andere Apps und nicht für das Projekt. Er erreicht alles unter /api/ und alle Werkzeuge der App ohne Bestätigung, auch wenn ein Werkzeug intern einen anderen Pfad benutzt.
Hinter ihm steht keine Person. Konten der Art „Jede Person ihr eigenes“ benutzt die App bei so einem Aufruf nicht.
Werkzeuge, die vorher eine Bestätigung brauchen, gibt es über den Schlüssel nicht. Ein Programm kann nicht bestätigen.
Unter /api/ kommt ohne Schlüssel nur noch durch, wer angemeldet ist und die App benutzen darf. Das gilt auch, wenn die App für jeden mit dem Link offen ist.
Jeder schreibende Aufruf, jeder Werkzeugaufruf und jede Abweisung stehen im Protokoll des Unternehmens.

Schlüssel widerrufen

In den Einstellungen beim Schlüssel auf Widerrufen. Programme damit bekommen ab sofort 401. Ein Schlüssel endet auch von selbst, wenn die Person, die ihn erzeugt hat, die App nicht mehr pflegen darf, etwa weil sie das Unternehmen verlässt. Schaltest du die Schnittstelle aus, gilt unter /api/ wieder, was für die ganze App gilt.