Redirhub Mcp Server

RedirHub MCP サーバー

AI アシスタントから、すべてのリンクを管理できます。 ブランドリンク、動的 QR コード、ドメインリダイレクト、ウェブサイト全体の移行を作成し、標準化されたプロトコルを通じて管理、監査、測定できます。Claude、ChatGPT、Cursor、あらゆる MCP クライアントと互換性があります。

RedirHub はリダイレクトインフラストラクチャです。この MCP サーバーにより、AI エージェントはダッシュボードを開かずに、そのインフラストラクチャへ直接アクセスできます。リンクの作成と管理、ドメインの接続、チームメンバーの招待、分析データの照会が可能です。

機能

• あらゆるリンクを統一モデルで管理：ブランドリンク、動的 QR コード、ドメインリダイレクト、ウェブサイト移行は、ダッシュボードと同様に、意図に応じて作成され、同じ種類のオブジェクトとして管理されます。
• エージェントから共有できる QR コード：create-qr-code と get-qr-code は、ダッシュボードとまったく同じ方法で生成された QR コード画像そのものを返します。
• 安全な一括変更：一括操作ツールはデフォルトでプレビューを表示し、そのプレビューから取得した確認トークンを使った場合にのみ変更を適用します。
• ダッシュボードと同じルール：ここで作成または更新したリンクには、ダッシュボードや 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. アシスタントが使用するワークスペースを選択します。各接続で使用できるワークスペースは1つです。
3. 許可する操作（以下を参照）を選択し、アクセスを許可を選びます。

アシスタントはアカウント → AI アシスタント（account.redirhub.com/mcp）に表示されます。あなた、またはワークスペースの管理者は、ここから接続を解除できます。接続を解除すると、アクセス権はただちに取り消されます。作成済みのリンクはそのまま残ります。

アシスタントに表示されるのは、許可されたツールだけです。別のツールを呼び出すと、必要な権限を示すエラーが返されます。追加の権限を許可するには、アシスタントの接続を解除して、再接続してください。

クライアント開発者向け：サーバーはMCP 認可仕様に準拠しています。トークンのないリクエストには、保護されたリソースのメタデータ（https://mcp.redirhub.com/.well-known/oauth-protected-resource）を示すWWW-Authenticateヘッダーとともに401が返されます。認可サーバーはhttps://account.redirhub.comです（メタデータは/.well-known/oauth-authorization-server）。以下をサポートしています。

• 動的クライアント登録（/oauth/register）；
• PKCE（S256）を使った認可コードフロー；
• リフレッシュトークン。

アクセストークンの有効期間は1時間、リフレッシュトークンの有効期間は30日です。

API トークン

サインインできないスクリプトやクライアントの場合は、dash.redirhub.com（設定 → API トークン）でワークスペース API トークンを生成し、Bearer トークンとして渡します。

Authorization: Bearer ***

API トークンではすべてのツールを利用できます。トークンを作成したワークスペースで、あなたのロールの範囲内で動作します。リンクやドメインの変更にはエディターロールが必要です。ワークスペース設定やメンバーの管理には管理者ロールが必要です。

どちらの方法も、Free を含むすべてのプランで利用できます。

サーバー情報

• 名前： Redirect Infra Public API
• バージョン： 1.2.0
• トランスポート： Streamable HTTP（JSON-RPC 2.0）

データモデル

ユーザーはワークスペース（組織）に所属します。ワークスペースにはカスタムドメイン（ホスト）とリンクがあります。

リンクは4種類の目的から作成されますが、管理時は1種類のオブジェクトとして扱われます。

各リンクにはid（例：link_7bXmR4）があり、get-link、update-link、delete-link、get-qr-code、get-link-historyツールで指定します。ドメインはホスト名、メンバーはid（例：user_zwbJjgb8）で指定します。

ツール

リンク：読み取り

リンク：作成

ブランドリンクと QR コードに使用できるドメインを見つけるには、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は、同じユーザーが同じワークスペースで過去 1～2 時間以内に、まったく同じ引数に対して発行されたトークンがない場合、変更の適用を拒否します。

ドメイン

ワークスペースとメンバー

アカウント

📊 統計

QR コード

create-qr-code と get-qr-code は、ダッシュボードでの描画とまったく同じコードを 512 px の PNG として返します。モジュール、色、余白、ワークスペースのロゴ、下部に表示される読みやすいリンクも同じです。コードには ?utm_source=qr が付いたリンクが含まれるため、スキャンはクリックと分けて集計されます。

印刷用ファイルには、REST API から同じコードを SVG、または幅 512、1024、2048 px の PNG で取得できます：

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 に対応付け、レビュー済みのドライランとして 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 エージェントに伝えます。

「acme.com/menu に移動する go.acme.co のメニュー用 QR コードを作成して、表示してください。」

「old.acme.co を 301 で acme.com にリダイレクトし、パスを維持してください。」

「旧サイトのこれらの 500 個の URL を新しいサイトに移行してください。」

「過去 4 週間クリックされていない go.acme.co 上のリンクはいくつありますか？そのドメイン上のリンクをすべて一時停止してください。」

「go.acme.co/spring の転送先を変更したのは誰ですか？また、それはいつですか？」

ドキュメント

• API リファレンス：RedirHub API の完全なドキュメント
• dash.redirhub.com：ウェブダッシュボード
• MCP 仕様：プロトコルのドキュメント

RedirHub が開発：リンク切れが許されないチームのためのリダイレクトインフラストラクチャ。