メインコンテンツへスキップ
MCP(Model Context Protocol) は Anthropic によって開発されたモデルコンテキストプロトコルで、Claude や GPT などの AI モデルが標準化されたインターフェースを通じて外部ツールを呼び出すことを可能にします。AceData Cloud が提供する ShortURL MCP Server を使えば、Claude Desktop、VS Code、Cursor などの AI クライアント内で直接短縮リンクを生成できます。

機能概要

ShortURL MCP Server は以下の主要機能を提供します:
  • 単一リンク短縮 — 長い URL を短くて共有しやすい短縮リンクに変換
  • 一括リンク短縮 — 複数の URL を一度に短縮(最大 10 件)
  • 使用ガイド — 完全な使用説明とベストプラクティスの取得
  • API 情報 — API サービスの詳細とエラーコードの説明確認

事前準備

利用前に AceData Cloud API トークンを取得してください:
  1. AceData Cloud プラットフォーム に登録またはログイン
  2. ShortURL API ページへ移動
  3. 「Acquire」をクリックして API トークンを取得(初回申請時に無料枠付与)

インストールと設定

方法1:pip インストール(推奨)

pip install mcp-shorturl

方法2:ソースコードからインストール

git clone https://github.com/AceDataCloud/MCPShortURL.git
cd MCPShortURL
pip install -e .
インストール完了後、mcp-shorturl コマンドでサービスを起動できます。

Claude Desktop での利用方法

Claude Desktop の設定ファイルを編集します:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
以下の設定を追加してください:
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
uvx(事前インストール不要)を使用する場合:
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
設定を保存して Claude Desktop を再起動すると、会話内で ShortURL 関連ツールが利用可能になります。

VS Code / Cursor での利用方法

プロジェクトのルートディレクトリに .vscode/mcp.json を作成します:
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
または uvx を使用する場合:
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

利用可能なツール一覧

ツール名説明
shorturl_create単一 URL を短縮
shorturl_batch_create複数 URL を一括短縮(最大 10 件)
shorturl_get_usage_guide完全な使用ガイドを取得
shorturl_get_api_infoAPI サービスの詳細を取得

使用例

設定完了後、AI クライアント内で自然言語で以下のように呼び出せます:
  • 「このリンクを短縮してください」
  • 「この5つの URL を一括で短縮して」
  • 「共有用の短縮リンクを作成して」

さらに詳しく