Сервер 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 и др.)

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
• Документация API Linkly
• Linkly CLI
• Вебхуки
• Model Context Protocol