Vai al contenuto principale

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) è 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
  2. Vai alla pagina ShortURL API
  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)

pip install mcp-shorturl

​
Metodo 2: installazione da sorgente

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: 
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "tuo API Token"
      }
    }
  }
}
Se usi uvx (non richiede installazione preventiva di pacchetti): 
{
  "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: 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "tuo API Token"
      }
    }
  }
}
Oppure usa uvx: 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "tuo API Token"
      }
    }
  }
}

​
Elenco degli strumenti disponibili

Nome strumentoDescrizione
shorturl_createAccorcia un singolo URL
shorturl_batch_createAccorcia più URL contemporaneamente (fino a 10)
shorturl_get_usage_guideOttieni la guida completa all’uso
shorturl_get_api_infoOttieni 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