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

> shorturl MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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](https://api.xhuoapi.ai)
2. Zur [ShortURL API](https://api.xhuoapi.ai/documents/short-url) 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)

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

### Methode 2: Installation aus dem Quellcode

```bash theme={null}
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:

```json theme={null}
{
  "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):

```json theme={null}
{
  "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`:

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

Oder verwenden Sie `uvx`:

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

## Verfügbare Tools

| Toolname                   | Beschreibung                                  |
| -------------------------- | --------------------------------------------- |
| `shorturl_create`          | Einzelne URL verkürzen                        |
| `shorturl_batch_create`    | Mehrere URLs gleichzeitig verkürzen (max. 10) |
| `shorturl_get_usage_guide` | Vollständige Gebrauchsanleitung abrufen       |
| `shorturl_get_api_info`    | API-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

* GitHub Repository: [XHuoAPI/ShortURLMCP](https://github.com/XHuoAPI/ShortURLMCP)
* PyPI Paket: [mcp-shorturl](https://pypi.org/project/mcp-shorturl/)
* API Dokumentation: [Kurzlink-API](https://api.xhuoapi.ai/documents/short-url)