Die CoinsSend-API-Dokumentation ist jetzt für KI-Agenten optimiert

KI-Coding-Assistenten können eine Integration nur dann beschleunigen, wenn sie mit präzisen und aktuellen Quellen arbeiten. Wir haben die öffentliche CoinsSend-API-Dokumentation neu aufgebaut, damit Entwickler und kompatible Coding-Agenten denselben geprüften Vertrag, dieselben Beispiele und dieselben Sicherheitshinweise nutzen können.

Das Release vereint einen öffentlichen, schreibgeschützten MCP-Server, ein kanonisches OpenAPI-3.1-Dokument, einen LLM-freundlichen Dokumentationsindex, Testvektoren für Request-Signaturen und stärkere automatisierte Prüfungen. Dadurch lassen sich die API schneller erkunden und Integrationslösungen vorbereiten, während Zugangsdaten und Zahlungsvorgänge unter der Kontrolle des Entwicklers bleiben.

Eine geprüfte Quelle für Entwickler und Agenten

Die neue Dokumentationsschicht stellt jedem Tool das Format bereit, mit dem es am besten arbeiten kann:

• MCP für Coding-Agenten. Ein kompatibler Client kann die öffentliche Dokumentation durchsuchen, eine bestimmte Seite abrufen, eine OpenAPI-Operation untersuchen oder ein Komponentenschema laden.
• OpenAPI 3.1 für Tools. Der öffentliche Vertrag eignet sich für Codegenerierung, Validierung, API-Erkundung und Integrationstests.
• llms.txt und ein Dokumentationsmanifest. Agenten ohne MCP-Unterstützung können die kanonischen öffentlichen Seiten finden, ohne nicht relevante Inhalte durchsuchen zu müssen.
• Ausführbare Testvektoren für Signaturen. Teams können kanonisches JSON, ältere MD5-Signaturen und zeitgestempelte HMAC-Signaturen für Auszahlungen anhand veröffentlichter Fixtures überprüfen.
• Serverseitige Beispiele und abgesicherte Prompts. Die Dokumentation enthält Beispiele für PHP, JavaScript/Node.js und Python sowie Prompts für Checkout-, Webhook- und Production-Hardening-Aufgaben.

Der OpenAPI-Vertrag deckt bewusst eine geprüfte Auswahl öffentlicher Operationen ab, anstatt interne Anwendungsrouten offenzulegen. Diese Abgrenzung sorgt dafür, dass die maschinenlesbare Oberfläche nützlich und überprüfbar bleibt.

Einen Coding-Agenten in wenigen Minuten verbinden

Der Remote-Dokumentationsserver ist unter https://api.coinssend.com/v1/docs/mcp erreichbar. Codex-Nutzer können ihn beispielsweise mit folgendem Befehl hinzufügen:

codex mcp add coinssend-docs --url https://api.coinssend.com/v1/docs/mcp

Für diese Verbindung ist kein CoinsSend-API-Schlüssel erforderlich, da der Server ausschließlich öffentliche Dokumentation bereitstellt. Andere kompatible MCP-Clients können denselben Endpunkt gemäß ihrem jeweiligen Verbindungsablauf verwenden. Die vollständigen Einrichtungshinweise finden Sie im MCP-Leitfaden.

Wobei ein Agent helfen kann

Nachdem der Dokumentationsserver verbunden wurde, kann ein Coding-Agent:

1. nach dem passenden Ablauf suchen, etwa für Rechnungen, statische Wallets, Webhooks, Auszahlungen, Gebühren, Guthaben oder Coin-Kurse;
2. die exakte öffentliche Dokumentationsseite abrufen, anstatt sich auf eine breit angelegte Websuche zu verlassen;
3. eine Operation anhand ihrer operationId nachschlagen und die zugehörigen Request-, Response-, Authentifizierungs- und Fehlerschemas prüfen;
4. mit den veröffentlichten Signatur-Fixtures die Signaturimplementierung der Anwendung testen;
5. serverseitigen Integrationscode und Tests entwerfen, die anschließend von einem Entwickler geprüft und ausgeführt werden.

