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 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 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 daran gewöhnt, Befehlszeilenwerkzeuge zu bedienen, und die CLI bietet ihnen --json-Ausgabe für jeden Befehl plus einen linkly schema-Befehl, der den gesamten Befehlsbaum ausdruckt, sodass der Agent alles entdecken kann, das 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, folgende Aufgaben auszuführen:

• 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 namens 'promo' mit einem neuen Ziel"
• Analytics anzeigen - "Zeige mir Klicks nach Land für die letzten 30 Tage"
• Links suchen - "Finde alle Links, die mit dem Produktlaunch verbunden sind"
• 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 sich beim ersten Verbinden Ihres KI-Assistenten ein Browserfenster ö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

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

https://mcp.linklyhq.com

Klicken Sie auf Hinzufügen und dann auf Verbinden beim Linkly-Konnektor. Ein Browserfenster öffnet sich, damit Sie sich anmelden und den Zugriff genehmigen können. Claude Desktop bleibt dann verbunden – keine Konfigurationsdatei oder zusätzliches Werkzeug 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 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

Beim Erstellen von Links können Sie folgende Angaben machen:

• Grundlagen: 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-Fluss erneut auszulösen

"Authentication failed", "invalid_client" oder Browser fordert ständig zur Anmeldung auf

Das bedeutet, dass Ihr Client eine veraltete Verbindungsregistrierung hält. Löschen Sie die zwischengespeicherten Anmeldedaten und autorisieren Sie erneut. Führen Sie in Claude Code /mcp → linkly → erneut verbinden aus. Entfernen Sie in Claude Desktop den Linkly-Konnektor unter Einstellungen → Konnektoren und fügen Sie ihn erneut hinzu, melden Sie sich dann 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 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