Linkly Link Shortener

Linkly MCP Server

Der Linkly MCP Server ermöglicht es Ihnen, KI-Assistenten über das Model Context Protocol mit Ihrem Linkly-Konto zu verbinden. Einmal verbunden, können Sie Kurzlinks durch natürliche Konversation erstellen und verwalten.

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Assistenten ermöglicht, sich sicher mit externen Tools und Datenquellen zu verbinden. Anstatt zwischen Apps zu kopieren und einzufügen, können Sie Ihren KI-Assistenten bitten, Aktionen direkt auszuführen.

Unterstützte KI-Assistenten

Der Linkly MCP Server funktioniert mit:

• Claude Desktop
• ChatGPT Desktop
• Anderen MCP-kompatiblen Clients (Cursor, Windsurf, etc.)

MCP-Server oder die Linkly CLI?

Wenn Ihr KI-Assistent ein Coding-Agent ist, der Shell-Befehle ausführen kann – wie Claude Code oder Cursor – ist die Linkly CLI oft besser geeignet als der MCP-Server. Coding-Agenten sind bereits mit der Bedienung von Kommandozeilen-Tools vertraut, und die CLI liefert ihnen bei jedem Befehl eine --json-Ausgabe sowie einen linkly schema-Befehl, der den gesamten Befehlsbaum ausgibt, sodass der Agent alles entdecken kann, was er tun kann. Der MCP-Server bleibt die bessere Wahl für Assistenten, die keine Shell-Befehle ausführen können, wie Claude Desktop und ChatGPT Desktop.

Was Sie tun können

Einmal verbunden, können Sie Ihren KI-Assistenten bitten:

• Kurzlinks erstellen - "Erstelle einen Kurzlink für https://example.com"
• Leistung verfolgen - "Wie viele Klicks haben meine Links diese Woche erhalten?"
• Links verwalten - "Aktualisiere den Link namens 'promo' mit einem neuen Ziel"
• Analysen anzeigen - "Zeige mir Klicks nach Land für die letzten 30 Tage"
• Links suchen - "Finde alle Links, die mit der Produkteinführung zusammenhängen"
• Domains verwalten - "Liste meine benutzerdefinierten Domains auf"
• Webhooks einrichten - "Abonniere https://my-site.com/webhook, um Klick-Ereignisse zu erhalten"

Erste Schritte

Der gehostete Linkly MCP Server befindet sich unter https://mcp.linklyhq.com. Es gibt nichts zu installieren und keinen API-Schlüssel zu kopieren – der Server verwendet OAuth, sodass beim ersten Verbinden Ihres KI-Assistenten ein Browserfenster geöffnet wird, in dem Sie aufgefordert werden, sich bei Linkly anzumelden und den Zugriff zu genehmigen. Danach bleibt Ihr Assistent verbunden.

https://mcp.linklyhq.com

Konfiguration

Claude Desktop

Gehen Sie in Claude Desktop zu Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen. Geben Sie einen Namen (Linkly) und die Remote-MCP-Server-URL ein:

Click **Add**, then **Connect** on the Linkly connector. A browser tab opens for you to sign in and approve access. Claude Desktop then stays connected — no config file or extra tooling needed.

### Claude code (CLI)

Claude Code supports remote MCP servers natively. Add Linkly with one command:

claude mcp add --transport http linkly https://mcp.linklyhq.com

Then run `/mcp` inside Claude Code, pick **linkly**, and authorize in the browser when prompted.

### ChatGPT desktop

Open your ChatGPT config file:

* **macOS:** `~/Library/Application Support/ChatGPT/mcp_servers.json`
* **Windows:** `%APPDATA%\ChatGPT\mcp_servers.json`

Add the Linkly MCP server:

{ "servers": { "linkly": { "type": "url", "url": "https://mcp.linklyhq.com" } } }

## Verfügbare Tools

| Tool               | Beschreibung                                                                    |
| ------------------ | ------------------------------------------------------------------------------- |
| create_link       | Erstellt einen neuen Kurzlink mit optionalen UTM-Parametern, Pixeln und mehr    |
| update_link       | Aktualisiert die Einstellungen eines bestehenden Links                          |
| delete_link       | Löscht einen Link                                                               |
| get_link          | Ruft Details eines bestimmten Links ab                                          |
| list_links        | Listet alle Links in Ihrem Workspace auf                                        |
| search_links      | Sucht Links nach Name, URL oder Notiz                                           |
| get_clicks        | Ruft aktuelle Klickdaten ab                                                     |
| get_analytics     | Ruft Zeitreihen-Klickdaten für Diagramme ab                                     |
| get_analytics_by | Ruft Klicks gruppiert nach Land, Browser, Plattform usw. ab                     |
| list_domains      | Listet Ihre benutzerdefinierten Domains auf                                     |
| list_webhooks     | Listet Workspace-Webhook-Abonnements auf                                        |
| subscribe_webhook | Abonniert eine URL, um Klick-Ereignisse zu empfangen                            |