Wenn Sie vor der Implementierung zwischen verschiedenen Zahlungsmodellen wählen, erläutert unser Leitfaden zu statischen Wallets und Rechnungen die produktspezifischen Abwägungen. Die für Agenten optimierte Dokumentation liefert anschließend den exakten API-Vertrag für den gewählten Weg.

Eine klare Sicherheitsgrenze

Der MCP-Server ist schreibgeschützt. Er kann weder eine Rechnung erstellen noch eine Wallet generieren, eine Auszahlung veranlassen, auf ein Händlerkonto zugreifen oder Händlerzugangsdaten empfangen. Seine Tools sind auf einen geprüften öffentlichen Dokumentationsbestand beschränkt und als nicht destruktiv sowie idempotent ausgelegt.

Integrationscode gehört weiterhin auf einen vertrauenswürdigen Server. Bewahren Sie Händlerschlüssel in geschützten Umgebungsvariablen oder einem Secret Manager auf, signieren Sie Requests serverseitig, prüfen Sie Webhook-Signaturen anhand des unveränderten Request-Bodys und kontrollieren Sie generierten Code vor der Ausführung. Schreibende Requests müssen dem dokumentierten Retry-Verhalten folgen und dürfen niemals blind wiederholt werden.

OpenAPI, Testvektoren und direkter Zugriff

Dieselben Quellen stehen auch ohne MCP zur Verfügung:

• OpenAPI-3.1-Vertrag für maschinenlesbare Operationen und Schemas;
• llms.txt als kompakter, agentenorientierter Index;
• Dokumentationsmanifest für den kanonischen öffentlichen Bestand;
• Signatur-Testvektoren für interoperable Signaturprüfungen;
• Prompts zur KI-Integration für strukturierte Implementierungs- und Review-Aufgaben.

Ein Team kann damit einen MCP-fähigen Agenten verwenden, OpenAPI in seine bestehende Toolchain importieren oder direkt mit der Dokumentation arbeiten und behält dabei stets dieselbe verlässliche Quelle.

Prüfungen halten den Vertrag synchron

Änderungen an der Dokumentation durchlaufen jetzt automatisierte Konsistenzprüfungen, OpenAPI-Linting, die Erkennung inkompatibler Änderungen sowie Runtime-Vertragstests, die die veröffentlichte Spezifikation mit den tatsächlichen öffentlichen Routen, Controllern und der Middleware vergleichen. Separate Tests decken den MCP-Server, den Dokumentationsbestand, Request-Signaturen und die verwaltete Synchronisierung mit dem OpenAI Vector Store ab, die der CoinsSend-Dokumentationsassistent nutzt.

Der Synchronisierungsablauf stellt einen neuen öffentlichen Bestand bereit und verifiziert ihn, bevor die vorherigen verwalteten Dateien außer Betrieb genommen werden. Sperren, Paginierung, Zeitlimits, Eigentumsprüfungen und Bereinigung verringern das Risiko, einen unvollständigen oder unbeabsichtigten Bestand zu veröffentlichen.

Mit dem Ablauf beginnen, dann die Details prüfen

Öffnen Sie den Leitfaden für den Einstieg, verbinden Sie den Dokumentationsserver, sofern Ihr Coding-Agent MCP unterstützt, und beschreiben Sie den Zahlungsablauf, den Sie umsetzen möchten. Bitten Sie den Agenten, die genaue Dokumentationsseite, OpenAPI-Operation und das verwendete Schema anzugeben. Prüfen Sie anschließend das Ergebnis, führen Sie die Signatur-Fixtures und Tests aus und validieren Sie die Integration in Ihrer eigenen Umgebung.

Dieses Release macht aus einer Zahlungsintegration keine ungeprüfte Ein-Klick-Aktion. Es bietet Entwicklern und ihren Tools einen schnelleren und zuverlässigeren Weg zum korrekten Vertrag, auf dessen Grundlage sie entwickeln können.