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-ассистент является агентом написания кода, способным выполнять команды оболочки — например, Claude Code или Cursor — Linkly CLI зачастую является лучшим выбором, чем MCP-сервер. Такие агенты уже хорошо умеют работать с инструментами командной строки, а CLI предоставляет им вывод в формате --json для каждой команды и команду linkly schema, которая выводит полное дерево команд, позволяя агенту узнать всё, что он может делать. MCP-сервер остаётся лучшим вариантом для ассистентов, которые не могут выполнять команды оболочки, таких как 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:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Перезапустите Claude Desktop. При первом использовании инструмента Linkly откроется вкладка браузера для входа и подтверждения доступа.

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

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

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

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

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

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

«Ошибка аутентификации» / браузер продолжает запрашивать вход

Очистите кэшированные MCP-учётные данные клиента и повторно авторизуйтесь. В Claude Code выполните /mcp → linkly → переподключиться. В Claude Desktop закройте приложение, удалите кэшированный токен mcp-remote в ~/.mcp-auth/, затем перезапустите.

Инструменты не появляются

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

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

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