Linkly MCP Server

Der Linkly MCP Server ermöglicht es Ihnen, KI-Assistenten mit Ihrem Linkly-Konto über das Model Context Protocol 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:

Was Sie tun können

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

  • Kurzlinks erstellen - "Erstelle einen Kurzlink für https://example.com"
  • Performance verfolgen - "Wie viele Klicks haben meine Links diese Woche bekommen?"
  • Links verwalten - "Aktualisiere den Link namens 'promo' mit einem neuen Ziel"
  • Analytics anzeigen - "Zeige mir Klicks nach Land für die letzten 30 Tage"
  • Links suchen - "Finde alle Links zur Produkteinführung"
  • Domains verwalten - "Liste meine benutzerdefinierten Domains auf"
  • Webhooks einrichten - "Abonniere https://my-site.com/webhook für den Empfang von Klick-Events"

Erste Schritte

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

https://mcp.linklyhq.com

Konfiguration

Claude Desktop

Öffnen Sie Ihre Claude Desktop Konfigurationsdatei:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie den Linkly MCP-Server hinzu:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Starten Sie Claude Desktop neu. Beim ersten Einsatz eines Linkly-Tools öffnet sich ein Browser-Tab, in dem Sie sich anmelden und den Zugriff genehmigen.

Claude Code (CLI)

Claude Code unterstützt Remote-MCP-Server nativ. Fügen Sie Linkly mit einem einzigen Befehl hinzu:

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

Führen Sie anschließend in Claude Code /mcp aus, wählen Sie linkly und autorisieren Sie den Zugriff im Browser, wenn Sie dazu aufgefordert werden.

ChatGPT Desktop

Öffnen Sie Ihre ChatGPT Konfigurationsdatei:

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

Fügen Sie den Linkly MCP-Server hinzu:

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

Verfügbare Tools

ToolBeschreibung
create_linkErstellen Sie einen neuen Kurzlink mit optionalen UTM-Parametern, Pixeln und mehr
update_linkAktualisieren Sie die Einstellungen eines vorhandenen Links
delete_linkLöschen Sie einen Link
get_linkRufen Sie Details eines bestimmten Links ab
list_linksListen Sie alle Links in Ihrem Workspace auf
search_linksSuchen Sie Links nach Name, URL oder Notiz
get_clicksRufen Sie aktuelle Klickdaten ab
get_analyticsRufen Sie Zeitreihen-Klickdaten für Diagramme ab
get_analytics_byRufen Sie Klicks gruppiert nach Land, Browser, Plattform usw. ab
list_domainsListen Sie Ihre benutzerdefinierten Domains auf
list_webhooksListen Sie Workspace-Webhook-Abonnements auf
subscribe_webhookAbonnieren Sie eine URL für den Empfang von Klick-Events

Beim Erstellen von Links können Sie Folgendes angeben:

  • Grundlegend: 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

"Could not connect to MCP server"

  • Bestätigen Sie, dass https://mcp.linklyhq.com von Ihrem Rechner aus erreichbar ist
  • Wenn Ihr Client mcp-remote verwendet, stellen Sie sicher, dass Node.js v18 oder neuer installiert ist
  • Führen Sie in Claude Code /mcp aus und wählen Sie linkly, um den OAuth-Ablauf erneut auszulösen

"Authentication failed" / Browser fragt immer wieder nach der Anmeldung

Löschen Sie die zwischengespeicherten MCP-Zugangsdaten Ihres Clients und autorisieren Sie erneut. Führen Sie in Claude Code /mcplinkly → Erneut verbinden aus. Beenden Sie in Claude Desktop die App, löschen Sie das zwischengespeicherte mcp-remote-Token in ~/.mcp-auth/ und starten Sie dann neu.

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
  • Überprüfen Sie, ob der MCP-Server läuft (achten Sie auf das Tools-Symbol in Ihrem Assistenten)

Verwandte Ressourcen

MCP Server FAQs

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

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

Benötige ich einen API-Schlüssel?

Nein. Der MCP-Server verwendet OAuth - Sie melden sich beim ersten Verbindungsaufbau Ihres KI-Assistenten über Ihren Browser bei Linkly an, und es gibt keinen API-Schlüssel, den Sie irgendwo kopieren oder einfügen müssen.

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 lediglich ein Zugriffstoken, das auf Ihren Workspace beschränkt ist. Das KI-Modell selbst sieht Ihre Zugangsdaten niemals.

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 kontinuierlich Verbesserungen am gehosteten Server bereit, und alle verbundenen Clients erhalten sie automatisch.

Verfolgen Sie 500 monatliche Klicks mit allen Funktionen inbegriffen.

Keine Kreditkarte erforderlich