TRON-Ratgeber

llms.txt, .well-known und Agent Skills: Wie sich TronSave KI-Agenten vorstellt

Von TronSave Veröffentlicht 10 Min. Lesezeit
Auf dieser Seite

Aktualisiert: 7. November 2026. MCP- und OAuth-Details am Live-Server geprüft, Version 1.5.1.

Ein KI-Agent, der auf einer Website landet, hat dasselbe Problem wie ein neuer Entwickler: Was ist das hier, was kann ich aufrufen, und wie authentifiziere ich mich? 2026 gibt es einen kleinen Stapel konventioneller Dateien, die genau das beantworten – llms.txt, eine Handvoll /.well-known/-Deskriptoren und ein Agent-Skills-Manifest. TronSave veröffentlicht sie alle. Dieser Rundgang zeigt, was in jeder Datei steht, warum sie existiert und welche Regel keine dieser Dateien durchsetzen kann.

llms.txt: die lesbare Zusammenfassung

llms.txt liegt im Stammverzeichnis einer Website und leistet für Sprachmodelle, was eine gute README für Entwickler leistet: ein Absatz dazu, worum es geht, dann kuratierte Links mit je einem Satz Kontext. Es ist Markdown, kein Schema – und genau darum geht es: Die Datei soll gelesen, nicht geparst werden.

Die Datei von TronSave hat vier Abschnitte. Eine einzeilige Zusammenfassung des Produkts. Wichtige Seiten – Startseite, Markt, Tools, FAQ – jeweils mit einer Beschreibung dessen, was dort tatsächlich zu finden ist. Einen Block Entwickler & KI-Agenten mit Links zur API-Referenz, zum API-Katalog, zur MCP-Server-Card, zum Agent-Skills-Index und zum Auth-Dokument. Und Rechtliches: AGB, Datenschutz, Risikohinweis.

Die nützliche Disziplin dabei heißt Kuratieren. Eine Sitemap listet jede URL; llms.txt listet die zehn, die zählen, und sagt, warum. Braucht Ihre Datei einen Scrollbalken, erfüllt sie ihren Zweck nicht mehr.

Das Verzeichnis .well-known

Während llms.txt Fließtext ist, ist /.well-known/ maschinenlesbar. Fünf Dateien, jede beantwortet eine andere Frage:

Datei Standard Beantwortet
api-catalog RFC 9727 Welche APIs gibt es hier, und wo liegen ihre Beschreibungen?
oauth-protected-resource RFC 9728 Was ist die geschützte Ressource, und wie werden Zugangsdaten übergeben?
mcp/server-card.json MCP Wo ist der MCP-Server, welcher Transport, welche Authentifizierung?
agent-skills/index.json agentskills.io Welche fertigen Skills kann ein Agent laden?
security.txt RFC 9116 An wen wende ich mich bei einer Sicherheitslücke?

api-catalog – die Trennung zwischen Maschine und Mensch

RFC 9727 definiert ein Linkset: Jede API erhält einen Anker und danach Links, die sie beschreiben. TronSave veröffentlicht zwei Anker – die REST-API v2 und den MCP-Endpunkt – und jeder trägt sowohl ein service-desc als auch ein service-doc:

{
  "linkset": [
    {
      "anchor": "https://api.tronsave.io/v2",
      "service-desc": [ { "href": ".../api-reference.md",  "type": "text/markdown" } ],
      "service-doc":  [ { "href": ".../api-reference",     "type": "text/html"     } ]
    },
    {
      "anchor": "https://mcp.tronsave.io/mcp",
      "service-desc": [ { "href": ".../mcp/server-card.json", "type": "application/json" } ],
      "service-doc":  [ { "href": ".../api-reference/mcp",    "type": "text/html"        } ]
    }
  ]
}

Der Unterschied ist das Wertvolle daran. service-doc ist die HTML-Seite, die ein Mensch liest. service-desc ist die maschinenlesbare Beschreibung – hier Markdown für die REST-Referenz und JSON für die MCP-Card. Ein Agent folgt service-desc und überspringt das Marketing-Drumherum komplett.

oauth-protected-resource – zuerst API-Keys, OAuth für MCP

