Zip1

• 縮短
• API
• MCP
• 統計
• 聯絡我們

🤖 AI 整合 (MCP)

透過 模型上下文協定 (MCP)，直接從 Claude 等 AI 助理使用 zip1.io。使用自然語言指令縮短網址、擷取分析資料及管理連結。

🤖

AI 驅動的網址管理

像與 AI 對話一樣與您的網址縮短服務交談

• ✨ 自然語言介面 - 無需 API 語法
• ⚡ 從您的 AI 助理即時縮短網址
• 📊 透過簡單的提示詞隨需取得分析資料
• 🔒 以對話方式建立受密碼保護的連結

⚡ 快速設定

適用於 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 僅支援基於 stdio 的 MCP 伺服器，不支援 HTTP 伺服器。您需要一個本機代理來橋接連線。

選項 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 到 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 伺服器以 HTTP 端點形式提供，任何相容於 MCP 的用戶端都可以連線。

伺服器詳細資訊

設定項目	值
伺服器網址	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": {}
  }'

建立短網址

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 一起使用的自然語言提示詞：

建立短網址

提示詞

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

Claude 的回應：
✅ 短網址已建立：https://zip1.io/\[code\]
🔤 產生的代碼：[code]
🔗 原始網址：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 的回應：
✅ 短網址已建立：https://zip1.io/docs
📝 自訂別名：docs
🔒 受密碼保護：是
🔗 原始網址：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 次點擊

網址驗證

提示詞

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

Claude 的回應：
❌ 網址無效：必須包含 http:// 或 https:// 通訊協定以及有效的網域

🛠️ 可用工具

zip1.io MCP 伺服器提供四個 Claude 可以使用的工具：

工具	說明	使用範例
create_short_url	建立縮短的網址，可選擇自訂別名、密碼和最大點擊次數	"用別名 'mylink' 縮短這個網址"
get_url_stats	擷取詳細分析資料，包括點擊次數、國家/地區和時間戳記	"取得短代碼 'abc123' 的統計資料"
validate_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 助理。

📊 快速分析

在對話中查詢連結成效。「我的行銷活動連結獲得了多少次點擊？」

🔐 安全分享

在團隊聊天中分享敏感資訊時，即時建立受密碼保護的連結。

🎯 行銷活動管理

使用自然語言指令，為行銷活動建立自訂別名的網址。

🔍 疑難排解

出現速率限制錯誤？

• MCP 端點每分鐘有 30 個請求的限制
• 請等待一分鐘後再試

工具未出現在 Claude Code 中？

• 確保 MCP 伺服器網址可以存取
• 嘗試在瀏覽器中造訪 http://zip1.io/mcp
• 使用 claude mcp list 驗證您的 MCP 設定

📚 資源與文件

• 官方 MCP 文件 - 深入了解模型上下文協定
• MCP Python SDK - 建置您自己的 MCP 伺服器
• REST API 文件 - 傳統 API 存取

準備好開始使用了嗎？

立即將 zip1.io 加入 Claude Code，開始使用 AI 縮短網址

快速設定