MCP für Agenten
MCP, das Model Context Protocol, ist ein Standard, der einem KI-Agenten Werkzeuge zum Aufrufen gibt. frwrd.to bietet für alles, was die API kann, ein Tool, damit ein Agent in deinem Workspace Links anlegen, Seiten schreiben und Zahlen lesen kann.
Der Endpunkt ist https://api.frwrd.to/mcp. Er spricht Streamable HTTP und
nimmt deinen Workspace-Schlüssel als Bearer-Token:
Authorization: Bearer fw_...
Ein Agent sieht nur den Workspace, zu dem sein Schlüssel gehört.
Claude Code
claude mcp add --transport http frwrd https://api.frwrd.to/mcp --header "Authorization: Bearer fw_..."
Prüfe die Verbindung mit claude mcp list. Halte den Schlüssel aus Dateien
heraus, die du eincheckst: Wenn du eine .mcp.json teilst, schreib den Header
als Bearer ${FRWRD_KEY} und setze FRWRD_KEY in deiner Umgebung.
Andere MCP-Clients
Füge einen Remote-Server mit dem Transport Streamable HTTP hinzu (manche
Clients nennen ihn "http"), mit der URL https://api.frwrd.to/mcp und dem
Header Authorization: Bearer fw_.... Clients, die nur stdio sprechen,
erreichen ihn über eine Brücke wie mcp-remote.
Die Tools
Workspace:
get_workspace: der Workspace, seine Grenzen und der DNS-Eintrag, der die Domain bestätigt.verify_workspace: prüft den DNS-Eintrag jetzt und hebt die Grenzen auf.claim_handle: sichert ein kurzes Handle, damit Seiten unter/@handleliegen.set_utm: setzt die UTM-Vorgaben, die an jeden Link, den du anlegst oder neu ausrichtest, und an die Links auf deinen Seiten angehängt werden.set_default_language: wählt die Sprache, die unter schlichten Seitenadressen liegt.list_domains,add_domain,remove_domain: eigene Seiten-Domains.delete_workspace: löscht den Workspace; es brauchtconfirm, die Domain des Workspace, und ein Agent sollte es nur aufrufen, wenn du genau das verlangt hast. Einen Workspace zu löschen stoppt seinen Schlüssel und nimmt seine Seiten sofort offline; nach 7 Tagen werden die Seiten und Einstellungen gelöscht. Kurzlinks funktionieren weiter. Wer die Domain innerhalb von 7 Tagen erneut nachweist (Rückholung des Schlüssels), bekommt alles zurück; bis zu 60 Tage danach die Links. Nach 60 Tagen ist die Domain frei und die Links funktionieren ohne Besitzer weiter. Browser können Kopien einer Seite, ihres QR-Codes und der Bilder bis zu einer Stunde nach dem Löschen behalten.
Links:
create_link: ein Kurzlink für eine http- oder https-Adresse.list_links,get_link: deine Links lesen.update_link: Ziel, Titel oder Tags ändern oder einen Link archivieren und wiederherstellen.archive_link: ein Link leitet nicht mehr weiter, seine Zahlen bleiben.get_link_stats: Klicks in einem Zeitfenster, nach Kanal und nach Tag;range(1d,7d,30d) liefert zusätzlich jeden Stunden- oder Tagesblock und die Summen seit dem ersten Klick.get_workspace_stats: die Zahlen aller deiner Links auf einmal: die Klicks in einemrange(1d,7d,30d; Standard7d) als Blöcke mit den Summen, die Summe seit dem ersten Klick (null, wenn sie gerade nicht gezählt werden konnte) und die zehn meistgeklickten Links. Die Antwort wird zwischengespeichert und kann bis zu 5 Minuten alt sein; ist der Server ausgelastet, antwortet er mitrate_limited, versuche es dann in ein paar Sekunden noch einmal.get_qr: der QR-Code des Links als SVG.
Seiten:
list_pages: deine Seiten, mit Sprache und Übersetzungen.get_page: eine Seite als Markdown, mit ihrer Version und dem Kurzlink hinter jedem Link.write_page: eine ganze Seite anlegen oder ersetzen.delete_page: eine Seite entfernen.get_page_stats: Aufrufe einer Seite und Klicks auf jeden Link;rangefunktioniert wie oben.list_page_versions: der Speicherverlauf.
Jede Seite ist auch eine Ressource, frwrd://pages/{path}, mit - für die
Startseite. Fehler der Tools tragen dieselben Codes wie die REST-API.