Linkly MCP Server

Der Linkly MCP Server ermöglicht es Ihnen, KI-Assistenten über das Model Context Protocol mit Ihrem Linkly-Konto zu verbinden. 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 KI-Assistenten ermöglicht, sich sicher mit externen Tools und Datenquellen zu verbinden. Anstatt zwischen Anwendungen zu kopieren und einzufügen, können Sie Ihren KI-Assistenten direkt bitten, Aktionen durchzuführen.

Unterstützte KI-Assistenten

Der Linkly MCP Server funktioniert mit:

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

Was Sie tun können

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

• Kurz-Links erstellen - "Erstelle einen Kurz-Link für https://example.com"
• Performance 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 suchen - "Finde alle Links im Zusammenhang mit der Produkteinführung"
• 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 zum Installieren und keinen API-Schlüssel zum Kopieren – der Server verwendet OAuth, sodass sich beim ersten Verbindungsversuch Ihres KI-Assistenten ein Browser-Fenster öffnet, 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 eine Browser-Registerkarte, auf der 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 aus und autorisieren 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 zur Link-Erstellung

Bei der Erstellung von Links können Sie folgende Angaben machen:

• 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
• 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 aus, um den OAuth-Fluss erneut auszulösen

"Authentication failed" / Browser fragt immer wieder zur Anmeldung auf

Löschen Sie die zwischengespeicherten MCP-Anmeldedaten Ihres Clients und autorisieren Sie erneut. Führen Sie in Claude Code /mcp → linkly → erneute Verbindung aus. Beenden Sie die Anwendung in Claude Desktop, 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 neu, nachdem Sie die Konfiguration gespeichert haben
• Überprüfen Sie, ob die JSON-Syntax in Ihrer Konfigurationsdatei gültig ist
• Vergewissern Sie sich, dass der MCP-Server läuft (suchen Sie nach dem Tools-Symbol in Ihrem Assistenten)

Verwandte Ressourcen

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