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

# Guida all'integrazione di ShortURL MCP

> shorturl MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) è un protocollo di contesto modello sviluppato da Anthropic, che consente ai modelli AI (come Claude, GPT, ecc.) di chiamare strumenti esterni tramite un'interfaccia standardizzata. Attraverso il ShortURL MCP Server fornito da XHuoAPI, puoi generare link brevi direttamente in client AI come Claude Desktop, VS Code, Cursor, ecc.

## Panoramica delle funzionalità

Il ShortURL MCP Server offre le seguenti funzionalità principali:

* **Accorciamento singolo link** — Trasforma URL lunghi in link brevi e facilmente condivisibili
* **Accorciamento batch di link** — Accorcia più URL contemporaneamente (fino a 10)
* **Guida all'uso** — Ottieni istruzioni complete e best practice
* **Informazioni API** — Visualizza dettagli del servizio API e codici di errore

## Prerequisiti

Prima dell'uso, devi ottenere un API Token da XHuoAPI:

1. Registrati o accedi alla [piattaforma XHuoAPI](https://api.xhuoapi.ai)
2. Vai alla pagina [ShortURL API](https://api.xhuoapi.ai/documents/short-url)
3. Clicca su "Acquire" per ottenere l'API Token (la prima richiesta include un credito gratuito)

## Installazione e configurazione

### Metodo 1: installazione tramite pip (consigliato)

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

### Metodo 2: installazione da sorgente

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

Dopo l'installazione, puoi avviare il servizio con il comando `mcp-shorturl`.

## Uso in Claude Desktop

Modifica il file di configurazione di Claude Desktop:

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

Aggiungi la seguente configurazione:

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

Se usi `uvx` (non richiede installazione preventiva di pacchetti):

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

Salva la configurazione e riavvia Claude Desktop per utilizzare gli strumenti ShortURL nelle conversazioni.

## Uso in VS Code / Cursor

Crea `.vscode/mcp.json` nella directory principale del progetto:

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

Oppure usa `uvx`:

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

## Elenco degli strumenti disponibili

| Nome strumento             | Descrizione                                     |
| -------------------------- | ----------------------------------------------- |
| `shorturl_create`          | Accorcia un singolo URL                         |
| `shorturl_batch_create`    | Accorcia più URL contemporaneamente (fino a 10) |
| `shorturl_get_usage_guide` | Ottieni la guida completa all'uso               |
| `shorturl_get_api_info`    | Ottieni dettagli sul servizio API               |

## Esempi d'uso

Dopo la configurazione, puoi chiamare queste funzionalità direttamente nel client AI con linguaggio naturale, ad esempio:

* "Per favore accorcia questo link"
* "Accorcia questi 5 URL in batch"
* "Genera un link breve da condividere"

## Ulteriori informazioni

* Repository GitHub: [XHuoAPI/ShortURLMCP](https://github.com/XHuoAPI/ShortURLMCP)
* Pacchetto PyPI: [mcp-shorturl](https://pypi.org/project/mcp-shorturl/)
* Documentazione API: [API per generazione link brevi](https://api.xhuoapi.ai/documents/short-url)