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 /@handle liegen.
- set_utm: setzt die UTM-Vorgaben für die Links auf deinen Seiten.
- set_default_language: wählt die Sprache, die unter schlichten Seitenadressen liegt.
- list_domains, add_domain, remove_domain: eigene Seiten-Domains.
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.
- 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.
- 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.