Przewodnik integracji ShortURL MCP

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 AceData Cloud 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ć AceData Cloud API Token:

Zarejestruj się lub zaloguj na platformie AceData Cloud
Przejdź do strony ShortURL API
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/AceDataCloud/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": {
        "ACEDATACLOUD_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": {
        "ACEDATACLOUD_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": {
        "ACEDATACLOUD_API_TOKEN": "Twój API Token"
      }
    }
  }
}

Lub użyj uvx:

{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_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: AceDataCloud/ShortURLMCP
Pakiet PyPI: mcp-shorturl
Dokumentacja API: 短链接生成 API

​Przegląd funkcji

​Wymagania wstępne

​Instalacja i konfiguracja

​Metoda 1: instalacja przez pip (zalecane)

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

​Użycie w Claude Desktop

​Użycie w VS Code / Cursor

​Lista dostępnych narzędzi

​Przykłady użycia

​Dodatkowe informacje