Zip1

• 短縮
• API
• MCP
• 統計
• お問い合わせ

🤖 AI連携 (MCP)

Model Context Protocol (MCP) を通じて、ClaudeなどのAIアシスタントから直接zip1.ioを利用できます。自然言語のコマンドを使って、URLの短縮、分析データの取得、リンクの管理が可能です。

🤖

AIによるURL管理

AIと話すように、URL短縮サービスと対話できます

• ✨ 自然言語インターフェース - APIの構文は不要
• ⚡ AIアシスタントから即座にURLを短縮
• 📊 簡単なプロンプトでオンデマンドの分析データを取得
• 🔒 会話形式でパスワード保護リンクを作成

⚡ クイックセットアップ

Claude Codeの場合（推奨）

Claude CodeはCLIから直接HTTP MCPサーバーをサポートしています。次のコマンドを実行するだけです：

ターミナル

claude mcp add --transport http zip1 http://zip1.io/mcp

インストールを確認：

ターミナル

claude mcp list

✅ 以上です！ これでClaude Codeから直接zip1.ioを利用できます。

Claude Desktopの場合

⚠️ プロキシが必要です： Claude DesktopはHTTPサーバーではなく、stdioベースのMCPサーバーのみをサポートしています。接続をブリッジするためにローカルプロキシが必要です。

オプション1: mcp-client-cliを使用する（推奨）

MCPクライアントCLIツールをインストールして、stdioをHTTPにブリッジします：

ターミナル

npm install -g @modelcontextprotocol/client-cli

次に、Claude Desktopの設定ファイルを編集します：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します：

claude_desktop_config.json

{
  "mcpServers": {
    "zip1": {
      "command": "mcp-client",
      "args": ["http://zip1.io/mcp"]
    }
  }
}

Claude Desktopを再起動すると、zip1.ioのツールが利用可能になります。

オプション2: カスタムNode.jsプロキシ

上級ユーザー向けに、カスタムのstdio-to-HTTPブリッジスクリプトを作成します：

zip1-mcp-proxy.js

#!/usr/bin/env node
const https = require('https');
const readline = require('readline');

const MCP_URL = 'http://zip1.io/mcp';

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  terminal: false
});

rl.on('line', (line) => {
  const request = JSON.parse(line);

  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    }
  };

  const req = https.request(MCP_URL, options, (res) => {
    let data = '';
    res.on('data', (chunk) => data += chunk);
    res.on('end', () => {
      console.log(data);
    });
  });

  req.on('error', (error) => {
    console.error(JSON.stringify({
      jsonrpc: '2.0',
      id: request.id,
      error: { code: -32000, message: error.message }
    }));
  });

  req.write(JSON.stringify(request));
  req.end();
});

実行可能にして、Claude Desktopの設定に追加します：

ターミナル

chmod +x zip1-mcp-proxy.js

{
  "mcpServers": {
    "zip1": {
      "command": "node",
      "args": ["/path/to/zip1-mcp-proxy.js"]
    }
  }
}

⚙️ サーバー設定

zip1.io MCPサーバーは、MCP互換クライアントが接続できるHTTPエンドポイントとして利用可能です。

サーバー詳細

設定項目	値
サーバーURL	http://zip1.io/mcp
トランスポート	HTTP (ストリーミング可能)
プロトコルバージョン	MCP 2024-11-05
メッセージ形式	JSON-RPC 2.0
認証	なし（レート制限あり）
レート制限	IPごとに30リクエスト/分
利用可能なツール	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

他のMCPクライアントでの使用

HTTPトランスポートをサポートするMCP互換クライアントであれば、zip1.ioに接続できます。以下に例を示します：

直接HTTPリクエスト (curl)

利用可能なツール一覧

curl -X POST http://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

短縮URLの作成

curl -X POST http://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_short_url",
      "arguments": {
        "url": "https://example.com",
        "alias": "my-link"
      }
    }
  }'

Pythonクライアントの例

Pythonスクリプト

import requests

MCP_URL = "http://zip1.io/mcp"

def call_mcp_tool(tool_name, arguments):
    payload = {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": tool_name,
            "arguments": arguments
        }
    }

    response = requests.post(MCP_URL, json=payload)
    return response.json()

# Example usage
result = call_mcp_tool("create_short_url", {
    "url": "https://github.com/anthropics/claude-mcp",
    "alias": "mcp-docs"
})

print(result)