RFC 9728-Metadaten begleiten normalerweise ein OAuth-Deployment. Die REST-API von TronSave selbst hat keinen OAuth-Flow – ihre primären Zugangsdaten sind ein API-Key oder eine Wallet-Signatur –, trotzdem veröffentlicht tronsave.io den Deskriptor: Er nennt die Ressource, ihren Autorisierungsserver und die Scopes, verweist auf die Dokumentation und legt fest, dass Bearer-Zugangsdaten in einem Header übergeben werden; passende oauth-authorization-server-Metadaten liegen daneben. Ein Client, der nach diesen Dateien sucht, findet eine Antwort statt eines 404. Der MCP-Server geht weiter: Seit dem 7. November 2026 betreibt mcp.tronsave.io eine echte OAuth-Anmeldung für seinen Endpunkt https://mcp.tronsave.io/oauth/mcp, mit eigenen Protected-Resource-Metadaten und einem Autorisierungsserver (Authorization Code mit PKCE, Refresh-Tokens und ein Endpunkt zur Client-Registrierung). So verbinden sich Apps wie Claude und Cursor: Der Nutzer meldet sich auf einer TronSave-Seite mit einem API-Key oder einer Wallet-Signatur an, und die App ist ab dann authentifiziert.

auth.md – die ehrliche Antwort für Dienste ohne OAuth

Weil die REST-API keinen OAuth-Flow zum Entdecken hat, steht die eigentliche Authentifizierung in einer eigenständigen auth.md. Sie ist so konkret, dass sie einem Integrator wirklich Zeit spart:

  • Die REST-API erwartet Ihren Key in einem kleingeschriebenen apikey-Header.
  • Der MCP-Server erwartet ihn in einem authorization-Header mit dem Schema ApiKey.
  • Eine TRON-Wallet-Signatur ist der dritte Weg – und das Dokument stellt klar, dass Sie niemals einen Private Key senden, sondern nur die Signatur.

Die ersten beiden sind eine echte Falle: dieselben Zugangsdaten, zwei verschiedene Header, zwei verschiedene Schreibweisen, je nachdem, welche Schnittstelle Sie aufrufen. Das schriftlich festzuhalten, macht den Unterschied zwischen einer Integration in fünf Minuten und einem Nachmittag voller 401-Fehler.

Die Datei gibt auch zu, was es nicht gibt. Es existiert kein programmatischer OAuth-Endpunkt zur dynamischen Registrierung, über den man einen API-Key erhält (die separate OAuth-Anmeldung des MCP-Servers hat einen eigenen Registrierungsendpunkt für Client-Apps). Deshalb erklärt sie, wie ein Mensch an einen Key kommt – Wallet auf der Website verbinden oder den Telegram-Bot nutzen. Ein agent_auth-Block fasst dieselben Fakten anschließend strukturiert zusammen: Identitätstyp anonym, Credential-Typ api_key, dazu ein Link zur Registrierungsdokumentation.

Die MCP-Server-Card

Ein kompakter Deskriptor des TronSave MCP-Servers: Name und Version, Transport (http-streamable) mit Endpunkt und Methoden, ein Capabilities-Block, der tools, resources und prompts deklariert (jeweils mit listChanged), die zwei unterstützten Auth-Schemata mit exaktem Header-Format sowie Verweise auf einen Quickstart und die Dokumentation.

Auch die Fähigkeiten zu deklarieren, die Sie nicht haben, ist kein Füllstoff. Ein Agent, der weiß, dass es keine Resources oder Prompts gibt, hört auf, danach zu suchen.

Das Agent-Skills-Manifest

Die neueste Schicht. agent-skills/index.json folgt dem Discovery-Schema von agentskills.io und bietet einen Skill an, tronsave-api, vom Typ skill-md – ein Markdown-Dokument, das ein Agent als Arbeitsanweisung laden kann:

{
  "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
  "skills": [
    {
      "name": "tronsave-api",
      "type": "skill-md",
      "url": "https://tronsave.io/.well-known/agent-skills/tronsave-api/SKILL.md",
      "digest": "sha256:bc8a8647...9141b"
    }
  ]
}

