Przejdź do głównej treści

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.

MCP (Model Context Protocol) 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
  2. Przejdź do strony ShortURL API
  3. Kliknij „Acquire”, aby uzyskać API Token (pierwsza rejestracja daje darmowy limit)

​
Instalacja i konfiguracja

​
Metoda 1: instalacja przez pip (zalecane)

pip install mcp-shorturl

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

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ę: 
{
  "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): 
{
  "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: 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
Lub użyj uvx: 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}

​
Lista dostępnych narzędzi

Nazwa narzędziaOpis
shorturl_createSkracanie pojedynczego URL
shorturl_batch_createSkracanie wielu URL jednocześnie (do 10)
shorturl_get_usage_guideUzyskanie pełnej instrukcji użytkowania
shorturl_get_api_infoUzyskanie 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