Linkly MCP Server

Официальный сервер 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: DWZ Short URL 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"
    }
  }
}

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

Ссылки

• Сайт Linkly

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

• Справочник API

• Репозиторий на GitHub

Поддержка

За помощью обращайтесь в службу поддержки 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