Перейти до основного вмісту
MCP (Model Context Protocol) — це протокол контексту моделі, розроблений Anthropic, який дозволяє AI-моделям (таким як Claude, GPT тощо) викликати зовнішні інструменти через стандартизований інтерфейс. За допомогою ShortURL MCP Server від AceData Cloud ви можете безпосередньо створювати короткі посилання у клієнтах AI, таких як Claude Desktop, VS Code, Cursor тощо.

​
Огляд функцій

ShortURL MCP Server надає такі основні функції:
  • Скорочення одного посилання — перетворення довгого URL у коротке, зручне для поширення посилання
  • Пакетне скорочення посилань — одночасне скорочення кількох URL (до 10)
  • Інструкції з використання — отримання повного керівництва та найкращих практик
  • Інформація про API — перегляд деталей API та опис кодів помилок

​
Попередні вимоги

Перед використанням необхідно отримати API Token від AceData Cloud:
  1. Зареєструйтесь або увійдіть на AceData Cloud платформу
  2. Перейдіть на сторінку ShortURL API
  3. Натисніть «Acquire» для отримання API Token (перший запит надає безкоштовний ліміт)

​
Встановлення та налаштування

​
Варіант 1: Встановлення через pip (рекомендується)

pip install mcp-shorturl

​
Варіант 2: Встановлення з вихідного коду

git clone https://github.com/AceDataCloud/MCPShortURL.git
cd MCPShortURL
pip install -e .
Після встановлення можна запускати сервер командою mcp-shorturl.

​
Використання в Claude Desktop

Відредагуйте конфігураційний файл Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Додайте наступну конфігурацію: 
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
Якщо використовуєте uvx (не потребує попереднього встановлення пакетів): 
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
Після збереження конфігурації перезапустіть Claude Desktop — тепер ви зможете користуватися інструментами ShortURL у діалогах.

​
Використання у VS Code / Cursor

Створіть у корені проекту файл .vscode/mcp.json: 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
Або з uvx: 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Ваш API Token"
      }
    }
  }
}

​
Список доступних інструментів

Назва інструментуОпис
shorturl_createСкорочення одного URL
shorturl_batch_createПакетне скорочення кількох URL (до 10)
shorturl_get_usage_guideОтримання повного керівництва
shorturl_get_api_infoОтримання деталей API

​
Приклади використання

Після налаштування ви можете викликати ці функції у AI-клієнтах природною мовою, наприклад:
  • «Допоможи мені скоротити це посилання»
  • «Скороти пакетно ці 5 URL»
  • «Згенеруй коротке посилання для поширення»

​
Додаткова інформація