Linkly Link Shortener

Сервер Linkly MCP позволяет подключать ИИ-ассистентов к вашему аккаунту Linkly с помощью Model Context Protocol. После подключения вы сможете создавать короткие ссылки и управлять ими через естественный диалог.

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт, который позволяет ИИ-ассистентам безопасно подключаться к внешним инструментам и источникам данных. Вместо копирования и вставки между приложениями вы можете попросить ИИ-ассистента выполнять действия напрямую.

Поддерживаемые ИИ-ассистенты

Сервер Linkly MCP работает с:

• Claude Desktop
• ChatGPT Desktop
• Другими MCP-совместимыми клиентами (Cursor, Windsurf и др.)

Где его найти

Сервер Linkly MCP указан в основных каталогах MCP, поэтому вы можете установить его оттуда, где вы уже ищете коннекторы:

• Каталог коннекторов Claude — подключение в один клик в Claude (веб и Desktop)
• Официальный реестр MCP — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — плагин Linkly для Claude Code и Cowork
• Исходный код на GitHub — лицензия MIT

MCP-сервер или Linkly CLI?

Если ваш ИИ-ассистент — это кодинг-агент, который может выполнять команды оболочки, например Claude Code или Cursor, то Linkly CLI часто подходит лучше, чем MCP-сервер. Кодинг-агенты уже умеют работать с инструментами командной строки, а CLI даёт им --json вывод для каждой команды плюс команду linkly schema, которая выводит полное дерево команд, чтобы агент мог обнаружить все доступные возможности. MCP-сервер остаётся лучшим выбором для ассистентов, которые не могут выполнять команды оболочки, например Claude Desktop и ChatGPT Desktop.

Что вы можете делать

После подключения вы можете попросить ИИ-ассистента:

• Создавать короткие ссылки — «Создай короткую ссылку для https://example.com»
• Отслеживать эффективность — «Сколько кликов получили мои ссылки на этой неделе?»
• Управлять ссылками — «Обнови ссылку "promo" с новым адресом назначения»
• Просматривать аналитику — «Покажи клики по странам за последние 30 дней»
• Искать ссылки — «Найди все ссылки, связанные с запуском продукта»
• Управлять доменами — «Покажи мои кастомные домены»
• Настраивать вебхуки — «Подпиши https://my-site.com/webhook на получение событий кликов»

Начало работы

Размещённый сервер Linkly MCP находится по адресу https://mcp.linklyhq.com. Устанавливать ничего не нужно, и API-ключ копировать не требуется — сервер использует OAuth, поэтому при первом подключении вашего ИИ-ассистента откроется окно браузера с запросом войти в Linkly и подтвердить доступ. После этого ваш ассистент останется подключённым.

https://mcp.linklyhq.com

Настройка

Claude Desktop

В Claude Desktop перейдите в Настройки → Коннекторы → Добавить пользовательский коннектор. Введите имя (Linkly) и URL удалённого MCP-сервера:

https://mcp.linklyhq.com

Нажмите Добавить, затем Подключить на коннекторе Linkly. Откроется вкладка браузера для входа и подтверждения доступа. После этого Claude Desktop останется подключённым — файл конфигурации или дополнительные инструменты не нужны.

Claude Code (CLI)

Claude Code поддерживает удалённые MCP-серверы нативно. Добавьте Linkly одной командой:

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

Затем выполните /mcp внутри Claude Code, выберите linkly и авторизуйтесь в браузере, когда появится запрос.

ChatGPT Desktop

Откройте файл конфигурации ChatGPT:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

Добавьте MCP-сервер Linkly:

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

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

