Saltar para o conteúdo principal

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) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas por meio de uma interface padronizada. Com o ShortURL MCP Server fornecido pela XHuoAPI, você pode gerar links curtos diretamente em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

​
Visão Geral das Funcionalidades

O ShortURL MCP Server oferece as seguintes funcionalidades principais:
  • Encurtamento de link único — Converte URLs longas em links curtos fáceis de compartilhar
  • Encurtamento em lote — Encurta múltiplos URLs de uma vez (até 10)
  • Guia de uso — Obtenha instruções completas e melhores práticas
  • Informações da API — Consulte detalhes do serviço API e códigos de erro

​
Preparação

Antes de usar, você precisa obter o Token da API da XHuoAPI:
  1. Registre-se ou faça login na plataforma XHuoAPI
  2. Acesse a página da API ShortURL
  3. Clique em “Acquire” para obter o Token da API (a primeira solicitação concede uma cota gratuita)

​
Instalação e Configuração

​
Método 1: Instalação via pip (recomendado)

pip install mcp-shorturl

​
Método 2: Instalação via código-fonte

git clone https://github.com/XHuoAPI/ShortURLMCP.git
cd ShortURLMCP
pip install -e .
Após a instalação, você pode iniciar o serviço com o comando mcp-shorturl.

​
Uso no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Adicione a seguinte configuração: 
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}
Se usar uvx (sem necessidade de instalar pacotes antecipadamente): 
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}
Salve a configuração e reinicie o Claude Desktop para usar as ferramentas ShortURL nas conversas.

​
Uso no VS Code / Cursor

Crie o arquivo .vscode/mcp.json na raiz do projeto: 
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}
Ou utilize uvx: 
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "seu API Token"
      }
    }
  }
}

​
Lista de Ferramentas Disponíveis

Nome da FerramentaDescrição
shorturl_createEncurta um único URL
shorturl_batch_createEncurta múltiplos URLs (até 10)
shorturl_get_usage_guideObtém o guia completo de uso
shorturl_get_api_infoObtém detalhes do serviço API

​
Exemplos de Uso

Após configurar, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:
  • “Me ajude a encurtar este link”
  • “Encurte estes 5 URLs em lote”
  • “Gere um link curto para compartilhar”

​
Mais Informações