Redirhub Mcp Server

RedirHub MCP 服务

通过 AI 助手管理每一个链接。 创建品牌链接、动态二维码、域名重定向和整站迁移，然后通过标准化协议管理、审计和衡量它们，并兼容 Claude、ChatGPT、Cursor 及任何 MCP 客户端。

RedirHub 是重定向基础设施。此 MCP 服务让 AI Agent 可以直接使用该基础设施：创建和管理链接、连接域名、邀请团队成员并查询分析数据，全程无需打开控制面板。

功能

• 统一管理各种链接：品牌链接、动态二维码、域名重定向和网站迁移均可按意图创建，并像在控制面板中一样作为同一种对象进行管理。
• 可供 Agent 直接使用的二维码：create-qr-code 和 get-qr-code 会返回二维码图像，呈现效果与控制面板完全一致。
• 安全批量更改：批量工具默认只预览，只有使用预览生成的确认令牌才会应用更改。
• 规则与控制面板一致：在此创建或更新的链接，均遵循与控制面板和 REST API 相同的验证规则、套餐功能和限制。
• 分析与日志：查询点击统计、原始访问日志以及每个链接的更改历史。
• 团队协作：支持多成员工作区，并提供基于角色的访问控制。
• 登录即可使用，无需复制令牌：助手通过 OAuth 连接。登录 RedirHub，选择工作区并设置助手可以执行的操作；也可随时断开连接。
• MCP 协议：适用于 Claude、ChatGPT、Cursor、Cline 以及任何可调用工具的 MCP 客户端。

端点

https://mcp.redirhub.com

旧地址 https://mcp.redirhub.com/mcp/v1 仍可使用。

身份验证

使用 OAuth 登录（推荐）

将端点添加到助手后，它会引导你前往 RedirHub 登录。无需复制令牌：

1. 登录 RedirHub（或切换账户）。
2. 选择助手要使用的工作区。每个连接仅适用于一个工作区。
3. 选择助手可以执行的操作（见下文），然后选择允许访问。

随后，助手会显示在账户 → AI 助手（account.redirhub.com/mcp）中，你或工作区管理员可以断开它的连接。断开连接后，其访问权限会立即撤销；它创建的链接仍会保留。

助手只能看到已授予它的工具。调用其他工具会返回错误，指出所需的权限；若要授予更多权限，请断开助手的连接后重新连接。

对于客户端开发者：服务遵循 MCP authorization spec。不带令牌的请求会收到 401 响应，其中包含指向受保护资源元数据（https://mcp.redirhub.com/.well-known/oauth-protected-resource）的 WWW-Authenticate 标头。授权服务器为 https://account.redirhub.com（元数据位于 /.well-known/oauth-authorization-server）。它支持：

• 动态客户端注册（/oauth/register）；
• 使用 PKCE（S256）的授权码流程；
• 刷新令牌。

访问令牌有效期为一小时，刷新令牌有效期为 30 天。

API 令牌

对于无法登录的脚本和客户端，请从 dash.redirhub.com（设置 → API 令牌）生成 Workspace API 令牌，并将其作为 Bearer 令牌传递：

Authorization: Bearer ***

API 令牌拥有所有工具的权限。它会在创建时指定的工作区内，按你的角色执行操作：更改链接和域名需要编辑者角色；工作区设置和成员管理需要管理员角色。

两种方式均适用于所有套餐，包括 Free。

服务信息

• 名称： Redirect Infra Public API
• 版本： 1.2.0
• 传输方式： Streamable HTTP（JSON-RPC 2.0）

数据模型

用户属于工作区（组织）。工作区包含自定义域名（主机）和链接。

链接由四种意图创建，但作为同一种对象管理：

每个链接都有一个 id（例如 link_7bXmR4），get-link、update-link、delete-link、get-qr-code 和 get-link-history 工具均使用该 ID。域名通过主机名指定，成员通过 id 指定（例如 user_zwbJjgb8）。

工具

链接：读取

链接：创建

使用 list-hosts 并设置 short_links_enabled: true，即可查找可用于品牌链接和二维码的域名。

链接：管理

⚠️ 批量操作安全

bulk-update-links、bulk-delete-links 和 bulk-import 仅会预览，除非调用时设置 dry_run: false：

1. 不带 dry_run 调用。预览会返回受影响的数量、部分受影响的 URL，以及变更和删除操作的 confirmation_token。
2. 向用户显示数量。
3. 只有在用户确认后，才使用相同的参数再次调用，并设置 dry_run: false 和 confirmation_token。

