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:
- Claude Desktop
- ChatGPT Desktop
- Anderen MCP-kompatiblen Clients (Cursor, Windsurf, etc.)
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
- 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 Kurz-Link 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, 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
| Variable | Erforderlich | Beschreibung |
|---|---|---|
LINKLY_API_KEY | Ja | Ihr Linkly API-Schlüssel |
LINKLY_WORKSPACE_ID | Nein | Ihre 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-serverin 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.