Saltar al contenido 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) es un protocolo de contexto de modelo lanzado por Anthropic, que permite a modelos de IA (como Claude, GPT, etc.) llamar a herramientas externas a través de una interfaz estandarizada. Mediante el ShortURL MCP Server proporcionado por AceData Cloud, puedes generar enlaces cortos directamente en clientes de IA como Claude Desktop, VS Code, Cursor, entre otros.

​
Resumen de Funcionalidades

El ShortURL MCP Server ofrece las siguientes funciones principales:
  • Acortamiento de un solo enlace — Convierte URLs largas en enlaces cortos fáciles de compartir
  • Acortamiento masivo de enlaces — Acorta múltiples URLs a la vez (hasta 10)
  • Guía de uso — Obtén instrucciones completas y mejores prácticas
  • Información de API — Consulta detalles del servicio API y códigos de error

​
Requisitos Previos

Antes de usar, necesitas obtener el Token API de AceData Cloud:
  1. Regístrate o inicia sesión en la plataforma AceData Cloud
  2. Ve a la página de la API ShortURL
  3. Haz clic en «Acquire» para obtener el Token API (la primera solicitud incluye crédito gratuito)

​
Instalación y Configuración

​
Método 1: Instalación con pip (recomendado)

pip install mcp-shorturl

​
Método 2: Instalación desde código fuente

git clone https://github.com/AceDataCloud/MCPShortURL.git
cd MCPShortURL
pip install -e .
Una vez instalado, puedes iniciar el servicio con el comando mcp-shorturl.

​
Uso en Claude Desktop

Edita el archivo de configuración de Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Agrega la siguiente configuración: 
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Tu Token API"
      }
    }
  }
}
Si usas uvx (sin necesidad de instalar paquetes previamente): 
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Tu Token API"
      }
    }
  }
}
Guarda la configuración y reinicia Claude Desktop para usar las herramientas ShortURL en las conversaciones.

​
Uso en VS Code / Cursor

Crea el archivo .vscode/mcp.json en la raíz del proyecto: 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Tu Token API"
      }
    }
  }
}
O usa uvx: 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "Tu Token API"
      }
    }
  }
}

​
Lista de Herramientas Disponibles

Nombre de la herramientaDescripción
shorturl_createAcorta una sola URL
shorturl_batch_createAcorta múltiples URLs (hasta 10)
shorturl_get_usage_guideObtiene la guía completa de uso
shorturl_get_api_infoObtiene detalles del servicio API

​
Ejemplos de Uso

Después de configurar, puedes llamar a estas funciones directamente en el cliente de IA usando lenguaje natural, por ejemplo:
  • «Ayúdame a acortar este enlace»
  • «Acorta estos 5 URLs en lote»
  • «Genera un enlace corto para compartir»

​
Más Información