Claude Code + ShortURL MCP: Generate Short Links in One Sentence in the Terminal

📘 Complete Guide: Use All 11 AceData Cloud MCPs in Claude Code →

When writing documentation, PR descriptions, or sending links to colleagues, those super long GitHub permanent links or URLs with parameters are annoying to look at. By connecting to the ShortURL MCP Server, you can shorten long URLs into clean https://surl.id/xxxxx links with just one sentence in the Claude Code terminal.

Obtain API Token

Before using the ShortURL MCP Server, you need an AceData Cloud API Token:

  1. Open AceData Cloud Platform, which supports login via GitHub, Google, WeChat, email, or phone number. Register to get free quota.
  2. After logging in, you can see the API Token on the homepage. Click to copy it.
  3. When the quota is used up, go to Console → Recharge to top up. Supports Alipay, WeChat, Stripe.

AceData Cloud Platform Homepage Token

One Token can be used for all 11 MCP Servers, no need to apply separately for each service.

💡 Using claude.ai web version or Claude Desktop? They support OAuth one-click authorization, no need to manually fill in the Token. See Claude + ShortURL MCP Illustrated Tutorial for details.

Configure Claude Code

Run the following command in the terminal, replacing 你的Token with the API Token copied in the previous step:

claude mcp add shorturl --transport http https://shorturl.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer 你的Token"

⚠️ -H must be uppercase. Lowercase -h is --help, not a header parameter.

Without -s, the default scope is local, which only takes effect in the directory where the command is run. It is recommended to explicitly specify the scope:

Scope Command Parameter Configuration File Scope of Effect
local (default) no -s or -s local ~/.claude.json Only the project directory where the command is run
user -s user ~/.claude.json Global effect, available in all projects
project -s project .mcp.json in project root Current project, can be committed to git and shared with the team

💡 To share the same configuration with your team, add -s project: the configuration will be written to .mcp.json in the project root and can be used by teammates after cloning from git. Do not commit the real Token to public repositories. Use ${ENV_VAR} placeholders + environment variables instead.

Verify the configuration: run claude mcp list, you should see shorturl showing ✓ Connected.

Usage Scenarios

After configuration, you can directly call ShortURL in Claude Code conversations using natural language:

When writing commit messages or PR descriptions

You want to reference an issue or document link, but it's too long:

Shorten this issue link, I want to put it in the commit message

Batch processing links in README

shorturl_batch_create shortens multiple links at once:

Help me replace all super long external links in the README with short links

Query short link details

shorturl_get_api_info returns the original URL and other information of the short link:

Help me check the original address of this short link https://surl.id/xxxxx

Tool List

Tool Description
shorturl_create Generate short link
shorturl_batch_create Batch generate short links
shorturl_get_api_info Get API information
shorturl_get_usage_guide Get usage guide