byrdocs-shortlink
llm.txt

BYR Docs 短链接服务

通过 REST 或 MCP 创建短链，相同链接自动去重。创建需鉴权，跳转公开。

01在线试用

填入鉴权 token 与目标链接，实时创建一条真实短链。创建短链必须携带 token—— 这正是 Agent 调用时使用的同一凭证。

POST /api/shorten

token 仅保存在本标签页（sessionStorage），关闭后清除；同时会自动填入下方代码示例。

02鉴权

创建短链的所有入口（REST 与 MCP）都要求 Authorization: Bearer <token>， token 即 Worker 的 MCP_AUTH_TOKEN 密钥。仅跳转端点公开。 

# 生成一个随机密钥并设置到 Worker
openssl rand -hex 32
npx wrangler secret put MCP_AUTH_TOKEN
Authorization: Bearer YOUR_TOKEN

03REST API

适合脚本、后端服务或网页直接调用。

GET /<code> 公开 302 跳转到原始链接
POST /api/shorten 需 token 创建短链（去重） 
curl -X POST https://go.byrdocs.org/api/shorten \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/very/long/path"}'
{
  "code": "aZ3kQ9p",
  "short_url": "https://go.byrdocs.org/aZ3kQ9p",
  "target_url": "https://example.com/very/long/path",
  "deduplicated": false  // 命中已存在短链时为 true
}
401缺少或无效的 token
400请求体非法 JSON / 缺少 url / 非 http(s) 链接
200创建成功，返回短链信息

04MCP 接入

MCP 端点采用 Streamable HTTP 传输，需在请求头携带 Bearer token。 连接后 Agent 可调用以下工具。

POST /mcp 需 token Streamable HTTP

toolcreate_short_link

为给定链接创建短链并返回短链 URL，相同链接自动去重。

urlstring完整链接，含 http:// 或 https://

toollookup_short_link

查询某链接是否已有短链，存在则返回，不创建新记录。

urlstring要查询的完整链接
// claude_desktop_config.json
{
  "mcpServers": {
    "byrdocs-shortlink": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://go.byrdocs.org/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}
# 任意支持本地 stdio 的客户端可借 mcp-remote 代理到远程
npx mcp-remote https://go.byrdocs.org/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"
# 用官方 Inspector 调试：URL 填 https://go.byrdocs.org/mcp
# 在 Authentication 里设置 Header: Authorization = Bearer YOUR_TOKEN
npx @modelcontextprotocol/inspector@latest
去重语义：无论通过 REST 还是 MCP，对同一链接多次创建都会返回相同短码， 响应中的 deduplicated 字段标记此次是否命中了已有短链。短链不支持删除。