Сервер Linkly MCP

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

Что такое MCP?

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

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

Сервер 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?

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

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

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

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

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

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

https://mcp.linklyhq.com

Конфигурация

Claude Desktop

В Claude Desktop перейдите в Settings → Connectors → Add custom connector. Введите имя (Linkly) и URL удалённого MCP-сервера:

https://mcp.linklyhq.com

Нажмите Add, затем Connect на коннекторе 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"
    }
  }
}

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

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

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

• Базовые: 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

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

«Could not connect to MCP server»

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

«Authentication failed», «invalid_client» или браузер продолжает запрашивать вход

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

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

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

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

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