mcpclaude-codeagents
Как да добавите съкращател на URL адреси в Claude Code чрез MCP
Свържете Claude Code с Linkdash чрез MCP, за да създава кратки връзки, да разделя трафика, да споделя файлове и да чете статистика, без да напуска терминала.
Igor Kirnosov6 мин четене

Claude Code може да създава и управлява кратки връзки, след като го свържете със съкращател на URL адреси чрез 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_* |
Управление на собствени домейни и 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>, така че тези правила предполагат, че сте нарекли сървъра linkdash в стъпка 1. Създаването и промяната на връзки продължават да искат потвърждение всеки път, така че оставате в течение за всичко, което променя накъде води една връзка.
Сценарии, които се отплащат в терминала
Съкратете всички връзки в един релийз
Създай кратки връзки за всеки 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 има достъп до shell, той може да работи с файлове: извиква 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 чрез своя shell, като и двата варианта достигат до един и същ акаунт:
- MCP не изисква инсталация. Claude вижда типизирани инструменти и параметрите им, което го прави по-лесния избор, когато просто искате Claude да управлява връзки.
- CLI (
npm i -g linkdash-cli) извежда JSON, което е удобно за скриптове, които Claude пише за вас. За да научите Claude да работи с CLI, инсталирайте skill-а за агенти на 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изчиства предишните избори. - Инструментите връщат грешка 401 в CI.
LINKDASH_API_KEYлипсва или е грешен в тази среда, или ключът е бил изтрит.
Често задавани въпроси
Вижда ли Claude паролата ми или ключ?
Не. Влизате в linkdash.dev в браузъра си, а Claude Code получава токен, който пази в собствената си конфигурация. Нито паролата ви, нито токенът трябва да се появяват в разговора.
Как да прекъсна връзката с Claude Code?
В таблото на Linkdash отворете API ключове и щракнете върху Прекъсване до Claude Code в Свързани приложения. Достъпът му спира веднага. Изпълнението на claude mcp logout linkdash също премахва запазения токен от машината ви.
Може ли Claude да изтрие връзките ми?
Само ако му позволите. Правилата deny от стъпка 4 блокират links_delete и variants_remove, дори ако Claude опита.
Безплатно ли е?
Да, в плана Free, който включва 5 000 събития на месец. Вижте цените за по-високи лимити.
Мога ли да свържа и Cursor, Codex или ChatGPT?
Да. Същият сървър работи с всички тях, като повечето изискват само URL адреса и вход. Документацията за MCP съдържа стъпките за всеки.

