> ## 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)