Für Entwickler

API und MCP-Server

Erstellen und verwalten Sie Kurzlinks direkt aus dem Code heraus — über die REST-API oder über den MCP-Server in Ihrem KI-Assistenten.

cutty verfügt über eine öffentliche API und einen MCP-Server. Die erste ermöglicht das Erstellen und Ändern von Links direkt im Code, der zweite direkt über einen KI-Assistenten, der das MCP-Protokoll nutzt. Beide verwenden denselben API-Schlüssel.

API-Schlüssel

Jeden Aufruf authentifizieren Sie mit folgendem Header:

Authorization: Bearer ck_Ihr_Schlüssel

Woher man den Schlüssel bekommt: Melden Sie sich an, gehen Sie zum Dashboard → API-Schlüssel → Schlüssel erstellen. Der vollständige Schlüssel (beginnt mit ck_) wird nur einmal bei der Erstellung angezeigt — speichern Sie ihn sofort an einem sicheren Ort. Das Limit liegt bei 120 Anfragen pro Minute pro Schlüssel.

Basis-URL

Alle REST-Endpoints befinden sich unter https://cutty.dev/api/v1. Anfragen und Antworten erfolgen im JSON-Format.

Link erstellen

POST /api/v1/links — Im JSON-Body geben Sie mindestens die url an. Der Rest ist optional:

url — Zieladresse (erforderlich)
slug — Eigene Endung, 3–40 Zeichen; wenn weggelassen = zufällig
expiresAt — Ablaufdatum im ISO 8601-Format
maxHits — Klicklimit (1–1.000.000)
password — Passwort zum Schutz des Links
utmSource, utmMedium, utmCampaign — UTM-Parameter, die bei der Weiterleitung angehängt werden

In der Antwort erhalten Sie slug, shortUrl und target.

curl -X POST https://cutty.dev/api/v1/links \
  -H "Authorization: Bearer ck_Ihr_Schlüssel" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://beispiel.de/sehr/lange/adresse","slug":"angebot"}'

Liste und einzelner Link

GET /api/v1/links gibt alle Ihre Links zurück. GET /api/v1/links/{slug} — Details zu einem einzelnen Link.

curl https://cutty.dev/api/v1/links/angebot \
  -H "Authorization: Bearer ck_Ihr_Schlüssel"

Ändern und Löschen

PATCH /api/<0xC2>1/links/{slug} aktualisiert ausgewählte Felder (z. B. targetUrl, expiresAt, maxHits, status, password). DELETE /api/v1/links/{slug} löscht den Link.

curl -X PATCH https://cutty.dev/api/v1/links/angebot \
  -H "Authorization: Bearer ck_Ihr_Schlüssel" \
  -H "Content-Type: application/json" \
  -d '{"maxHits":500}'

MCP-Server

Wenn Sie mit einem KI-Assistenten arbeiten, können Sie cutty über MCP (Model Context Protocol) anbinden und ihn bitten, Links direkt im Chat zu kürzen und zu organisieren. Der Server ist unter https://mcp.cutty.dev/mcp via Streamable HTTP erreichbar, und die Authentifizierung erfolgt mit demselben API-Schlüssel über den Header Authorization: Bearer ck_....

Verfügbare Tools: create_link, list_links, get_link, update_link, delete_link sowie qr_link (QR-Code für den Link).

Beispiel für einen Eintrag in der MCP-Client-Konfiguration:

{
  "mcpServers": {
    "cutty": {
      "url": "https://mcp.cutty.dev/mcp",
      "headers": {
        "Authorization": "Bearer ck_Ihr_Schlüssel"
      }
    }
  }
}

Etwas funktioniert nicht?

Schreiben Sie an [email protected] — ich antworte noch am selben Tag.