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:
- Claude Desktop
- ChatGPT Desktop
- Anderen MCP-kompatiblen Clients (Cursor, Windsurf, etc.)
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/webhookfü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
- 1Melden Sie sich in Ihrem Linkly-Dashboard an
- 2Gehen Sie zu Einstellungen → API-Schlüssel
- 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
| Tool | Beschreibung |
|---|---|
create_link | Erstellen Sie einen neuen Kurzlink mit optionalen UTM-Parametern, Pixeln und mehr |
update_link | Aktualisieren Sie die Einstellungen eines vorhandenen Links |
delete_link | Löschen Sie einen Link |
get_link | Rufen Sie Details eines bestimmten Links ab |
list_links | Listen Sie alle Links in Ihrem Workspace auf |
search_links | Suchen Sie Links nach Name, URL oder Notiz |
get_clicks | Rufen Sie aktuelle Klickdaten ab |
get_analytics | Rufen Sie Zeitreihen-Klickdaten für Diagramme ab |
get_analytics_by | Rufen Sie Klicks gruppiert nach Land, Browser, Plattform usw. ab |
list_domains | Listen Sie Ihre benutzerdefinierten Domains auf |
list_webhooks | Listen Sie Workspace-Webhook-Abonnements auf |
subscribe_webhook | Abonnieren 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
| Variable | Erforderlich | Beschreibung |
|---|---|---|
LINKLY_API_KEY | Ja | Ihr Linkly API-Schlüssel |
LINKLY_WORKSPACE_ID | Nein | Ihre 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-serverin 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