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

> shorturl MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) är ett modellkontextprotokoll lanserat av Anthropic som tillåter AI-modeller (som Claude, GPT med flera) att anropa externa verktyg via ett standardiserat gränssnitt. Med ShortURL MCP Server från XHuoAPI kan du direkt generera korta länkar i AI-klienter som Claude Desktop, VS Code, Cursor med flera.

## Funktionsöversikt

ShortURL MCP Server erbjuder följande kärnfunktioner:

* **Kortlänk för enskild URL** — Konvertera långa URL:er till korta och lättdelade länkar
* **Batchkortlänk** — Kortlänka flera URL:er samtidigt (upp till 10 stycken)
* **Användarguide** — Få fullständig användardokumentation och bästa praxis
* **API-information** — Visa API-tjänstens detaljer och felkoder

## Förberedelser

Innan användning behöver du skaffa en XHuoAPI API-token:

1. Registrera dig eller logga in på [XHuoAPI-plattformen](https://api.xhuoapi.ai)
2. Gå till sidan för [ShortURL API](https://api.xhuoapi.ai/documents/short-url)
3. Klicka på "Acquire" för att få din API-token (första gången får du en gratis kvot)

## Installation och konfiguration

### Metod 1: pip-installation (rekommenderas)

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

### Metod 2: Installation från källkod

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

Efter installation kan du starta tjänsten med kommandot `mcp-shorturl`.

## Användning i Claude Desktop

Redigera Claude Desktops konfigurationsfil:

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

Lägg till följande konfiguration:

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}
```

Om du använder `uvx` (ingen förhandsinstallation av paket krävs):

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}
```

Spara och starta om Claude Desktop för att börja använda ShortURL-verktygen i dina konversationer.

## Användning i VS Code / Cursor

Skapa filen `.vscode/mcp.json` i projektets rotmapp:

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

Eller använd `uvx`:

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

## Tillgängliga verktyg

| Verktygsnamn               | Beskrivning                          |
| -------------------------- | ------------------------------------ |
| `shorturl_create`          | Kortlänka en enskild URL             |
| `shorturl_batch_create`    | Kortlänka flera URL:er (upp till 10) |
| `shorturl_get_usage_guide` | Hämta fullständig användarguide      |
| `shorturl_get_api_info`    | Hämta API-tjänstens detaljer         |

## Exempel på användning

När konfigurationen är klar kan du använda dessa funktioner direkt i AI-klienten med naturligt språk, till exempel:

* "Kan du korta ner den här länken åt mig?"
* "Kortlänka dessa 5 URL:er i batch"
* "Generera en kort länk för att dela"

## Mer information

* GitHub-repo: [XHuoAPI/ShortURLMCP](https://github.com/XHuoAPI/ShortURLMCP)
* PyPI-paket: [mcp-shorturl](https://pypi.org/project/mcp-shorturl/)
* API-dokumentation: [Kortlänk-API](https://api.xhuoapi.ai/documents/short-url)