Инструмент	Описание
create_link	Создать новую короткую ссылку с дополнительными UTM-параметрами, пикселями и др.
update_link	Обновить настройки существующей ссылки
delete_link	Удалить ссылку
get_link	Получить сведения о конкретной ссылке
list_links	Список всех ссылок в вашем рабочем пространстве
search_links	Поиск ссылок по имени, URL или заметке
get_clicks	Получить последние данные о кликах
get_analytics	Получить данные о кликах во временном ряду для графиков
get_analytics_by	Получить клики, сгруппированные по стране, браузеру, платформе и др.
list_domains	Список ваших кастомных доменов
list_webhooks	Список подписок на вебхуки в рабочем пространстве
subscribe_webhook	Подписать URL на получение событий кликов

Параметры создания ссылок

При создании ссылок вы можете указать:

• Основные: url, name, note, domain, slug, enabled
• UTM-параметры: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Open Graph: og_title, og_description, og_image
• Отслеживание: fb_pixel_id, ga4_tag_id, gtm_id
• Дополнительно: cloaking, forward_params, block_bots, hide_referrer
• Срок действия: expiry_datetime, expiry_destination

Устранение неполадок

«Не удалось подключиться к MCP-серверу»

• Убедитесь, что https://mcp.linklyhq.com доступен с вашего компьютера
• В Claude Code выполните /mcp и выберите linkly, чтобы повторно запустить поток OAuth

«Ошибка аутентификации», «invalid_client» или браузер постоянно запрашивает вход

Это означает, что ваш клиент хранит устаревшую регистрацию подключения. Очистите кэшированные учётные данные и авторизуйтесь заново. В Claude Code выполните /mcp → linkly → reconnect. В Claude Desktop удалите коннектор Linkly в разделе Настройки → Коннекторы и добавьте его снова, затем войдите ещё раз.

Инструменты не отображаются

• Перезапустите ИИ-ассистента после сохранения конфигурации
• Проверьте, что синтаксис JSON в файле конфигурации корректен
• Убедитесь, что MCP-сервер запущен (проверьте значок инструментов в вашем ассистенте)

Связанные ресурсы

• Интеграция с Claude Desktop
• Интеграция с ChatGPT
• Документация API Linkly
• Linkly CLI
• Вебхуки
• Model Context Protocol

✦

✧

✳

●

Попробуйте бесплатный сокращатель ссылок Linkly

Получите 100 коротких ссылок и 500 кликов в месяц бесплатно. Без кредитной карты.

500 отслеживаемых кликов/месяцКастомные доменыКредитная карта не требуется

Часто задаваемые вопросы о MCP-сервере

Нужно ли что-то устанавливать для использования MCP-сервера?

Нет. Размещённый сервер по адресу https://mcp.linklyhq.com использует OAuth — вы входите один раз в браузере, и ваш ИИ-ассистент остаётся подключённым. На ваш компьютер не нужно устанавливать никакого программного обеспечения, кроме самого ИИ-ассистента.

Нужен ли мне API-ключ?

Нет. MCP-сервер использует OAuth — вы входите в Linkly через браузер при первом подключении ИИ-ассистента, и API-ключ нигде не нужно копировать или вставлять.

Какие ИИ-ассистенты поддерживают MCP?

Claude Desktop, Claude Code (CLI) и ChatGPT Desktop поддерживают MCP. Другие инструменты, такие как Cursor и Windsurf, также имеют поддержку MCP.

Безопасен ли мой аккаунт?

Да. Размещённый сервер использует OAuth 2.1 с PKCE — ваш пароль Linkly вводится только на app.linklyhq.com, а ваш ИИ-ассистент видит только токен доступа, ограниченный вашим рабочим пространством. Сама модель ИИ никогда не видит ваши учётные данные.

Могу ли я использовать MCP с веб-версиями Claude или ChatGPT?

Нет, MCP требует настольных приложений или CLI Claude Code. Веб-версии не поддерживают подключения MCP.

Как обновить MCP-сервер?

Обновлять ничего не нужно — мы непрерывно разворачиваем улучшения на размещённом сервере, и каждый подключённый клиент получает их автоматически.

Получите 100 коротких ссылок и отслеживайте 500 кликов в месяц бесплатно.

Начать бесплатно

Кредитная карта не требуется

Большой объём? Поговорите с нашей командой