Beachten Sie den digest. Das Manifest enthält einen SHA-256-Hash der Skill-Datei, sodass ein Client prüfen kann, ob er genau das abgerufen hat, was die Website veröffentlichen wollte. Skills sind Anweisungen, nach denen ein Agent handelt – deshalb lohnt sich eine Integritätsprüfung, wie sie eine Marketingseite nie braucht.

Die Regel, die kein Manifest durchsetzen kann

Jede der oben genannten Dateien ist eine Momentaufnahme. Der Dienst entwickelt sich weiter.

Ein konkretes Beispiel aus genau diesem Stack: Als dieser Beitrag im August 2026 erstmals geschrieben wurde, beschrieb das Skills-Manifest den MCP-Server mit 27 typisierten Tools, während das Live-tools/list 29 lieferte, und die Server-Card führte GET unter ihren Transportmethoden, obwohl GET deaktiviert war. Am 28. Oktober 2026 lieferte der Server (Version 1.2.0) 53 Tools, und die Server-Card war auf POST und DELETE korrigiert – doch der Quickstart unter mcp.tronsave.io/quickstart nannte noch 25 Tools. Am 7. November 2026 meldete der Live-Server Version 1.5.1, weiterhin mit 53 Tools, während die Server-Card noch 1.2.0 angab.

Nichts davon ist ein Fehler im Pfad des Agenten – es ist die normale Abweichung zwischen einem veröffentlichten Dokument und einem laufenden Dienst. Die Lehre gilt für jede Integration dieser Art: Nutzen Sie die Manifeste zum Entdecken und den Server als Quelle der Wahrheit. Ermitteln Sie die Fähigkeiten zur Laufzeit mit tools/list, statt eine Anzahl fest zu codieren, die Sie in einer Datei gelesen haben, und lassen Sie die Protokollversion im Handshake aushandeln, statt eine vorauszusetzen.

Was ein Agent mit Zugangsdaten tun sollte

Discovery endet bei der Authentifizierung, und das Sitzungsmodell verdient einen eigenen Absatz, weil hier echte Konsequenzen entstehen. Marktdaten und Angebote brauchen überhaupt keinen Login: Auf dem Live-Server (Version 1.5.1, geprüft am 7. November 2026) sind 18 der 53 Tools öffentlich, und jedes Tool deklariert seine Zugriffsstufe in _meta["io.tronsave/auth"]. Für alles andere erzeugt der Login einen von zwei Sitzungstypen mit unterschiedlicher Reichweite: Eine ApiKey-Sitzung ist auf Operationen des internen Kontos beschränkt, während eine Signatur-Sitzung an die Wallet gebunden ist und für Tools zur Nutzeridentität sowie die meisten Änderungen auf der Plattform erforderlich ist. Ein API-Key verschafft Ihnen nicht stillschweigend Zugriff auf Signatur-Ebene; er schlägt bei diesen Tools einfach fehl.

Der Login ist an die MCP-Verbindung gebunden, und die Sitzungs-ID wird im Transport-Header übertragen, niemals in Tool-Argumenten. Behandeln Sie sie als Geheimnis. Eine geleakte Sitzungs-ID erlaubt es jemandem, bis zum Ablauf mit den Rechten dieser Sitzung zu handeln – genau deshalb ist die engere ApiKey-Sitzung der richtige Standard für autonome Abläufe.

Wenn Sie das für Ihre eigene Website bauen

Der Stack ist klein genug, um ihn an einem Nachmittag auszuliefern:

  1. /llms.txt – ein zusammenfassender Absatz und kuratierte Links mit Kontext. Halten Sie sie kurz.
  2. /.well-known/api-catalog – ein Anker pro API, jeweils mit einer Maschinenbeschreibung und einer Doku für Menschen.
  3. /.well-known/oauth-protected-resource – veröffentlichen Sie sie unabhängig davon, ob Ihre Haupt-API OAuth nutzt.
  4. Ein Auth-Dokument – exakte Header-Namen und Schreibweise sowie der Weg, wie ein Mensch an Zugangsdaten kommt.
  5. Eine MCP-Server-Card, wenn Sie einen Server betreiben – mit den Fähigkeiten, die Ihnen fehlen, ebenso wie mit denen, die Sie haben.
  6. Ein Agent-Skills-Manifest mit Digest, wenn Sie Skills veröffentlichen.
  7. /.well-known/security.txt – mit einem Ablaufdatum, das Sie auch wirklich erneuern.

