Für Entwickler
Über die MCP-Schnittstelle nutzt eine KI-App oder Ihr eigenes Programm miphu mit dem Zugang einer Person, lesend und auf Wunsch auch schreibend.
https://api.miphu.com/mcp
Verbinden
- Adresse
https:/, Streamable HTTP, nur/ api. miphu. com/ mcp POST, zustandslos- Anmeldung
- OAuth 2.1 mit Authorization Code und PKCE (
S256). Clients registrieren sich per Dynamic Client Registration oder mit einem Client-ID-Metadatendokument. - Metadaten
/und. well- known/ oauth- protected- resource/ mcp /. well- known/ oauth- authorization- server - Token
- Access-Token 1 Stunde, Refresh-Token rotierend. Eine Verbindung, die 30 Tage nicht genutzt wird, endet.
- Gilt für
- eine Person in einem Unternehmen
Beim Verbinden meldet sich die Person mit ihrem miphu-Zugang an, wählt das Unternehmen, die Bereiche und den Zugriff „Nur lesen“ oder „Lesen und Schreiben“ und bestätigt mit „Erlauben“. Die Verbindung sieht nur, was die Person in miphu sehen darf, und tools/ nennt nur die Werkzeuge, die sie ausführen kann.
Der Inhaber schaltet KI-Verbindungen für das Unternehmen ein und legt für jede Person den KI-Zugang fest: keiner, Lesen oder Lesen und Schreiben. Die Verwaltung tut das für Mitarbeiter. Schreiben ist erst möglich, wenn der Inhaber die aktuellen Nutzungsbedingungen angenommen hat.
Eine eigene Anwendung verbindet sich genauso: über OAuth, mit dem Zugang einer Person und deren Rechten.
Bereiche und Schreibmodus
Scopes sind Bereiche, Schreiben ist ein Modus: Jede Verbindung trägt nur Lese-Scopes (*.), und ob sie auch anlegen und ändern darf, sagt ihr Modus (mode in miphu_).
Ein Scope ist eine Obergrenze. Die Rechte der Person in miphu gelten zusätzlich.
| Scope | Bereich |
|---|---|
miphu.tasks.read | Aufgaben |
miphu.crm.read | Leads, Kunden & Kontakte, Angebote und Aufträge |
miphu.finance.read | Rechnungen und Ausgaben |
miphu.inventory.read | Artikel, Lager und Einkauf |
miphu.documents.read | Dokumente: Titel, Angaben und erkannter Text |
miphu.insights.read | Einblicke |
miphu.team.read | Team |
Dokumente wählt die Person beim Verbinden eigens aus, und nur, wenn das Unternehmen „KI-Verbindungen dürfen Dokumente lesen“ eingeschaltet hat. Die Dateien selbst gibt miphu nie heraus.
Werkzeuge
Nach dem Verbinden zeigt miphu der KI-App jedes Werkzeug, das ihr Scope und die Rechte der Person erlauben, mit einer kurzen Beschreibung in tools/. Welchen Bereich sie erreicht, bestimmt allein die Freigabe oben; schreibende Werkzeuge erscheinen nur im Modus „Lesen und Schreiben“.
Grenzen
Über die Schnittstelle geht nie: löschen oder archivieren, Angebote und Rechnungen ausstellen oder versenden, Aufträge bestätigen, Zahlungen erfassen, Bestellungen auslösen, Wareneingänge und Lagerbewegungen buchen, Lieferscheine versenden, Zugänge, Rechte, Bank- und Steuerangaben ändern und Daten exportieren. Das bleibt in der App.
Aufträge legt die Schnittstelle nur als Entwurf an. Bestätigt wird ein Auftrag in der App, erst dann reserviert miphu die Ware. Für Engpässe nennt die Antwort je Artikelzeile die heute verfügbare Menge (available).
Über einer Grenze antwortet miphu mit HTTP 429, Retry- und error. mcp_.
Beispiele
Typische Aufgaben, die eine KI-App über die Schnittstelle löst.
- 01
Netto-Umsatz je Kunde im zweiten Quartal, die zehn größten
Ein Aufruf mit dem Zeitraum, gruppiert nach Kunde. Die Summe über alle Kunden ist der Umsatz, den die Einblicke für denselben Zeitraum zeigen.
- 02
Eine Bestellung aus dem Webshop als Auftrag anlegen
Erst prüfen, ob es den Kunden schon gibt, dann Kunde und Ansprechpartner anlegen und den Auftrag als Entwurf mit den Artikelnummern des Shops, Liefertermin und Lieferanschrift. Bestätigt wird er in der App.
- 03
Artikel mit Preis und Bestand mit der Liste des Shops abgleichen
Beide Listen seitenweise lesen und nach Artikelnummer vergleichen. Ein Set hat keinen eigenen Bestand.
- 04
Zu jeder überfälligen Rechnung eine Aufgabe für die Buchhaltung
Die offenen Posten tragen den Kunden. Vor dem Anlegen prüfen, ob es zum Kunden schon eine offene Aufgabe gibt.
- 05
Artikel auf oder unter dem Meldebestand, mit Bestellvorschlag
Die Vorschläge nennen Menge und Lieferant. Daraus entstehen auf Wunsch Bestellentwürfe, bestellt wird in der App.