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 Short 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 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 Agents sind bereits vertraut mit der Bedienung von Befehlszeilentools, und die CLI bietet ihnen --json-Ausgabe für jeden Befehl sowie einen linkly schema-Befehl, der den vollständigen Befehlsbaum anzeigt, 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 bekommen?"
• 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 im Zusammenhang mit dem Produktstart"
• 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 Ihres KI-Assistenten ein Browserfenster geöffnet wird, in dem Sie sich bei Linkly anmelden und 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. Wenn Sie das erste Mal ein Linkly-Tool verwenden, öffnet sich eine Browser-Registerkarte, damit Sie sich anmelden und 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 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 Folgendes 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

"Konnte keine Verbindung zum MCP Server herstellen"

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

"Authentifizierung fehlgeschlagen" / Browser fragt immer wieder zum Anmelden

Löschen Sie die zwischengespeicherten MCP-Anmeldedaten Ihres Clients und autorisieren Sie erneut. In Claude Code führen Sie /mcp → linkly → erneut verbinden aus. In Claude Desktop beenden Sie die App, löschen das zwischengespeicherte mcp-remote-Token in ~/.mcp-auth/ und starten 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 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