ALPNAI / FIELD NOTES / 14.09.2026
MCP-Agenten mit Budget und wiederholbaren Käufen integrieren
Der ALPNAI-Pilotvertrag: autorisierter Zugriff, fiktives Budget, Idempotenzschlüssel und dauerhaft gespeicherte Belege vor einer kommerziellen Anbindung verstehen.
Mit einem Testzugang beginnen
Die Anmeldung zum Piloten verwendet die ChatGPT-Anmeldung und eine ausdrückliche Zustimmung. Ein angemeldetes Konto erhält einen Testschlüssel und ein Gesamtbudget von 1 fiktiven USDC. Der Schlüssel wird bei der Ausstellung angezeigt und als Hash gespeichert. Ein Schlüsselwechsel erstellt kein neues Budget. Damit bleiben der Austausch von Zugangsdaten und die Genehmigung weiterer Ausgaben klar voneinander getrennt.
Vor dem Kauf die Sammlung prüfen
Der MCP-Endpunkt lautet /mcp. Die Werkzeuge get_catalog und get_free_sample liefern Katalog und datierte Sammlung ohne Budgetbelastung. purchase_snapshot, purchase_changes und purchase_evidence verwenden dieselben Berechtigungs- und Budgetprüfungen wie REST. Übermitteln Sie den Schlüssel mit Authorization: Bearer. Der MCP-Server erzwingt den Sandbox-Modus. Ein Kauf kann in dieser Version daher weder echte Mittel freigeben noch eine tatsächliche Überweisung auslösen.
Die Kaufkennung bei Wiederholungen beibehalten
Jeder MCP-Kauf benötigt idempotency_key mit 8 bis 100 Buchstaben, Ziffern, Bindestrichen oder Unterstrichen. Verwenden Sie nach einer unterbrochenen Anfrage denselben Wert und dieselben Parameter. Der Server liefert den vorhandenen Beleg ohne weitere fiktive Belastung. Derselbe Wert mit anderen Parametern führt zu einem Konflikt. Für Change Set nimmt since ein gültiges Datum im Format YYYY-MM-DD entgegen und filtert die bestehende Sammlung.
Belege und Ablehnungen auswerten
Der Beleg weist den Sandbox-Modus, settled: false und null echten Umsatz aus. Ihr Client muss unbekannte oder widerrufene Schlüssel, unzureichendes Budget und ungültige Datumsangaben behandeln. Kommerzielle REST-Aufrufe bleiben bis zur Zahlungsaktivierung gesperrt. Lokale MCP- und Anmeldetests waren erfolgreich. Diese Ergebnisse belegen jedoch weder eine öffentliche Verfügbarkeit noch eine produktive Zahlungsabwicklung. Testbelege bleiben von einer künftigen Buchhaltung getrennt.
Quellen
ALPNAI — Contrat OpenAPI du pilote
Model Context Protocol — Publishing Remote Servers