Linkly MCP Server

Der Linkly MCP Server ermöglicht es Ihnen, KI-Assistenten mit Ihrem Linkly-Konto über das Model Context Protocol zu verbinden. Einmal verbunden, 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:

Was Sie tun können

Einmal verbunden, können Sie Ihren KI-Assistenten bitten:

  • Kurzlinks erstellen - "Erstelle einen Kurzlink für https://example.com"
  • Performance verfolgen - "Wie viele Klicks haben meine Links diese Woche bekommen?"
  • 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 zur Produkteinführung"
  • Domains verwalten - "Liste meine benutzerdefinierten Domains auf"
  • Webhooks einrichten - "Abonniere https://my-site.com/webhook für den Empfang von Klick-Events"

Installationsoptionen

Der Linkly MCP Server ist auf zwei Arten verfügbar:

Option 1: Gehosteter Server (Empfohlen)

Verwenden Sie unseren gehosteten MCP-Server - keine Installation erforderlich:

https://mcp.linklyhq.com

Option 2: npm-Paket

Lokal installieren und ausführen mit npx:

npx -y linkly-mcp-server

Oder global installieren:

npm install -g linkly-mcp-server

Sehen Sie sich das Paket auf npm an.

Konfiguration

API-Zugangsdaten abrufen

  1. 1Melden Sie sich in Ihrem Linkly-Dashboard an
  2. 2Gehen Sie zu Einstellungen → API-Schlüssel
  3. 3Kopieren Sie Ihren API-Schlüssel und Ihre Workspace-ID

Claude Desktop Konfiguration

Ö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", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

ChatGPT Desktop Konfiguration

Ö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:

Mit npx:

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

Mit gehostetem Server:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

Verfügbare Tools

ToolBeschreibung
create_linkErstellen Sie einen neuen Kurzlink mit optionalen UTM-Parametern, Pixeln und mehr
update_linkAktualisieren Sie die Einstellungen eines vorhandenen Links
delete_linkLöschen Sie einen Link
get_linkRufen Sie Details eines bestimmten Links ab
list_linksListen Sie alle Links in Ihrem Workspace auf
search_linksSuchen Sie Links nach Name, URL oder Notiz
get_clicksRufen Sie aktuelle Klickdaten ab
get_analyticsRufen Sie Zeitreihen-Klickdaten für Diagramme ab
get_analytics_byRufen Sie Klicks gruppiert nach Land, Browser, Plattform usw. ab
list_domainsListen Sie Ihre benutzerdefinierten Domains auf
list_webhooksListen Sie Workspace-Webhook-Abonnements auf
subscribe_webhookAbonnieren Sie eine URL für den Empfang von Klick-Events

Link-Erstellungsoptionen

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

Umgebungsvariablen

VariableErforderlichBeschreibung
LINKLY_API_KEYJaIhr Linkly API-Schlüssel
LINKLY_WORKSPACE_IDNeinIhre Workspace-ID (einige Clients benötigen diese)

Fehlerbehebung

"Could not connect to MCP server"

  • Überprüfen Sie, ob Ihr API-Schlüssel und Ihre Workspace-ID korrekt sind
  • Stellen Sie sicher, dass Node.js installiert ist (v18 oder neuer)
  • Versuchen Sie, npx linkly-mcp-server in einem Terminal auszuführen, um Fehler zu sehen

"Authentication failed"

  • Überprüfen Sie Ihren API-Schlüssel im Linkly-Dashboard unter Einstellungen → API-Schlüssel
  • Stellen Sie sicher, dass keine zusätzlichen Leerzeichen in Ihren Zugangsdaten vorhanden sind
  • Versuchen Sie, Ihren API-Schlüssel neu zu generieren

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 läuft (achten Sie auf das Tools-Symbol in Ihrem Assistenten)

Server nicht erreichbar

  • Bestätigen Sie, dass der Befehlspfad korrekt ist
  • Wenn Sie den gehosteten Server verwenden, überprüfen Sie Ihre Internetverbindung
  • Überprüfen Sie, ob der MCP-Server manuell vom Terminal aus läuft

Verwandte Ressourcen

MCP Server FAQs

Muss ich etwas installieren, um den MCP-Server zu verwenden?

Nicht, wenn Sie den gehosteten Server unter https://mcp.linklyhq.com verwenden. Wenn Sie es vorziehen, lokal zu arbeiten, benötigen Sie Node.js v18 oder neuer.

Welche KI-Assistenten unterstützen MCP?

Claude Desktop und ChatGPT Desktop unterstützen beide MCP. Andere Tools wie Cursor und Windsurf haben ebenfalls MCP-Unterstützung.

Ist mein API-Schlüssel sicher?

Ja. Ihr API-Schlüssel wird lokal in der Konfigurationsdatei Ihres KI-Assistenten gespeichert und wird nur an die Server von Linkly gesendet, wenn API-Anfragen gestellt werden. Er wird niemals mit dem KI-Modell selbst geteilt.

Kann ich MCP mit den Webversionen von Claude oder ChatGPT verwenden?

Nein, MCP erfordert die Desktop-Anwendungen. Die Webversionen unterstützen keine MCP-Verbindungen.

Wie aktualisiere ich den MCP-Server?

Wenn Sie npx verwenden, wird automatisch jedes Mal die neueste Version abgerufen. Bei globaler Installation führen Sie npm update -g linkly-mcp-server aus.

Verfolge 500 monatliche Klicks mit allen Funktionen inbegriffen.

Keine Kreditkarte erforderlich