セルフホスト設定

zip1.ioの独自インスタンスを実行している場合は、クライアントがそのインスタンスを指すように設定します：

Claude Code

claude mcp add --transport http zip1 https://your-domain.com/mcp

Claude Desktop (mcp-client使用)

{
  "mcpServers": {
    "zip1-local": {
      "command": "mcp-client",
      "args": ["http://localhost:8000/mcp"]
    }
  }
}

💬 会話例

Claudeで使用できる自然言語プロンプトの例をいくつか紹介します：

短縮URLの作成

プロンプト

"Shorten https://github.com/anthropics/claude-mcp for me"

Claudeの応答:
✅ 短縮URLが作成されました: https://zip1.io/\[code\]
🔤 生成されたコード: [code]
🔗 元のURL: https://github.com/anthropics/claude-mcp
📊 統計を見る: https://zip1.io/stats/\[code\]

カスタムエイリアスとパスワード

プロンプト

"Create a short URL for https://docs.myapp.com with alias 'docs' and password 'team2024'"

Claudeの応答:
✅ 短縮URLが作成されました: https://zip1.io/docs
📝 カスタムエイリアス: docs
🔒 パスワード保護: はい
🔗 元のURL: https://docs.myapp.com

分析データの取得

プロンプト

"Show me the stats for short code 'docs'"

Claudeの応答:
📊 統計情報: https://zip1.io/docs
👆 総クリック数: 127
👤 ユニーククリック数: 89
🔒 パスワード保護: はい
📅 作成日: 2024-01-15T10:30:00

🌍 上位の国:
1. アメリカ合衆国: 54クリック
2. イギリス: 23クリック
3. カナダ: 18クリック

URL検証

プロンプト

"Can I shorten ftp://myserver.com/file.zip?"

Claudeの応答:
❌ URLが無効です: http:// または https:// プロトコルと有効なドメインを含める必要があります

🛠️ 利用可能なツール

zip1.io MCPサーバーは、Claudeが使用できる4つのツールを提供します：

ツール	説明	使用例
create_short_url	オプションのカスタムエイリアス、パスワード、最大クリック数で短縮URLを作成	"このURLをエイリアス 'mylink' で短縮して"
get_url_stats	クリック数、国、タイムスタンプを含む詳細な分析データを取得	"短縮コード 'abc123' の統計を取得して"
validate_url	URLが有効で短縮可能かどうかを確認	"example.comを短縮できますか？"
generate_short_code	ランダムな短縮コードの候補を生成	"ランダムな短縮コードを生成して"

🔧 技術詳細

MCPエンドポイント

GET /mcp

サーバー情報、利用可能なツール、設定詳細を返します。

プロトコル情報

• プロトコルバージョン: MCP 2024-11-05
• トランスポート: ストリーミング可能なHTTP
• メッセージ形式: JSON-RPC 2.0
• レート制限: IPごとに毎分30リクエスト

セキュリティ

• すべての通信はHTTPS暗号化を使用
• パスワードは保存前にbcryptでハッシュ化
• レート制限により悪用を防止
• REST APIと同じセキュリティ基盤

💡 ユースケース

📝 コンテンツ作成

AIアシスタントを離れることなく、ブログ記事、ドキュメント、ソーシャルメディアコンテンツの作成中に短縮URLを生成します。

📊 クイック分析

会話中にリンクのパフォーマンスを尋ねます。「キャンペーンリンクのクリック数は？」

🔐 安全な共有

チームチャットで機密情報を共有する際に、その場でパスワード保護リンクを作成します。

🎯 キャンペーン管理

自然言語コマンドで、マーケティングキャンペーン用のカスタムエイリアスURLを作成します。

🔍 トラブルシューティング

レート制限エラー？

• MCPエンドポイントには毎分30リクエストの制限があります
• 1分待ってから再試行してください

Claude Codeにツールが表示されない？

• MCPサーバーのURLにアクセスできることを確認してください
• ブラウザで http://zip1.io/mcp にアクセスしてみてください
• claude mcp list でMCP設定を確認してください

📚 リソースとドキュメント

• 公式MCPドキュメント - Model Context Protocolの詳細
• MCP Python SDK - 独自のMCPサーバーを構築
• REST APIドキュメント - 従来のAPIアクセス

始める準備はできましたか？

今すぐzip1.ioをClaude Codeに追加して、AIでURL短縮を始めましょう

クイックセットアップ