Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) est un protocole de contexte de modèle développé par Anthropic, permettant aux modèles d’IA (comme Claude, GPT, etc.) d’appeler des outils externes via une interface standardisée. Grâce au ShortURL MCP Server fourni par AceData Cloud, vous pouvez générer directement des liens courts dans des clients IA tels que Claude Desktop, VS Code, Cursor, etc.

​
Aperçu des fonctionnalités

Le ShortURL MCP Server offre les fonctionnalités principales suivantes :
  • Raccourcissement d’un seul lien — Convertir une URL longue en un lien court facile à partager
  • Raccourcissement par lot — Raccourcir plusieurs URL en une seule fois (jusqu’à 10)
  • Guide d’utilisation — Obtenir les instructions complètes et les meilleures pratiques
  • Informations API — Consulter les détails du service API et les codes d’erreur

​
Prérequis

Avant utilisation, vous devez obtenir un jeton API AceData Cloud :
  1. Inscrivez-vous ou connectez-vous sur la plateforme AceData Cloud
  2. Rendez-vous sur la page ShortURL API
  3. Cliquez sur « Acquire » pour obtenir un jeton API (une allocation gratuite est offerte lors de la première demande)

​
Installation et configuration

​
Méthode 1 : installation via pip (recommandée)

pip install mcp-shorturl

​
Méthode 2 : installation depuis le code source

git clone https://github.com/AceDataCloud/MCPShortURL.git
cd MCPShortURL
pip install -e .
Une fois l’installation terminée, vous pouvez lancer le service avec la commande mcp-shorturl.

​
Utilisation dans Claude Desktop

Modifiez le fichier de configuration de Claude Desktop :
  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows : %APPDATA%\Claude\claude_desktop_config.json
Ajoutez la configuration suivante : 
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}
Si vous utilisez uvx (sans installation préalable de paquet) : 
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}
Après avoir enregistré la configuration, redémarrez Claude Desktop pour utiliser les outils ShortURL dans vos conversations.

​
Utilisation dans VS Code / Cursor

Créez un fichier .vscode/mcp.json à la racine de votre projet : 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}
Ou utilisez uvx : 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "votre jeton API"
      }
    }
  }
}

​
Liste des outils disponibles

Nom de l’outilDescription
shorturl_createRaccourcir une seule URL
shorturl_batch_createRaccourcir plusieurs URL en lot (jusqu’à 10)
shorturl_get_usage_guideObtenir le guide d’utilisation complet
shorturl_get_api_infoObtenir les détails du service API

​
Exemple d’utilisation

Une fois configuré, vous pouvez appeler ces fonctionnalités directement via langage naturel dans votre client IA, par exemple :
  • « Peux-tu raccourcir ce lien pour moi ? »
  • « Raccourcis ces 5 URL en lot »
  • « Génère un lien court pour le partage »

​
Informations complémentaires