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

# Przewodnik integracji ShortURL MCP

> shorturl MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) to protokół kontekstowy modelu opracowany przez Anthropic, który umożliwia modelom AI (takim jak Claude, GPT itp.) wywoływanie zewnętrznych narzędzi za pomocą ustandaryzowanego interfejsu. Dzięki ShortURL MCP Server udostępnianemu przez XHuoAPI możesz bezpośrednio generować krótkie linki w klientach AI takich jak Claude Desktop, VS Code, Cursor i innych.

## Przegląd funkcji

ShortURL MCP Server oferuje następujące kluczowe funkcje:

* **Skracanie pojedynczego linku** — konwersja długiego URL na krótki, łatwy do udostępnienia link
* **Skracanie wsadowe** — jednoczesne skracanie wielu URL (maksymalnie 10)
* **Instrukcje użytkowania** — uzyskanie pełnej dokumentacji i najlepszych praktyk
* **Informacje o API** — przegląd szczegółów usługi API oraz kodów błędów

## Wymagania wstępne

Przed użyciem musisz uzyskać XHuoAPI API Token:

1. Zarejestruj się lub zaloguj na [platformie XHuoAPI](https://api.xhuoapi.ai)
2. Przejdź do strony [ShortURL API](https://api.xhuoapi.ai/documents/short-url)
3. Kliknij „Acquire”, aby uzyskać API Token (pierwsza rejestracja daje darmowy limit)

## Instalacja i konfiguracja

### Metoda 1: instalacja przez pip (zalecane)

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

### Metoda 2: instalacja ze źródła

```bash theme={null}
git clone https://github.com/XHuoAPI/ShortURLMCP.git
cd ShortURLMCP
pip install -e .
```

Po instalacji możesz uruchomić serwer poleceniem `mcp-shorturl`.

## Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Dodaj następującą konfigurację:

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
```

Jeśli używasz `uvx` (nie wymaga wcześniejszej instalacji pakietów):

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
```

Po zapisaniu konfiguracji i ponownym uruchomieniu Claude Desktop możesz korzystać z narzędzi ShortURL w rozmowach.

## Użycie w VS Code / Cursor

W katalogu głównym projektu utwórz plik `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
```

Lub użyj `uvx`:

```json theme={null}
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
```

## Lista dostępnych narzędzi

| Nazwa narzędzia            | Opis                                     |
| -------------------------- | ---------------------------------------- |
| `shorturl_create`          | Skracanie pojedynczego URL               |
| `shorturl_batch_create`    | Skracanie wielu URL jednocześnie (do 10) |
| `shorturl_get_usage_guide` | Uzyskanie pełnej instrukcji użytkowania  |
| `shorturl_get_api_info`    | Uzyskanie szczegółów usługi API          |

## Przykłady użycia

Po konfiguracji możesz wywoływać funkcje za pomocą naturalnego języka w klientach AI, np.:

* „Skróć ten link”
* „Skróć wsadowo tych 5 URL”
* „Wygeneruj krótki link do udostępnienia”

## Dodatkowe informacje

* Repozytorium GitHub: [XHuoAPI/ShortURLMCP](https://github.com/XHuoAPI/ShortURLMCP)
* Pakiet PyPI: [mcp-shorturl](https://pypi.org/project/mcp-shorturl/)
* Dokumentacja API: [短链接生成 API](https://api.xhuoapi.ai/documents/short-url)