StableOps Agent Payments MCP Server

中文文档

Ein stdio-Model-Context-Protocol-Server (MCP), der es Agenten ermöglicht, StableOps Agent Payments zu konfigurieren und auszuführen, während private Schlüssel, Seed-Phrasen, KMS-Anmeldedaten und Genehmigungsbefugnis unter Benutzerkontrolle bleiben.

Installation und Ausführung

Node.js 20 oder höher ist erforderlich.

Geben Sie bei der Einrichtung nur den Verwaltungsschlüssel an:

STABLEOPS_API_KEY=sk_sandbox_... \
STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true \
STABLEOPS_AGENT_KEY_OUTPUT_FILE=/protected/absolute/path/stableops-agent-key \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

Der Verwaltungsmodus ist standardmäßig schreibgeschützt. Verändernde Tools werden nur mit STABLEOPS_AP_ENABLE_MANAGEMENT_WRITES=true registriert; der Verwaltungsprozess legt niemals Open-World-Erkennung oder Zahlungsausführung offen. Das einmalige Agent-Key-Geheimnis wird niemals an das Modell zurückgegeben. Der Server reserviert das Ziel mit 0600-Berechtigungen vor der Ausstellung und widerruft automatisch einen neu ausgestellten Schlüssel, wenn die Speicherung fehlschlägt.

Das Wallet-Kopplungs-Tool gibt nur die genaue Nachricht zurück, die der Benutzer signieren muss. Kein Tool akzeptiert einen privaten Schlüssel, eine Seed-Phrase oder eine KMS-Anmeldedaten. Der Benutzer signiert in seiner eigenen Wallet und gibt nur die Signatur zurück.

Für den täglichen Laufzeitbetrieb entfernen Sie den Verwaltungsschlüssel und verwenden einen eingeschränkten Agent Key sowie den vom Benutzer betriebenen Signer-Sidecar:

STABLEOPS_AGENT_KEY=ak_sandbox_... \
STABLEOPS_SIDECAR_URL=http://127.0.0.1:8789 \
STABLEOPS_SIDECAR_TOKEN=... \
npx -y -p @stableops/agent-payments-mcp-server@0.2.0 stableops-agent-payments-mcp

Verwaltungs- und Laufzeitmodus schließen sich gegenseitig aus. Der Server verweigert den Start, wenn sowohl STABLEOPS_API_KEY als auch STABLEOPS_AGENT_KEY gesetzt sind. Der Laufzeitmodus legt nur Erkennungs-, Budget-, Vorschau-, kontrollierte Kauf- und Zahlungsabgleich-Tools offen; er kann keine Richtlinien ändern oder seine eigene Zahlung genehmigen.

Related MCP server: BotWallet MCP Server

Sicherheitsmodell

• Der Server akzeptiert oder speichert niemals private Wallet-Schlüssel, Seed-Phrasen oder KMS-Anmeldedaten.

• Der Benutzer muss Wallet-Eigentumsnachweise außerhalb des Servers signieren.

• Laufzeitzahlungen können nur den vom Benutzer betriebenen eingeschränkten Signer-Sidecar aufrufen, niemals einen beliebigen Signier-Endpunkt.

• Unbekannte Ursprünge, unbekannte Empfänger und Zahlungen über dem Schwellenwert erfordern eine menschliche Genehmigung in StableOps.

• Jeder neue Kauf erfordert einen stabilen idempotency_key; unsichere Abrechnungen müssen mit der ursprünglichen Absicht abgeglichen werden.

• Jeder Kauf muss einen preview_token verwenden, der an die exakte URL, das maximale Angebot und den Prüfungskontext gebunden ist; das Kauf-Tool akzeptiert keine Ersatz-URL.

• Preview-Tokens sind prozesslokal. Nach einem MCP-Neustart müssen Sie die ursprüngliche exakte URL erneut in der Vorschau anzeigen und mit dem neuen Token fortfahren; die API überprüft den auf der Absicht gespeicherten vollständigen URL-Hash.

• Antworten über 256 KiB sind als kurzlebige MCP-Ressourcen verfügbar; alle Inline-Zusammenfassungen sind als nicht vertrauenswürdige externe Inhalte gekennzeichnet.

Dokumentation

Die vollständige Anleitung finden Sie unter https://stableops.dev/en/docs/agent-payments/quickstart

Lizenz

Apache-2.0