Linkly MCP Server

Mit dem Linkly MCP Server können Sie KI-Assistenten über das Model Context Protocol mit Ihrem Linkly-Konto verbinden. Nach der Verbindung können Sie Kurzlinks 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 daran gewöhnt, Command-Line-Tools zu verwenden, und die CLI bietet ihnen --json-Ausgabe bei jedem Befehl sowie einen linkly schema-Befehl, der den vollständigen Befehlsbaum ausgibt, sodass 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, folgende Aufgaben auszuführen:

• Kurzlinks erstellen - "Erstellen Sie einen Kurzlink für https://example.com"
• Leistung verfolgen - "Wie viele Klicks haben meine Links diese Woche erhalten?"
• Links verwalten - "Aktualisieren Sie den Link namens 'promo' mit einem neuen Ziel"
• Analysen ansehen - "Zeigen Sie mir Klicks nach Land für die letzten 30 Tage"
• Links suchen - "Finden Sie alle Links, die sich auf den Produktlaunch beziehen"
• Domains verwalten - "Listen Sie meine benutzerdefinierten Domains auf"
• Webhooks einrichten - "Abonnieren Sie https://my-site.com/webhook um Click-Events zu empfangen"

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 Verbindungsversuch Ihres KI-Assistenten ein Browserfenster geöffnet wird, 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

Ö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, um sich anzumelden und den Zugriff zu genehmigen.

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:

• 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 aus erreichbar ist
• Wenn Ihr Client mcp-remote verwendet, stellen Sie sicher, dass Node.js v18 oder höher installiert ist
• In Claude Code führen Sie /mcp aus und wählen Sie linkly um den OAuth-Flow neu zu starten

"Authentication failed" / Browser fragt ständig nach der Anmeldung

Löschen Sie die zwischengespeicherten MCP-Anmeldeinformationen Ihres Clients und autorisieren Sie sich neu. 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 das Programm neu.

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