Transaktions-Tools geben eine einmalige HTTPS-Bestätigungsseite zurück. Das Backend bereitet die Anfrage vor und validiert sie; du prüfst sie und signierst über deine Wallet.
Der Bestätigungsablauf
- Der Agent fordert die exakte unterstützte Aktion an.
- Das Tool gibt eine
confirmationUrlund Informationen zum Vorgang zurück. - Öffne diese URL im Browser, prüfe die Aktion und verbinde bei Bedarf die gewünschte Wallet.
- Wähle In Wallet bestätigen und genehmige oder lehne dann in der üblichen Wallet-Oberfläche ab.
- Prüfe das Ergebnis des Vorgangs und die betroffene Ressource.
Der Agent sollte die zurückgegebene URL unverändert anzeigen. Ihr Geheimnis liegt im Fragment und darf weder in Logs kopiert noch in eine andere URL umgebaut werden. Intents laufen normalerweise nach fünf Minuten ab.
Was jeder Schritt belegt
| Schritt | Nachweis |
|---|---|
| Vorbereitet | Das Backend hat eine Anfrage erstellt; nichts wurde signiert |
| Genehmigung ausstehend | Der Nutzer muss noch genehmigen oder ablehnen |
| Übermittelt | Eine Wallet-Übermittlung wurde beobachtet; der endgültige Zustand kann noch ausstehen |
| Verifiziertes Ergebnis | Die relevante Vorgangs-/Ressourcenabfrage beobachtet den erwarteten Zustand |
Abgelaufene oder unklare Ergebnisse
Wenn ein Intent vor der Übermittlung abläuft, prüfe den aktuellen Zustand, bevor du einen neuen vorbereitest. Wiederhole die Transaktion bei unklarer Übermittlung nicht automatisch. Eine ältere Genehmigung könnte noch ausgeführt werden.
Das Erneuern oder Widerrufen des MCP-Zugriffs kann eine vorbereitete Bestätigung ungültig machen. Prüfe die gewünschte Aktion und Ressource erneut, bevor du eine neue URL anforderst.
Die richtige Ressource erneut lesen
Nutze domains.records für einen eigenen Stammnamen und subdomains.get_item für einen eigenen untergeordneten Namen. Nutze für Websites sites.list_releases und sites.list_domains. Bewahre bei Storage die vom Ablauf zurückgegebene Anbieter-Vorgangskennung auf; sie ist nicht mit einer generischen MCP-Vorgangs-ID austauschbar.
NFT-Übertragungen
| Vermögenswert | Tool |
|---|---|
Stammname .ton oder .t.me | dns.send_transfer_tx mit domain und newOwner |
| Untergeordnetes NFT | subdomains.transfer_item_tx mit itemAddress und newOwner |
Nach einer Übertragung geben nur für Eigentümer zugängliche Tools das NFT möglicherweise nicht mehr zurück. Nutze bei einem .ton-Stammnamen dns.lookup, um den neuen Eigentümer zu prüfen. Prüfe bei einem Username oder untergeordneten Namen mit der empfangenden Wallet oder einer geeigneten Blockchain-Abfrage.