---
title: MCP für Agenten
description: "Verbinde einen Agenten wie Claude per MCP mit frwrd.to, mit deinem Workspace-Schlüssel, und sieh, welche Tools er bekommt."
theme: { accent: "#1f6feb", background: light }
translations: { en: help-mcp }
---

# 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.

- [Zurück zur Hilfe](/@frwrd.to/de/hilfe)