> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Керівництво зі інтеграції ShortURL MCP

> shorturl MCP 服务器集成

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

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

ShortURL MCP Server надає такі основні функції:

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

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

Перед використанням необхідно отримати API Token від XHuoAPI:

1. Зареєструйтесь або увійдіть на [XHuoAPI платформу](https://api.xhuoapi.ai)
2. Перейдіть на сторінку [ShortURL API](https://api.xhuoapi.ai/documents/short-url)
3. Натисніть «Acquire» для отримання API Token (перший запит надає безкоштовний ліміт)

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

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

```bash theme={null}
pip install mcp-shorturl
```

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

```bash theme={null}
git clone https://github.com/XHuoAPI/ShortURLMCP.git
cd ShortURLMCP
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`

Додайте наступну конфігурацію:

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
```

Якщо використовуєте `uvx` (не потребує попереднього встановлення пакетів):

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
```

Після збереження конфігурації перезапустіть Claude Desktop — тепер ви зможете користуватися інструментами ShortURL у діалогах.

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

Створіть у корені проекту файл `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
```

Або з `uvx`:

```json theme={null}
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ваш API Token"
      }
    }
  }
}
```

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

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

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

Після налаштування ви можете викликати ці функції у AI-клієнтах природною мовою, наприклад:

* «Допоможи мені скоротити це посилання»
* «Скороти пакетно ці 5 URL»
* «Згенеруй коротке посилання для поширення»

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

* Репозиторій GitHub: [XHuoAPI/ShortURLMCP](https://github.com/XHuoAPI/ShortURLMCP)
* Пакет PyPI: [mcp-shorturl](https://pypi.org/project/mcp-shorturl/)
* Документація API: [API для генерації коротких посилань](https://api.xhuoapi.ai/documents/short-url)