> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ShortURL MCP 接続ガイド

> shorturl MCP 服务器集成

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

## 機能概要

ShortURL MCP Server は以下の主要機能を提供します：

* **単一リンク短縮** — 長い URL を短くて共有しやすい短縮リンクに変換
* **一括リンク短縮** — 複数の URL を一度に短縮（最大 10 件）
* **使用ガイド** — 完全な使用説明とベストプラクティスの取得
* **API 情報** — API サービスの詳細とエラーコードの説明確認

## 事前準備

利用前に XHuoAPI API トークンを取得してください：

1. [XHuoAPI プラットフォーム](https://api.xhuoapi.ai) に登録またはログイン
2. [ShortURL API](https://api.xhuoapi.ai/documents/short-url) ページへ移動
3. 「Acquire」をクリックして API トークンを取得（初回申請時に無料枠付与）

## インストールと設定

### 方法1：pip インストール（推奨）

```bash theme={null}
pip install mcp-shorturl
```

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

```bash theme={null}
git clone https://github.com/XHuoAPI/ShortURLMCP.git
cd ShortURLMCP
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`

以下の設定を追加してください：

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

`uvx`（事前インストール不要）を使用する場合：

```json theme={null}
{
  "mcpServers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

設定を保存して Claude Desktop を再起動すると、会話内で ShortURL 関連ツールが利用可能になります。

## VS Code / Cursor での利用方法

プロジェクトのルートディレクトリに `.vscode/mcp.json` を作成します：

```json theme={null}
{
  "servers": {
    "shorturl": {
      "command": "mcp-shorturl",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

または `uvx` を使用する場合：

```json theme={null}
{
  "servers": {
    "shorturl": {
      "command": "uvx",
      "args": ["mcp-shorturl"],
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}
```

## 利用可能なツール一覧

| ツール名                       | 説明                    |
| -------------------------- | --------------------- |
| `shorturl_create`          | 単一 URL を短縮            |
| `shorturl_batch_create`    | 複数 URL を一括短縮（最大 10 件） |
| `shorturl_get_usage_guide` | 完全な使用ガイドを取得           |
| `shorturl_get_api_info`    | API サービスの詳細を取得        |

## 使用例

設定完了後、AI クライアント内で自然言語で以下のように呼び出せます：

* 「このリンクを短縮してください」
* 「この5つの URL を一括で短縮して」
* 「共有用の短縮リンクを作成して」

## さらに詳しく

* GitHub リポジトリ：[XHuoAPI/ShortURLMCP](https://github.com/XHuoAPI/ShortURLMCP)
* PyPI パッケージ：[mcp-shorturl](https://pypi.org/project/mcp-shorturl/)
* API ドキュメント：[短縮リンク生成 API](https://api.xhuoapi.ai/documents/short-url)