Skip to main content
Glama
Linkly MCP Server

Linkly MCP Server

Linkly MCP Server

Claude connector directory Glama MCP registry

Официальный сервер Model Context Protocol (MCP) для Linkly — платформы для сокращения ссылок и управления ссылками.

Этот репозиторий обеспечивает работу размещённого MCP-сервера по адресу https://mcp.linklyhq.com. Это единственный поддерживаемый способ подключения ИИ-ассистента к Linkly через MCP. Инструкции по настройке см. на https://linklyhq.com/support/mcp-server.

⚠️ Пакет linkly-mcp-server в npm объявлен устаревшим. Поток с самохостингом / API-ключом больше не поддерживается. Всем пользователям следует перейти на размещённый сервер — он использует OAuth 2.1 с PKCE, не требует API-ключей или локальной установки и всегда работает с актуальным набором инструментов. Пакет npm продолжит существовать в реестре для обратной совместимости, но не будет получать новые инструменты или исправления ошибок и может быть удалён в будущем.

Документация

Полную документацию, руководства по настройке и примеры смотрите по адресу: https://linklyhq.com/support/mcp-server

Related MCP server: filoo MCP server

Возможности

  • Создание, обновление и удаление коротких ссылок

  • Просмотр аналитики и статистики по кликам

  • Управление собственными доменами и фавиконами

  • Настройка вебхуков на события кликов

  • Поиск и фильтрация ссылок

  • Экспорт данных о кликах

Использование размещённого сервера

Адрес сервера: https://mcp.linklyhq.com

Подключите свой MCP-клиент к размещённому серверу и войдите в Linkly, когда откроется браузер. Всё — без API-ключей, без установки, без рассинхронизации конфигурации.

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"
    }
  }
}

Доступные инструменты

Инструмент

Описание

create_link

Создать новую короткую ссылку

update_link

Обновить существующую ссылку

delete_link

Удалить ссылку

get_link

Получить информацию о ссылке

list_links

Вывести список всех ссылок в рабочем пространстве

search_links

Искать ссылки по имени, URL или примечанию

get_analytics

Получить данные о кликах в виде временного ряда

get_analytics_by

Получить клики, сгруппированные по измерению

get_clicks

Получить последние данные о кликах

export_clicks

Экспортировать подробные записи о кликах

list_domains

Вывести список собственных доменов

create_domain

Добавить собственный домен

delete_domain

Удалить собственный домен

update_domain_favicon

Обновить фавикон домена

list_webhooks

Вывести список вебхуков рабочего пространства

subscribe_webhook

Добавить вебхук

unsubscribe_webhook

Удалить вебхук

list_link_webhooks

Вывести список вебхуков для ссылок

subscribe_link_webhook

Добавить вебхук для ссылки

unsubscribe_link_webhook

Удалить вебхук для ссылки

Ссылки

Поддержка

За помощью обращайтесь в службу поддержки Linkly или пишите на адрес support@linklyhq.com.

Публикация в MCP Registry (для сопровождающих)

Файл server.json в корне репозитория — это манифест официального MCP Registry для сервера com.linklyhq/linkly. Он работает только как удалённый сервер: направляет клиентов на размещённый сервер и намеренно не содержит пакета (устаревший npm-дистрибутив был удалён в v2.0.0).

Для публикации требуется доступ к DNS для linklyhq.com — пространство имён com.linklyhq подтверждается через DNS TXT-запись в корне домена:

# 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

Подробности см. в руководстве по аутентификации в реестре.

Обновление приложения ChatGPT (для сопровождающих)

chatgpt-app-submission.json — это импорт чанsdk OpenAI Apps SDK; он заранее заполняет аннотации для каждого инструмента и три обоснования безопасности (read-only / open-world / destructive) для всех 25 инструментов, чтобы их не приходилось вводить вручную в панели.

OpenAI замораживает снимок метаданных при публикации и не обнаруживает изменения MCP автоматически, поэтому после выкладки изменений на сервере необходимо публиковать новую версию:

  1. Разверните worker (отправьте изменения в подключённую ветку или выполните wrangler deploy).

  2. Панель платформы → приложение Linkly → создайте новую черновую версию (сохраните тот же MCP URL https://mcp.linklyhq.com).

  3. В разделе MCP нажмите Scan Tools, чтобы заново прочитать актуальный список инструментов и аннотации.

  4. Перетащите chatgpt-app-submission.json на форму (в верхней части страницы), чтобы заполнить обоснования.

  5. Проверьте раздел Testing, затем нажмите Submit. Опубликованная версия продолжит работу на боевом сервере, пока новая не будет одобрена.

Следите за синхронизацией этого файла с worker при добавлении/удалении инструментов или изменении их readOnlyHint/destructiveHint. Деструктивный флаг равен true только у 5 действительно удаляющих инструментов (delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook); создание/обновление/подписка являются аддитивными операциями (false).

Лицензия

MIT

Available Tools

20 tools
create_domainCInspect

Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.

Inputs: name (required).

delete_domainCInspect

Remove a custom domain from the workspace.

Inputs: domain_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_webhooksAInspect

List all webhook URLs subscribed to the workspace. These receive click events for all links.

Inputs: no named parameters.

subscribe_webhookCInspect

Subscribe a webhook URL to receive click events for all links in the workspace.

Inputs: url (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).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 20 tools

    Disambiguation5/5

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

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      9
      46 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      9
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables users to shorten links, bulk-create URLs, generate QR codes, and retrieve click analytics through MCP clients such as Claude, ChatGPT, Cursor, and n8n.
      9
      40 npm
      MIT