Guide d'intégration ShortURL MCP

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 :

Inscrivez-vous ou connectez-vous sur la plateforme AceData Cloud
Rendez-vous sur la page ShortURL API
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/ShortURLMCP.git
cd ShortURLMCP
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’outil	Description
`shorturl_create`	Raccourcir une seule URL
`shorturl_batch_create`	Raccourcir plusieurs URL en lot (jusqu’à 10)
`shorturl_get_usage_guide`	Obtenir le guide d’utilisation complet
`shorturl_get_api_info`	Obtenir 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

Dépôt GitHub : AceDataCloud/ShortURLMCP
Package PyPI : mcp-shorturl
Documentation API : API de génération de liens courts

​Aperçu des fonctionnalités

​Prérequis

​Installation et configuration

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

​Méthode 2 : installation depuis le code source

​Utilisation dans Claude Desktop

​Utilisation dans VS Code / Cursor

​Liste des outils disponibles

​Exemple d’utilisation

​Informations complémentaires