Перейти к содержимому
Все статьи

mcpclaude-codeagents

Как подключить сокращатель ссылок к Claude Code через MCP

Подключите Claude Code к Linkdash через MCP: он будет создавать короткие ссылки, делить трафик, делиться файлами и читать статистику прямо из терминала.

Igor Kirnosov5 мин чтения

Claude Code вызывает MCP-сервер Linkdash и создаёт короткую ссылку lida.sh/pricing

Claude Code умеет создавать короткие ссылки и управлять ими, если подключить его к сокращателю ссылок через MCP. Добавьте MCP-сервер Linkdash одной командой, один раз войдите в браузере — и Claude сможет сокращать URL, делить трафик между страницами, делиться файлами с ограниченным сроком действия и читать статистику кликов. И всё это в той же сессии терминала, где он пишет ваш код.

В этом руководстве — настройка, как поделиться ею с командой, как выбрать инструменты, которые Claude может запускать без подтверждения, сценарии, где это окупается, и запуск в CI. Работаете в Cursor или Codex? Команды для их настройки есть в документации по MCP.

Что Claude Code сможет делать

MCP-сервер Linkdash предоставляет те же операции, что и CLI и HTTP API, в виде инструментов, которые Claude находит сам:

Инструменты Что может Claude
links_create, links_update, links_delete Создавать, изменять, приостанавливать и удалять ссылки
variants_add, variants_update, variants_remove Делить трафик или направлять посетителей по стране, устройству или ОС
links_list, links_get, links_stats Находить ссылки и читать посещения, страны и источники переходов
files_upload_url Загружать файл и делиться им по ссылке
links_export, links_import Выгружать и загружать ссылки в CSV
domains_*, webhooks_* Управлять собственными доменами и вебхуками

Шаг 1. Добавьте сервер

claude mcp add --transport http linkdash \
  https://api.linkdash.dev/mcp

Эта команда добавляет Linkdash в текущий проект. Добавьте --scope user, чтобы сервер был доступен во всех проектах на вашем компьютере.

Шаг 2. Войдите

claude mcp login linkdash

В браузере откроется страница входа в Linkdash. Если аккаунта ещё нет, его можно создать там же на тарифе Free. После входа появится экран подтверждения с вопросом, может ли Claude Code использовать ваш аккаунт. Нажмите «Разрешить» — Claude Code сохранит токен доступа и будет сам его обновлять.

Войти можно и изнутри сессии: выполните /mcp, выберите linkdash и пройдите аутентификацию. Проверьте подключение:

claude mcp list

У linkdash должен быть статус ✔ Connected. Теперь попробуйте:

Сократи https://example.com/pricing до lida.sh/pricing.

Claude вызовет links_create и ответит новой короткой ссылкой.

Шаг 3. Поделитесь настройкой с командой

Чтобы у всех, кто работает с репозиторием, был один и тот же сервер, добавьте файл .mcp.json в корень проекта:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp"
    }
  }
}

В файле нет ничего секретного, его можно спокойно закоммитить. Когда коллега впервые откроет проект, Claude Code попросит его подтвердить сервер, и каждый войдёт со своим аккаунтом Linkdash — так каждая ссылка попадёт в аккаунт того, кто её запросил.

Шаг 4. Решите, что запускается без подтверждения

По умолчанию Claude Code спрашивает разрешение перед вызовом MCP-инструмента. Чтение статистики безвредно, его стоит разрешить, а удаление ссылок лучше сразу запретить. Добавьте правила разрешений в .claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__linkdash__links_list",
      "mcp__linkdash__links_get",
      "mcp__linkdash__links_stats"
    ],
    "deny": [
      "mcp__linkdash__links_delete",
      "mcp__linkdash__variants_remove"
    ]
  }
}

MCP-инструменты называются mcp__<server>__<tool>, поэтому эти правила предполагают, что на шаге 1 вы назвали сервер linkdash. Создание и изменение ссылок по-прежнему требует подтверждения каждый раз — так вы контролируете всё, что меняет адрес назначения ссылки.

Сценарии, которые окупаются в терминале

Сократить все ссылки в релизе

