Linkly MCP Server

Der Linkly MCP Server ermöglicht es Ihnen, KI-Assistenten mit Ihrem Linkly-Konto mithilfe des Model Context Protocol zu verbinden. Nach der Verbindung können Sie Short Links 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:

Wo finden Sie es

Der Linkly MCP Server wird in den wichtigsten MCP-Verzeichnissen aufgelistet, sodass Sie ihn überall dort installieren können, wo Sie normalerweise nach Connectoren suchen:

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 eine bessere Wahl als der MCP-Server. Coding-Agents kennen sich bereits mit Command-Line-Tools aus, und die CLI bietet ihnen --json-Ausgabe für jeden Befehl sowie einen linkly schema-Befehl, der den gesamten Befehlsbaum ausgibt, damit der Agent alles entdecken kann, was er tun kann. Der MCP-Server bleibt die bessere Wahl für Assistenten, die Shell-Befehle nicht ausführen können, wie Claude Desktop und ChatGPT Desktop.

Was Sie tun können

Nach der Verbindung können Sie Ihren KI-Assistenten bitten zu:

  • Short Links erstellen - „Erstelle einen Short Link 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"
  • Analytics anzeigen - „Zeige mir Klicks nach Land für die letzten 30 Tage"
  • Links durchsuchen - „Finde alle Links, die sich auf den Produktstart beziehen"
  • Domains verwalten - „Liste meine benutzerdefinierten Domains auf"
  • Webhooks einrichten - „Abonniere https://my-site.com/webhook, um Click-Events 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 zum Kopieren – der Server verwendet OAuth, sodass beim ersten Verbinden 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

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

https://mcp.linklyhq.com

Klicken Sie auf Hinzufügen und dann auf Verbinden beim Linkly-Connector. Ein Browsertab wird geöffnet, damit Sie sich anmelden und den Zugriff genehmigen können. Claude Desktop bleibt dann verbunden – keine Konfigurationsdatei oder zusätzliche Tools erforderlich.

Claude Code (CLI)

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

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

Führen Sie dann /mcp in Claude Code aus, wählen Sie linkly, und genehmigen Sie die Authentifizierung 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 Short Link 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 Click-Daten ab
get_analyticsRufen Sie zeitreihenbasierte Click-Daten für Diagramme ab
get_analytics_byRufen Sie Klicks gruppiert nach Land, Browser, Plattform, etc. ab
list_domainsListen Sie Ihre benutzerdefinierten Domains auf
list_webhooksListen Sie Workspace-Webhook-Abonnements auf
subscribe_webhookAbonnieren Sie eine URL, um Click-Events zu erhalten

Beim Erstellen von Links können Sie 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
  • Verfallszeit: expiry_datetime, expiry_destination
  • Ihre eigenen Daten: metadata, Schlüssel-Wert-Paare wie IDs aus Ihrem System. Diese werden mit dem Link zurückgegeben und in Webhook-Payloads eingebunden. Siehe Link-Metadaten

Fehlerbehebung

„Konnte keine Verbindung zum MCP-Server herstellen"

  • Bestätigen Sie, dass https://mcp.linklyhq.com von Ihrem Computer 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 fragt immer wieder zur Anmeldung auf

Dies bedeutet, dass Ihr Client eine veraltete Verbindungsregistrierung speichert. Löschen Sie die zwischengespeicherten Anmeldedaten und authentifizieren Sie sich erneut. Führen Sie in Claude Code /mcp → linkly → erneut verbinden aus. Entfernen Sie in Claude Desktop den Linkly-Connector unter Einstellungen → Connectoren und fügen Sie ihn erneut 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
  • Überprüfen Sie, ob der MCP-Server ausgeführt wird (prüfen 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 einmalig im Browser an und Ihr KI-Assistent bleibt verbunden. Es gibt keine Software, die Sie auf Ihrem Computer installieren müssen, außer dem KI-Assistenten selbst.

Benötige ich einen API-Schlüssel?

Nein. Der MCP-Server verwendet OAuth – Sie melden sich bei Linkly über Ihren Browser an, wenn sich Ihr KI-Assistent zum ersten Mal verbindet, und es gibt keinen API-Schlüssel zum Kopieren oder Einfügen.

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 auch MCP-Unterstützung.

Ist mein Konto sicher?

Ja. Der gehostete Server verwendet OAuth 2.1 mit PKCE – Ihr Linkly-Passwort wird nur auf app.linklyhq.com eingegeben, und Ihr KI-Assistent sieht nur ein Zugriffs-Token, das auf Ihren Workspace beschränkt ist. Das KI-Modell selbst sieht Ihre Anmeldedaten niemals.

Respektiert der MCP Server meine Rolle im Workspace?

Ja. Ihr KI-Assistent kann alles tun, was Ihre Rolle erlaubt und nichts mehr. Wenn Sie die Rolle „Lesen“ haben, kann es Links und Analytics nachschlagen, aber nichts erstellen, bearbeiten oder löschen.

Kann ich MCP mit den Web-Versionen von Claude oder ChatGPT verwenden?

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

Wie aktualisiere ich den MCP-Server?

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

Tarifverfügbarkeit

Verfügbar ab Pro

Tarife vergleichen →

Verfolgen Sie 500 monatliche Klicks kostenlos.