Linkly MCP Server
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-serverist 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: filoo 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.comChatGPT Desktop
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com"
}
}
}Verfügbare Tools
Tool | Beschreibung |
| Einen neuen Kurzlink erstellen |
| Einen vorhandenen Link aktualisieren |
| Einen Link löschen |
| Linkdetails abrufen |
| Alle Links im Arbeitsbereich auflisten |
| Links nach Name, URL oder Notiz durchsuchen |
| Zeitreihen-Klickdaten abrufen |
| Klicks nach Dimension gruppiert abrufen |
| Aktuelle Klickdaten abrufen |
| Detaillierte Klickdatensätze exportieren |
| Benutzerdefinierte Domains auflisten |
| Eine benutzerdefinierte Domain hinzufügen |
| Eine benutzerdefinierte Domain entfernen |
| Domain-Favicon aktualisieren |
| Webhooks des Arbeitsbereichs auflisten |
| Einen Webhook hinzufügen |
| Einen Webhook entfernen |
| Linkspezifische Webhooks auflisten |
| Einen Link-Webhook hinzufügen |
| Einen Link-Webhook entfernen |
Links
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 publishSiehe 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:
Stellen Sie den Worker bereit (Push auf den verbundenen Branch /
wrangler deploy).Platform-Dashboard → die Linkly-App → eine neue Entwurfsversion erstellen (behalten Sie dieselbe MCP-URL
https://mcp.linklyhq.combei).Klicken Sie im MCP-Abschnitt auf Scan Tools, um die Live-Tool-Liste + Annotationen erneut zu lesen.
Ziehen Sie
chatgpt-app-submission.jsonauf das Formular (oben auf der Seite), um die Begründungen auszufüllen.Ü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
Available Tools
20 toolscreate_domainCInspect
Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.
Inputs: name (required).
create_linkCInspect
Create a new Linkly short link. Returns the created link with its short URL.
Inputs: url (required), name, note, slug, +19 more.
delete_domainCInspect
Remove a custom domain from the workspace.
Inputs: domain_id (required).
delete_linkCInspect
Delete a Linkly link by its ID
Inputs: link_id (required).
export_clicksCInspect
Export detailed click records with full information (timestamp, browser, country, URL, platform, referer, bot, ISP, params).
Inputs: end, bots, start, country, +2 more.
get_analyticsAInspect
Get time-series click analytics data for charting. Returns click counts over time.
Inputs: end, bots, start, unique, +5 more.
get_analytics_byBInspect
Get click counts grouped by a dimension (country, platform, browser, etc.). Useful for breakdowns and top-N reports.
Inputs: counter (required), end, bots, start, +4 more.
get_clicksCInspect
Get recent click data for the workspace
Inputs: link_id.
list_domainsBInspect
List all custom domains in the workspace.
Inputs: no named parameters.
list_linksBInspect
List all links in the workspace. Returns links with click statistics.
Inputs: no named parameters.
list_link_webhooksBInspect
List all webhook URLs subscribed to a specific link.
Inputs: link_id (required).
list_webhooksAInspect
List all webhook URLs subscribed to the workspace. These receive click events for all links.
Inputs: no named parameters.
search_linksBInspect
Search for links by name, URL, or note. Returns matching links with click statistics.
Inputs: query (required).
subscribe_link_webhookCInspect
Subscribe a webhook URL to receive click events for a specific link.
Inputs: url (required), link_id (required).
subscribe_webhookCInspect
Subscribe a webhook URL to receive click events for all links in the workspace.
Inputs: url (required).
unsubscribe_link_webhookBInspect
Unsubscribe a webhook URL from a specific link's click events.
Inputs: url (required), link_id (required).
unsubscribe_webhookCInspect
Unsubscribe a webhook URL from workspace click events.
Inputs: url (required).
update_domain_faviconCInspect
Update the favicon URL for a custom domain.
Inputs: domain_id (required), favicon_url (required).
update_linkCInspect
Update an existing Linkly link by its ID
Inputs: link_id (required), url, name, note, +18 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool has a distinct purpose with clear boundaries, targeting specific resources (domains, links, webhooks, analytics) and actions (create, delete, get, list, update, subscribe, unsubscribe, export). There is no overlap or ambiguity; for example, get_analytics and get_analytics_by serve different analytical functions, and webhook tools are clearly separated by scope (link-specific vs. workspace-wide).
Tool names follow a consistent verb_noun pattern throughout, with verbs like create, delete, get, list, update, subscribe, unsubscribe, export, and search applied to nouns such as domain, link, webhook, analytics, and clicks. There are no deviations in style (e.g., no camelCase or mixed conventions), making the set predictable and readable.
With 20 tools, the count is slightly high but reasonable for a link management and analytics domain, covering domains, links, webhooks, and analytics comprehensively. It avoids being excessive (e.g., not over 25) and each tool appears justified, though it could be streamlined slightly without losing functionality.
The tool set provides complete CRUD/lifecycle coverage for domains (create, list, delete, update_favicon), links (create, get, list, update, delete, search), and webhooks (subscribe, unsubscribe, list for both link-specific and workspace-wide). Analytics tools (get_analytics, get_analytics_by, export_clicks, get_clicks) offer robust data access, leaving no obvious gaps for agent workflows in this domain.
Maintenance
Related MCP Connectors
Create branded short links and QR codes, and pull click analytics by country, device and referrer.
Create, search and pause deep links; QR codes; analytics, taps, events; domains; webhooks.
Short links, QR codes, link and website analytics: create and edit links, read clicks and visitors.
Create, edit and track LickityClick short links, campaigns and click stats from your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables interaction with the Firelinks link shortening platform to create and manage short links, track click statistics, manage custom domains, and compare analytics periods through natural language.3MIT
- AlicenseAqualityDmaintenanceEnables AI agents to shorten URLs, manage links, and track click analytics through 8 first-class tools, designed for use with Claude Desktop, Cursor, and other MCP clients.946 npmMIT
- AlicenseAqualityBmaintenanceEnables users to shorten links, bulk create URLs, generate QR codes, manage and disable links, and retrieve click analytics from MCP clients like Claude, ChatGPT, Cursor, and n8n.9MIT
- AlicenseBqualityCmaintenanceEnables users to shorten links, bulk-create URLs, generate QR codes, and retrieve click analytics through MCP clients such as Claude, ChatGPT, Cursor, and n8n.940 npmMIT