Linkly MCP Server

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

• Claude Desktop
• ChatGPT Desktop
• Andere MCP-kompatible Clients (Cursor, Windsurf, etc.)

Wo Sie ihn finden

Der Linkly MCP Server ist in den wichtigsten MCP-Verzeichnissen aufgelistet, sodass Sie ihn von überall dort installieren können, wo Sie bereits nach Konnektoren suchen:

• Claude Connector-Verzeichnis — One-Click-Verbindung in Claude (Web und Desktop)
• Offizielles MCP-Verzeichnis — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — das Linkly-Plugin für Claude Code und Cowork
• Source auf GitHub — MIT lizenziert

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 Command-Line-Tools vertraut, und die CLI bietet ihnen --json-Ausgabe für jeden Befehl sowie einen linkly schema-Befehl, der den kompletten Befehlsbaum ausgibt, damit 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

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

• 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"
• Analysen anzeigen - "Zeige mir Klicks nach Land für die letzten 30 Tage"
• Links suchen - "Finde alle Links zum Produktstart"
• Domains verwalten - "Zeige meine benutzerdefinierten Domains"
• 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 des KI-Assistenten ein Browser-Fenster öffnet, 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 Settings → Connectors → Add custom connector. Geben Sie einen Namen (Linkly) und die Remote-MCP-Server-URL ein:

https://mcp.linklyhq.com

Klicken Sie auf Add, dann Connect am Linkly Connector. Ein Browser-Tab öffnet sich, 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 autorisieren Sie 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

Optionen zur Link-Erstellung

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
• Ablauf: expiry_datetime, expiry_destination

Fehlerbehebung

"Could not connect to MCP server"

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

"Authentication failed", "invalid_client" oder Browser fragt immer wieder zum Anmelden auf

Das 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 → reconnect aus. Entfernen Sie in Claude Desktop den Linkly Connector unter Settings → Connectors und fügen Sie ihn erneut hinzu, dann melden Sie sich erneut an.

Tools werden nicht angezeigt

• Starten Sie Ihren KI-Assistenten neu, nachdem Sie die Konfiguration gespeichert haben
• Überprüfen Sie, dass die JSON-Syntax in Ihrer Konfigurationsdatei gültig ist
• Überprüfen Sie, dass der MCP Server läuft (suchen Sie nach dem Tools-Symbol in Ihrem Assistenten)

Zugehörige Ressourcen

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