Создай короткие ссылки для всех URL в CHANGELOG.md в разделе 2.4.0, добавь им тег release-2.4 и замени URL в файле.

Claude прочитает файл, вызовет links_create для каждого URL с этим тегом и отредактирует changelog. Тег держит ссылки релиза вместе в дашборде и пригодится, когда вы позже спросите о статистике.

Разделить трафик на только что сделанную страницу

Создай lida.sh/pricing, которая делит посетителей 50/50 между /pricing и /pricing-v2, с utm_content, равным имени каждого варианта.

Claude создаст одну ссылку с двумя вариантами, каждый со своей меткой, чтобы ваш инструмент аналитики различал группы. О том, сколько вести тест и как читать результат, — в руководстве по A/B-тестированию ссылки.

Поделиться сборкой с ограниченным сроком

Поделись dist/app-1.4.2.dmg по ссылке, которая истекает через 3 дня и перестаёт работать после 5 открытий.

У Claude Code есть оболочка, поэтому он умеет работать с файлами: вызывает files_upload_url, загружает файл по полученному URL через curl, а затем вызывает links_create с загруженным файлом, expires: "3d" и maxOpenings: 5. Сам файл через диалог не проходит.

Проверить, как работают ссылки

Какие ссылки с тегом release-2.4 получили больше всего посещений за последние 7 дней и откуда пришли посетители?

Claude получит список ссылок с тегом, затем вызовет links_stats для каждой с last: "7d". В каждом результате есть посещения, страны и источники переходов. С правилами разрешений из шага 4 эти запросы на чтение выполняются без подтверждения.

Claude Code в CI

Для входа нужен человек у браузера, поэтому в запусках без интерфейса, например claude -p в CI, используется API-ключ. Создайте его в разделе API-ключи (ключи начинаются с ldash_), сохраните как секрет CI с именем LINKDASH_API_KEY и передайте в заголовке:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${LINKDASH_API_KEY}"
      }
    }
  }
}

Claude Code подставляет ${LINKDASH_API_KEY} из окружения, поэтому сам ключ никогда не попадает в коммит. Инструменты и правила разрешений работают одинаково в обоих случаях.

MCP или CLI?

Claude Code может запускать и CLI linkdash через оболочку — оба способа работают с одним и тем же аккаунтом:

  • MCP не требует установки. Claude видит типизированные инструменты и их параметры, поэтому это более простой вариант, если вы просто хотите, чтобы Claude управлял ссылками.
  • CLI (npm i -g linkdash-cli) выводит JSON, что удобно для скриптов, которые Claude пишет для вас. Чтобы научить Claude работать с CLI, установите навык Linkdash для агентов командой npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Решение проблем

  • У linkdash статус ! Needs authentication. Выполните claude mcp login linkdash и войдите снова. Это также происходит после того, как вы отключили Claude Code в дашборде.
  • Сервер из .mcp.json остаётся в ожидании. Запустите claude в проекте и подтвердите сервер. claude mcp reset-project-choices сбрасывает сделанный ранее выбор.
  • Инструменты в CI падают с ошибкой 401. В этом окружении LINKDASH_API_KEY не задан или задан неверно, либо ключ был удалён.

Частые вопросы

Видит ли Claude мой пароль или ключ?

Нет. Вы входите на linkdash.dev в браузере, а Claude Code получает токен, который хранит в своей конфигурации. Ни пароль, ни токен не должны появляться в диалоге.

Как отключить Claude Code?

В дашборде Linkdash откройте «API-ключи» и нажмите «Отключить» рядом с Claude Code в разделе «Подключённые приложения». Доступ прекратится сразу. Команда claude mcp logout linkdash также удаляет сохранённый токен с вашего компьютера.

Может ли Claude удалить мои ссылки?

Только если вы ему это разрешите. Запрещающие правила из шага 4 блокируют links_delete и variants_remove, даже если Claude попытается их вызвать.

Это бесплатно?

Да, на тарифе Free, который включает 5 000 событий в месяц. Более высокие лимиты — на странице тарифов.

Можно ли подключить Cursor, Codex или ChatGPT?

Да. Этот же сервер работает со всеми ними, и большинству нужны только URL и вход в аккаунт. Пошаговые инструкции для каждого — в документации по MCP.