mcp für agenten
Verbinde einen Agenten wie Claude per MCP mit frwrd.to, mit deinem Workspace-Schlüssel, und sieh, welche Tools er bekommt.
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.
ChatGPT und claude.ai
Diese Apps können keinen Header senden, sie melden sich deshalb mit OAuth an. Schalte in ChatGPT den Entwicklermodus ein (Einstellungen, Apps, Erweitert), lege eine App mit der URL https://api.frwrd.to/mcp und OAuth als Authentifizierung an und verbinde sie. In claude.ai fügst du einen eigenen Connector mit derselben URL hinzu. Beide öffnen eine Seite von frwrd.to, die fragt, ob die App deinen Workspace nutzen darf: erlaube es, angemeldet oder mit deinem Schlüssel. Die App behält den Zugriff, bis du deinen Workspace-Schlüssel erneuerst. Eine so verbundene App kann die Wiederherstellungs-E-Mail nicht setzen oder entfernen, keine Domain beanspruchen und den Workspace nicht löschen: Dafür braucht es den Schlüssel. Unter Einstellungen, Konto, "Verbundene Apps" siehst du jede so verbundene App und entziehst ihr mit "Entziehen" den Zugriff (auch list_connected_apps und revoke_connected_app).
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.list_connected_apps,revoke_connected_app: die über OAuth verbundenen Apps; entziehen braucht den Schlüssel.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.
