Linkly MCP Server

Der Linkly MCP Server ermöglicht es Ihnen, KI-Assistenten mit Ihrem Linkly-Konto zu verbinden, indem Sie das Model Context Protocol verwenden. Nach der Verbindung können Sie Kurz-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.)

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 vertraut mit der Verwendung von Befehlszeilenwerkzeugen, und die CLI bietet ihnen --json-Ausgabe bei jedem Befehl sowie einen linkly schema-Befehl, der den vollständigen 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, folgendes zu tun:

• Kurz-Links erstellen - "Erstelle einen Kurz-Link für https://example.com"
• Leistung verfolgen - "Wie viele Klicks haben meine Links diese Woche erhalten?"
• Links verwalten - "Aktualisiere den Link 'promo' mit einem neuen Ziel"
• Analysen anzeigen - "Zeige mir die Klicks nach Land der letzten 30 Tage"
• Links suchen - "Finde alle Links zum Produktstart"
• Domains verwalten - "Liste meine benutzerdefinierten Domains auf"
• Webhooks einrichten - "Abonniere https://my-site.com/webhook, um Klick-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, daher öffnet sich beim ersten Verbinden Ihres KI-Assistenten ein Browser-Fenster, in dem Sie sich bei Linkly anmelden und den Zugriff genehmigen können. 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 Mal, wenn Sie ein Linkly-Tool verwenden, öffnet sich ein Browser-Tab, damit Sie sich anmelden und den Zugriff genehmigen können.

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 authentifizieren Sie sich 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 zum Erstellen von Links

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

"Konnte nicht zum MCP-Server verbinden"

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

"Authentifizierung fehlgeschlagen" / Browser fragt immer wieder, sich anzumelden

Löschen Sie die zwischengespeicherten MCP-Anmeldedaten Ihres Clients und autorisieren Sie erneut. Führen Sie in Claude Code /mcp → linkly → erneut verbinden aus. Beenden Sie in Claude Desktop die App, löschen Sie das zwischengespeicherte mcp-remote-Token in ~/.mcp-auth/ und starten Sie es 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 ausgeführt wird (suchen Sie nach dem Tools-Symbol in Ihrem Assistenten)

Verwandte Ressourcen

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