Linkly MCP Server

Offizieller Model Context Protocol (MCP)-Server für Linkly – die URL-Kürzungs- und Linkverwaltungsplattform.

Dieses Repository betreibt den gehosteten MCP-Server unter https://mcp.linklyhq.com. Das ist die einzige unterstützte Möglichkeit, einen KI-Assistenten über MCP mit Linkly zu verbinden. Siehe https://linklyhq.com/support/mcp-server für Einrichtungsanweisungen.

⚠️ Das npm-Paket linkly-mcp-server ist veraltet. Der selbstgehostete / API-Key-Flow wird nicht mehr gepflegt. Alle Benutzer sollten zum gehosteten Server migrieren – er verwendet OAuth 2.1 mit PKCE, benötigt keine API-Schlüssel oder lokale Installation und läuft immer mit dem neuesten Tool-Set. Das npm-Paket wird weiterhin auf der Registry existieren, um Abwärtskompatibilität zu gewährleisten, erhält jedoch keine neuen Tools oder Fehlerbehebungen und könnte in Zukunft entfernt werden.

Dokumentation

Für vollständige Dokumentation, Einrichtungsanleitungen und Beispiele besuchen Sie: https://linklyhq.com/support/mcp-server

Related MCP server: DWZ Short URL MCP Server

Funktionen

• Kurzlinks erstellen, aktualisieren und löschen

• Klick-Analysen und Statistiken anzeigen

• Benutzerdefinierte Domains und Favicons verwalten

• Webhooks für Klickereignisse konfigurieren

• Links suchen und filtern

• Klickdaten exportieren

Verwendung des gehosteten Servers

Server-URL: https://mcp.linklyhq.com

Verbinden Sie Ihren MCP-Client mit dem gehosteten Server und melden Sie sich in Linkly an, wenn sich Ihr Browser öffnet. Das ist alles – keine API-Schlüssel, keine Installation, keine Konfigurationsabweichungen.

Claude Desktop

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http linkly https://mcp.linklyhq.com

ChatGPT Desktop

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Verfügbare Tools

Links

• Linkly-Website

• Dokumentation

• API-Referenz

• GitHub-Repository

Support

Für Hilfe und Support besuchen Sie Linkly Support oder senden Sie eine E-Mail an support@linklyhq.com.

Veröffentlichung im MCP-Registry (Maintainer)

Die server.json im Repository-Stammverzeichnis ist das offizielle MCP-Registry-Manifest für den com.linklyhq/linkly-Server. Es ist nur remote: Es verweist Clients auf den gehosteten Server und enthält absichtlich kein Paket (die veraltete npm-Distribution wurde in v2.0.0 entfernt).

Die Veröffentlichung erfordert DNS-Zugriff auf linklyhq.com – der com.linklyhq-Namespace wird über einen DNS-TXT-Eintrag auf der Domain-Apex verifiziert:

# 1. Generate an Ed25519 key + TXT record (macOS: use openssl@3; system LibreSSL lacks Ed25519)
openssl genpkey -algorithm Ed25519 -out key.pem
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "linklyhq.com. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""   # add at the APEX of linklyhq.com

# 2. Authenticate the namespace + publish
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain linklyhq.com --private-key "$PRIVATE_KEY"
mcp-publisher publish

Siehe den Registry-Authentifizierungsleitfaden für Details.

Aktualisieren der ChatGPT-App (Maintainer)

chatgpt-app-submission.json ist der OpenAI Apps SDK Submission Import – er füllt die Pro-Tool-Annotationen und die drei Sicherheits-Begründungen (read-only / open-world / destructive) für alle 25 Tools vorab aus, sodass sie nicht manuell im Dashboard eingegeben werden müssen.

OpenAI friert zum Veröffentlichungszeitpunkt eine Metadaten-Momentaufnahme ein und erkennt MCP-Änderungen nicht automatisch. Nach der Bereitstellung von Serveränderungen veröffentlichen Sie also eine neue Version:

1. Stellen Sie den Worker bereit (Push auf den verbundenen Branch / wrangler deploy).

2. Platform-Dashboard → die Linkly-App → eine neue Entwurfsversion erstellen (behalten Sie dieselbe MCP-URL https://mcp.linklyhq.com bei).

3. Klicken Sie im MCP-Abschnitt auf Scan Tools, um die Live-Tool-Liste + Annotationen erneut zu lesen.

4. Ziehen Sie chatgpt-app-submission.json auf das Formular (oben auf der Seite), um die Begründungen auszufüllen.

5. Überprüfen Sie Testing und klicken Sie dann auf Submit. Die veröffentlichte Version läuft weiterhin gegen den Live-Server, bis die neue Version genehmigt wird.

Halten Sie diese Datei mit dem Worker synchron, wenn Tools hinzugefügt/entfernt werden oder sich ihre readOnlyHint/destructiveHint ändern. Das destruktive Flag ist nur für die 5 wirklich destruktiven Tools (delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook) auf true gesetzt; Erstellen/Aktualisieren/Abonnieren sind additiv (false).

Lizenz

MIT