服务端会强制执行此要求：bulk-update-links、bulk-delete-links 和处于 upsert 模式的 bulk-import，如果没有针对完全相同的参数、由同一用户在同一工作区内于最近一至两小时签发的令牌，就会拒绝应用变更。

域名

工作区与成员

账户

📊 统计数据

二维码

create-qr-code 和 get-qr-code 会返回 512 px 的 PNG 格式二维码，绘制效果与控制面板完全一致：相同的码点、颜色、边距、工作区徽标，以及下方易读的链接。二维码编码的链接带有 ?utm_source=qr，因此扫码和点击会分别计数。

对于打印文件，REST API 可将同一二维码作为 SVG 或 PNG 提供（宽度为 512、1024 或 2048 px）：

GET https://api.redirhub.com/v1/links/{id}/qr              # SVG
GET https://api.redirhub.com/v1/links/{id}/qr?format=png&width=2048

资源

能够附加 MCP 资源的客户端也可以将相同数据作为资源读取（通过 ?key=value 的形式附加查询参数）：redirects://list、redirects://link_{id}、redirects://count、links://list、links://link_{id}、hosts://list、hosts://{hostname}、workspace://current、members://list、members://{user_id}、account://me、plugins://catalog 和 record-types://catalog。

大多数客户端只允许模型调用工具，因此优先使用上面的工具；这些工具涵盖了资源的全部功能。

重命名的工具

1.1 版本移除了 -tool 后缀，并将记录工具改为按链接命名。旧名称仍可使用，因此现有配置不会受影响，但新的提示词和集成应使用新名称：

1.1 版本中的其他更改：

• 创建工具会返回链接。 create-redirect 以前会将其包装在 {created, record} 中。
• 批量工具默认会预览。 以前除非另有说明，否则会直接应用更改。
• bulk-update-links 需要筛选条件或 all_links: true。 以前会更改工作区中的所有记录。

面向 Cursor 和 Claude 的插件

此仓库也是一个可安装的插件。它将上述 MCP 服务与 website-migration 技能打包在一起，引导助手安全地迁移网站：收集旧 URL，将每个旧 URL 映射到新 URL，以经过审核的试运行方式导入 301 重定向，将旧域名的 DNS 指向 RedirHub，并在上线后检查是否有遗漏的路径。

示例：“我们要将 old-shop.com 迁移到 www.newshop.com。这是站点地图——请映射旧 URL 并设置重定向。”

快速开始

1. 将服务添加到你的助手

Claude（claude.ai、Claude Desktop）：Settings → Connectors → Add custom connector，将其命名为 RedirHub，并粘贴 https://mcp.redirhub.com。

ChatGPT：Settings → Apps & Connectors，使用相同的 URL 添加自定义连接器。

Cursor：Settings → MCP → Add new MCP server，或在 mcp.json 中添加：

{
  "mcpServers": {
    "redirhub": {
      "url": "https://mcp.redirhub.com"
    }
  }
}

任何其他 MCP 客户端：添加一个使用相同 URL 的远程（Streamable HTTP）服务。若要在终端中试用：

npx @modelcontextprotocol/inspector --transport http --server-url https://mcp.redirhub.com

2. 登录并选择权限

你的助手会打开 RedirHub：登录、选择工作区和权限，然后选择 Allow access。随后你会返回助手，且已成功连接。

{
  "mcpServers": {
    "redirhub": {
      "url": "https://mcp.redirhub.com",
      "headers": {
        "Authorization": "Bearer rh_YOUR_API_TOKEN"
      }
    }
  }
}

3. 开始使用

连接后，告诉你的 AI Agent 你需要什么：

“在 go.acme.co 上为我们的菜单创建一个二维码，指向 acme.com/menu，并展示给我。”

“将 old.acme.co 通过 301 重定向到 acme.com，并保留路径。”

“将旧网站上的这 500 个 URL 迁移到新网站。”

“过去四周，go.acme.co 上有多少链接没有点击？暂停该域名下的所有链接。”

“是谁更改了 go.acme.co/spring 的目标地址？什么时候更改的？”

文档

• API 参考：完整的 RedirHub API 文档
• dash.redirhub.com：Web 控制面板
• MCP 规范：协议文档

由 RedirHub 构建：为无法承受链接失效的团队提供重定向基础设施。