Linkly MCP Server

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

Was Sie tun können

Sobald die Verbindung hergestellt ist, können Sie Ihren KI-Assistenten bitten:

  • Kurz-Links erstellen - "Erstelle einen Kurz-Link für https://example.com"
  • Leistung verfolgen - "Wie viele Klicks haben meine Links diese Woche bekommen?"
  • Links verwalten - "Aktualisiere den Link mit dem Namen '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, um Klick-Events zu erhalten"

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

Installieren und lokal 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 erhalten

  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 Kurz-Link 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, um Klick-Events zu erhalten

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 dies)

Fehlerbehebung

"Verbindung zum MCP-Server konnte nicht hergestellt werden"

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

"Authentifizierung fehlgeschlagen"

  • Überprüfen Sie Ihren API-Schlüssel im Linkly-Dashboard unter Einstellungen → API-Schlüssel
  • Stellen Sie sicher, dass sich keine zusätzlichen Leerzeichen in Ihren Zugangsdaten befinden
  • 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 (prüfen 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 auszuführen, benötigen Sie Node.js v18 oder höher installiert.

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?

Bei Verwendung von npx wird automatisch die neueste Version abgerufen. Bei globaler Installation führen Sie npm update -g linkly-mcp-server aus.

Track 1000 monthly clicks with all features included.

No credit card required