Bauen Sie dann eine Sache in Ihren Release-Prozess ein: Erzeugen Sie die Manifeste neu, wenn sich der Dienst ändert. Die Dateien sind schnell veröffentlicht und leicht vergessen.

FAQ

Ist llms.txt ein Standard?

Es ist eher eine weit verbreitete Konvention als ein IETF-Standard. Die /.well-known/-Dateien daneben – api-catalog, Protected-Resource-Metadaten, security.txt – sind echte RFCs.

Hilft die Veröffentlichung dieser Dateien bei SEO?

Nicht direkt. Sie helfen Agenten und Assistenten, Ihren Dienst korrekt zu nutzen, sobald sie da sind. Betrachten Sie sie als Integrationsdokumentation unter einer konventionellen Adresse, nicht als Rankingfaktor.

Sollte ich einen api-catalog veröffentlichen, wenn ich nur eine API habe?

Ja – der Wert liegt im vorhersehbaren Speicherort, nicht in der Anzahl der Einträge. Ein Anker mit einer maschinenlesbaren Beschreibung genügt.

Warum Protected-Resource-Metadaten ohne OAuth veröffentlichen?

Weil Clients ohnehin danach suchen. Mit der Ressourcenkennung und der Art der Übergabe von Zugangsdaten zu antworten, ist nützlicher als ein 404 – selbst wenn die Antwort für Ihre Haupt-API lautet: „Wir nutzen API-Keys, kein OAuth.“ TronSave macht beides: API-Key-Metadaten auf tronsave.io und eine vollständige OAuth-Anmeldung für seinen MCP-Endpunkt.

Wie bekomme ich einen TronSave API-Key?

Verbinden Sie eine TRON-Wallet auf der Website und melden Sie sich an, oder nutzen Sie den Bereich mit den Nutzerinfos im Telegram-Bot. Einen programmatischen Registrierungsendpunkt für API-Keys gibt es nicht – das Auth-Dokument sagt das offen, statt es Sie selbst herausfinden zu lassen. MCP-Apps, die sich über die OAuth-Anmeldung verbinden, überspringen diesen Schritt: Die Anmeldeseite fragt nach Ihrem Key oder einer Wallet-Signatur.

Wo fange ich an, wenn ich einfach nur die API nutzen will?

Die offiziellen SDKs kapseln sie in fünf Sprachen, und der Leitfaden zur API-Automatisierung behandelt die reinen Endpunkte. Discovery-Dateien sind für Agenten, die ihren Weg selbst finden müssen.

Fazit

Einen Dienst für einen KI-Agenten lesbar zu machen, ist weniger eine neue Disziplin als eine alte mit neuem Publikum: Sagen Sie, was Sie sind, listen Sie auf, was Sie anbieten, seien Sie bei Zugangsdaten exakt und geben Sie zu, was Sie nicht unterstützen. Die Dateien sind konventionell, der Aufwand ist gering. Echte Disziplin erfordert es, sie aktuell zu halten – denn ein Agent glaubt Ihrem Manifest genau bis zu dem Moment, in dem der Server ihm widerspricht.

TronSave betreibt diesen Blog und veröffentlicht die hier beschriebenen Discovery-Dateien. Dateiinhalte, Tool-Anzahlen und Protokollversionen geben wieder, was zum Zeitpunkt des Schreibens veröffentlicht war und was der Live-Server lieferte, und werden sich ändern – ermitteln Sie sie zur Laufzeit, statt sich auf die oben genannten Zahlen zu verlassen. Dies ist keine Finanzberatung.

TronSave
TronSave

Das TronSave-Team betreibt den Marktplatz für TRON-Energie und -Bandbreite auf tronsave.io und schreibt diese Ratgeber auf Basis eigener Tests im TRON-Mainnet.

Ähnliche Artikel

Wir nutzen Google Analytics, um zu sehen, welche Anleitungen unseren Leserinnen und Lesern helfen. Cookies werden nur gesetzt, wenn Sie die Analyse erlauben. Der Blog zeigt keine Werbung. Datenschutz