Zum Hauptinhalt springen

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) ist ein von Anthropic entwickeltes Modellkontextprotokoll, das es KI-Modellen (wie Claude, GPT usw.) ermöglicht, externe Tools über eine standardisierte Schnittstelle aufzurufen. Mit dem von XHuoAPI bereitgestellten ShortURL MCP Server können Sie in AI-Clients wie Claude Desktop, VS Code, Cursor direkt Kurzlinks generieren.

​
Funktionsübersicht

Der ShortURL MCP Server bietet folgende Kernfunktionen:
  • Einzelne URL verkürzen — Lange URLs in kurze, leicht teilbare Kurzlinks umwandeln
  • Batch-URL-Verkürzung — Mehrere URLs auf einmal verkürzen (bis zu 10)
  • Benutzerhandbuch — Vollständige Gebrauchsanweisung und Best Practices erhalten
  • API-Informationen — API-Dienstdetails und Fehlercodes einsehen

​
Voraussetzungen

Vor der Nutzung benötigen Sie ein XHuoAPI API Token:
  1. Registrieren oder anmelden auf der XHuoAPI Plattform
  2. Zur ShortURL API Seite wechseln
  3. Auf „Acquire“ klicken, um das API Token zu erhalten (bei der ersten Beantragung gibt es ein kostenloses Kontingent)

​
Installation und Konfiguration

​
Methode 1: Installation via pip (empfohlen)

pip install mcp-shorturl

​
Methode 2: Installation aus dem Quellcode

git clone https://github.com/XHuoAPI/ShortURLMCP.git
cd ShortURLMCP
pip install -e .
Nach der Installation können Sie den Dienst mit dem Befehl mcp-shorturl starten.

​
Verwendung in Claude Desktop

Bearbeiten Sie die Konfigurationsdatei von Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Fügen Sie folgende Konfiguration hinzu: 
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
Wenn Sie uvx verwenden möchten (kein vorheriges Installieren von Paketen nötig): 
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
Speichern Sie die Konfiguration und starten Sie Claude Desktop neu, um die ShortURL-Tools im Chat verwenden zu können.

​
Verwendung in VS Code / Cursor

Erstellen Sie im Projektstammverzeichnis die Datei .vscode/mcp.json: 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "Ihr API Token"
      }
    }
  }
}
Oder verwenden Sie uvx: 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "Ihr API Token"
      }
    }
  }
}

​
Verfügbare Tools

ToolnameBeschreibung
shorturl_createEinzelne URL verkürzen
shorturl_batch_createMehrere URLs gleichzeitig verkürzen (max. 10)
shorturl_get_usage_guideVollständige Gebrauchsanleitung abrufen
shorturl_get_api_infoAPI-Dienstdetails abrufen

​
Anwendungsbeispiele

Nach der Konfiguration können Sie diese Funktionen direkt in Ihrem AI-Client per natürlicher Sprache aufrufen, zum Beispiel:
  • „Bitte kürze diesen Link für mich“
  • „Verkürze diese 5 URLs in einem Batch“
  • „Erstelle einen Kurzlink zum Teilen“

​
Weitere Informationen