## Optionen zur Linkerstellung

Beim Erstellen von Links können Sie Folgendes angeben:

* **Basis:** `url`, `name`, `note`, `domain`, `slug`, `enabled`
* **UTM-Parameter:** `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`
* **Open Graph:** `og_title`, `og_description`, `og_image`
* **Tracking:** `fb_pixel_id`, `ga4_tag_id`, `gtm_id`
* **Erweitert:** `cloaking`, `forward_params`, `block_bots`, `hide_referrer`
* **Ablauf:** `expiry_datetime`, `expiry_destination`

## Fehlerbehebung

### "Verbindung zum MCP-Server konnte nicht hergestellt werden"

* Bestätigen Sie, dass `https://mcp.linklyhq.com` von Ihrem Rechner aus erreichbar ist
* Führen Sie in Claude Code `/mcp` aus und wählen Sie **linkly**, um den OAuth-Fluss erneut auszulösen

### "Authentifizierung fehlgeschlagen", "invalid_client" oder Browser fordert ständig zur Anmeldung auf

Dies bedeutet, dass Ihr Client eine veraltete Verbindungsregistrierung hält. Löschen Sie die zwischengespeicherten Anmeldeinformationen und autorisieren Sie erneut. Führen Sie in Claude Code `/mcp` → **linkly** → Verbindung wiederherstellen aus. Entfernen Sie in Claude Desktop den Linkly-Connector unter **Einstellungen → Connectors** und fügen Sie ihn wieder hinzu, dann melden Sie sich erneut an.

### Tools werden nicht angezeigt

* Starten Sie Ihren KI-Assistenten nach dem Speichern der Konfiguration neu
* Überprüfen Sie, ob die JSON-Syntax in Ihrer Konfigurationsdatei gültig ist
* Stellen Sie sicher, dass der MCP-Server läuft (achten Sie auf das Tools-Symbol in Ihrem Assistenten)

## Verwandte Ressourcen

* Claude Desktop Integration
* ChatGPT Integration
* Linkly API-Dokumentation
* Linkly CLI
* Webhooks
* Model Context Protocol

### Testen Sie Linklys kostenlosen URL-Shortener

Erhalten Sie 100 Kurzlinks und 500 monatliche Klicks kostenlos. Keine Kreditkarte.

Holen Sie sich Ihren Link kostenlos

500 getrackte Klicks/MonatBenutzerdefinierte DomainsKeine Kreditkarte erforderlich

## MCP-Server FAQs

### Muss ich etwas installieren, um den MCP-Server zu nutzen?

Nein. Der gehostete Server unter https://mcp.linklyhq.com verwendet OAuth – Sie melden sich einmal im Browser an und Ihr KI-Assistent bleibt verbunden. Es muss keine Software auf Ihrem Rechner installiert werden, außer Ihrem KI-Assistenten selbst.

### Benötige ich einen API-Schlüssel?

Nein. Der MCP-Server verwendet OAuth – Sie melden sich beim ersten Verbinden Ihres KI-Assistenten über Ihren Browser bei Linkly an, und es muss nirgendwo ein API-Schlüssel kopiert oder eingefügt werden.

### Welche KI-Assistenten unterstützen MCP?

Claude Desktop, Claude Code (CLI) und ChatGPT Desktop unterstützen alle MCP. Andere Tools wie Cursor und Windsurf haben ebenfalls MCP-Unterstützung.

### Ist mein Konto sicher?

Ja. Der gehostete Server verwendet OAuth 2.1 mit PKCE – Ihr Linkly-Passwort wird ausschließlich auf app.linklyhq.com eingegeben, und Ihr KI-Assistent sieht nur ein Zugriffstoken, das auf Ihren Workspace beschränkt ist. Das KI-Modell selbst sieht Ihre Anmeldeinformationen nie.

### Kann ich MCP mit den Webversionen von Claude oder ChatGPT verwenden?

Nein, MCP erfordert die Desktop-Anwendungen oder die Claude Code CLI. Die Webversionen unterstützen keine MCP-Verbindungen.

### Wie aktualisiere ich den MCP-Server?

Es gibt nichts zu aktualisieren – wir stellen Verbesserungen kontinuierlich auf dem gehosteten Server bereit und jeder verbundene Client erhält sie automatisch.

Plan-Verfügbarkeit

Verfügbar in Pro und höher

Pläne vergleichen →

KostenlosStarterProBusinessEnterprise

Erhalten Sie 100 Kurzlinks und verfolgen Sie 500 monatliche Klicks kostenlos.

Kostenlos starten

Keine Kreditkarte erforderlich

Hohes Volumen? Sprechen Sie mit unserem Team