SHORTCLIX MCP – Benutzerhandbuch

SHORTCLIX nutzt MCP (Model Context Protocol), sodass KI-Assistenten wie Claude deine Kurzlinks verwalten und Klickstatistiken in einfacher Sprache auswerten können – „Verkürze diesen Link und verfolge ihn“, „Wie viele Klicks gab es letzte Woche?“, „Gib mir den QR-Code“.

In dieser Anleitung erfährst du, wie du einen MCP-Client verbindest. Informationen zur einfachen REST-API findest du unter /docs/api.

Verfügbarkeit: MCP ist Teil der Tarife „Basic“ und „Pro“ (nicht „Free“). Jedes Token gehört zu einem Arbeitsbereich, und es gelten alle Tarifbeschränkungen dieses Arbeitsbereichs.

• Endpunkt (Produktion): https://shortclix.com/mcp
• Übertragung: HTTP (streamfähig), Bearer-Token-Authentifizierung
• Dieselben Tokens wie bei der REST-API – erstellt unter „Workspace-Einstellungen“ → „API-Tokens“

Inhaltsverzeichnis

1. Hol dir ein Token
2. Mit Claude verbinden
   • Claude-Code (CLI)
   • Claude Desktop
   • Andere MCP-Kunden
3. Was du fragen kannst
4. Verfügbare Tools
5. Erst lokal testen, dann live gehen
6. Sicherheit & Grenzen
7. Fehlerbehebung

1. Hol dir ein Token

1. Öffne dein Dashboard, wechsle zu dem Arbeitsbereich, den du freigeben möchtest, und gehe zu „Arbeitsbereichseinstellungen“.
2. In API-Token, erstelle ein Token:
   • Lesen & Schreiben – ermöglicht es dem Assistenten, Links zu erstellen, zu aktualisieren und zu löschen (empfohlen für das volle Erlebnis).
   • Nur-Lese-Zugriff – Der Assistent kann lediglich Links auflisten und Analysedaten einsehen.
3. Kopiere das gesamte Token (einschließlich des führenden 2| — es ist Teil des Tokens) — es wird einmal angezeigt.

Auf der Seite „Arbeitsbereichseinstellungen“ werden außerdem dein MCP-Endpunkt und ein Konfigurationsausschnitt angezeigt, den du direkt einfügen kannst.

2. Verbinde Claude

Claude-Code (CLI)

Die einfachste Option – Claude Code unterstützt HTTP-MCP-Server mit benutzerdefinierten Headern von Haus aus:

claude mcp add --transport http shortclix https://shortclix.com/mcp \
  --header "Authorization: Bearer DEIN_TOKEN_HIER"

Bitte dann in einer Claude-Code-Sitzung darum, SHORTCLIX zu verwenden. Verwalte es mit claude mcp-Liste / claude mcp shortclix entfernen.

Claude Desktop

Claude Desktop stellt über die mcp-remote Brücke. Bearbeite deine claude_desktop_config.json (Einstellungen → Entwickler → Konfiguration bearbeiten):

{
  "mcpServers": {
    "shortclix": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://shortclix.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Starte Claude Desktop neu. „shortclix“ wird als verbundenes Tool angezeigt. (Node.js muss installiert sein.)

Andere MCP-Kunden

Jeder Client, der HTTP-MCP-Server mit benutzerdefinierten Headern funktioniert. Richte es auf https://shortclix.com/mcp und sende Autorisierung: Inhaber YOUR_TOKEN_HERE. Allgemeine Konfiguration:

{
  "mcpServers": {
    "shortclix": {
      "type": "http",
      "url": "https://shortclix.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN_HERE" }
    }
  }
}

3. Was du fragen kannst

Sobald die Verbindung hergestellt ist, sprich ganz normal mit dem Assistenten. Beispiele:

• „Verkürze https://example.com/my-very-long-campaign-url im Projekt ‚Marketing‘ und schick mir den Kurzlink und den QR-Code.“
• „Liste alle Kurzlinks im Marketing-Projekt auf.“
• „Wie viele Klicks hat der Link q3-promo „Zwischen dem 1. Mai und dem 7. Juni?“
• „Welche Länder und Geräte klicken q3-promo „am meisten?“
• "Den Link deaktivieren altes Angebot." (erfordert ein Lese- und Schreib-Token)
• „Erstelle ein neues Projekt namens ‚Sommer-Sale‘.“

Der Assistent entscheidet, welchen Dienst er anruft, und leitet deine Daten weiter.

4. Verfügbare Tools

Alles ist auf den Arbeitsbereich des Tokens beschränkt und unterliegt den Projekt- und Link-Beschränkungen deines Tarifs.

5. Erst lokal testen, dann live schalten

Du kannst einen Client auf deine lokal SHORTCLIX (Laravel Herd, https://shortclix.test/mcp) bevor du die Produktionsumgebung nutzt.

Lokal (shortclix.test):

claude mcp add --transport http shortclix-local https://shortclix.test/mcp \
  --header "Authorization: Bearer LOCAL_TOKEN_HERE"

• Erstelle die LOCAL_TOKEN_HERE in deinem lokal Dashboard (Token werden in der Datenbank der jeweiligen Umgebung gespeichert – ein lokales Token tut nicht an der Produktion arbeiten und umgekehrt).
• Falls dein Client das lokale TLS-Zertifikat ablehnt (die lokale Zertifizierungsstelle von Herd wird von Node nicht als vertrauenswürdig eingestuft), füge dem Befehl vor NODE_TLS_REJECT_UNAUTHORIZED=0 nur für lokale Tests — niemals für die Produktion.

Umstellung auf die Produktionsumgebung (shortclix.com): Im Code muss nichts gelöscht oder geändert werden – es ist derselbe Server. Nur auf der Client-Seite:

1. Erstelle ein Neues Token in der Produktion Dashboard (shortclix.com).
2. Ändere die URL von https://shortclix.test/mcp zu https://shortclix.com/mcp und verwende das Produktions-Token.
3. Lass alles NODE_TLS_REJECT_UNAUTHORIZED=0 (Die Produktion verfügt über ein gültiges Zertifikat).

Z. B. den lokalen Eintrag entfernen und den Produktionseintrag hinzufügen:

claude mcp remove shortclix-local
claude mcp add --transport http shortclix https://shortclix.com/mcp \
  --header "Authorization: Bearer PRODUCTION_TOKEN_HERE"

6. Sicherheit & Grenzen

• Ein Token sieht immer nur einen Arbeitsbereich. Es hat keinen Zugriff auf andere Arbeitsbereiche, auch nicht auf solche, die dir gehören.
• Schreibgeschützte Tokens können nichts erstellen, ändern oder löschen – gib dem Assistenten ein schreibgeschütztes Token, wenn du nur Analysedaten haben möchtest.
• Es gelten die Beschränkungen deines Tarifs: Wenn du beispielsweise mehr Links erstellst, als dein Tarif zulässt, wird eine Fehlermeldung ausgegeben, die der Assistent anzeigt.
• Token werden einmal angezeigt und in gehashter Form gespeichert – sollte eines in falsche Hände geraten, widerrufe es in den Workspace-Einstellungen und erstelle ein neues. Anfragen sind ratebegrenzt (60 pro Minute pro Token).

7. Fehlerbehebung

Fragen? Wende dich an den Support unter hello@shortclix.com.