Zip1

• Rút gọn
• API
• MCP
• Thống kê
• Liên hệ

🤖 Tích hợp AI (MCP)

Sử dụng zip1.io trực tiếp từ các trợ lý AI như Claude thông qua Model Context Protocol (MCP). Rút gọn URL, truy xuất phân tích và quản lý liên kết bằng các lệnh ngôn ngữ tự nhiên.

🤖

Quản lý URL bằng AI

Trò chuyện với trình rút gọn URL của bạn như trò chuyện với AI

• ✨ Giao diện ngôn ngữ tự nhiên - không cần cú pháp API
• ⚡ Rút gọn URL tức thì từ trợ lý AI của bạn
• 📊 Nhận phân tích theo yêu cầu với các lời nhắc đơn giản
• 🔒 Tạo liên kết được bảo vệ bằng mật khẩu qua hội thoại

⚡ Thiết lập nhanh

Dành cho Claude Code (Khuyến nghị)

Claude Code hỗ trợ máy chủ MCP HTTP trực tiếp qua CLI. Chỉ cần chạy:

Terminal

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

Xác minh cài đặt:

Terminal

claude mcp list

✅ Vậy là xong! Bạn có thể sử dụng zip1.io trực tiếp từ Claude Code.

Dành cho Claude Desktop

⚠️ Yêu cầu Proxy: Claude Desktop chỉ hỗ trợ máy chủ MCP dựa trên stdio, không hỗ trợ máy chủ HTTP. Bạn sẽ cần một proxy cục bộ để kết nối.

Tùy chọn 1: Sử dụng mcp-client-cli (Khuyến nghị)

Cài đặt công cụ CLI máy khách MCP để kết nối stdio với HTTP:

Terminal

npm install -g @modelcontextprotocol/client-cli

Sau đó chỉnh sửa tệp cấu hình Claude Desktop của bạn:

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

Thêm cấu hình này:

claude_desktop_config.json

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

Khởi động lại Claude Desktop và các công cụ zip1.io sẽ khả dụng.

Tùy chọn 2: Proxy Node.js tùy chỉnh

Dành cho người dùng nâng cao, tạo một tập lệnh kết nối stdio-to-HTTP tùy chỉnh:

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();
});

Làm cho nó có thể thực thi và thêm vào cấu hình Claude Desktop của bạn:

Terminal

chmod +x zip1-mcp-proxy.js

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

⚙️ Cấu hình máy chủ

Máy chủ MCP zip1.io khả dụng dưới dạng một điểm cuối HTTP mà bất kỳ máy khách tương thích MCP nào cũng có thể kết nối.

Chi tiết máy chủ

Mục cấu hình	Giá trị
URL máy chủ	http://zip1.io/mcp
Phương thức truyền	HTTP (Có thể truyền phát)
Phiên bản giao thức	MCP 2024-11-05
Định dạng tin nhắn	JSON-RPC 2.0
Xác thực	Không (giới hạn tốc độ)
Giới hạn tốc độ	30 yêu cầu/phút mỗi IP
Công cụ khả dụng	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Sử dụng với các máy khách MCP khác

Bất kỳ máy khách tương thích MCP nào hỗ trợ truyền tải HTTP đều có thể kết nối với zip1.io. Dưới đây là một số ví dụ:

Yêu cầu HTTP trực tiếp (curl)

Liệt kê các công cụ khả dụng

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

Tạo URL rút gọn

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"
      }
    }
  }'

Ví dụ về máy khách Python

Tập lệnh 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)

Cấu hình tự lưu trữ

Nếu bạn đang chạy phiên bản zip1.io của riêng mình, hãy cấu hình máy khách trỏ đến phiên bản của bạn:

Claude Code

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

Claude Desktop (với mcp-client)

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

💬 Ví dụ hội thoại

Dưới đây là một số lời nhắc ngôn ngữ tự nhiên bạn có thể sử dụng với Claude:

Tạo URL rút gọn

Prompt

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

Phản hồi của Claude:
✅ URL rút gọn đã tạo: https://zip1.io/\[code\]
🔤 Mã đã tạo: [code]
🔗 URL gốc: https://github.com/anthropics/claude-mcp
📊 Xem thống kê: https://zip1.io/stats/\[code\]

Bí danh tùy chỉnh & Mật khẩu

Prompt

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

Phản hồi của Claude:
✅ URL rút gọn đã tạo: https://zip1.io/docs
📝 Bí danh tùy chỉnh: docs
🔒 Được bảo vệ bằng mật khẩu: Có
🔗 URL gốc: https://docs.myapp.com

Nhận phân tích

Prompt

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

Phản hồi của Claude:
📊 Thống kê cho: https://zip1.io/docs
👆 Tổng số lần nhấp: 127
👤 Lần nhấp duy nhất: 89
🔒 Được bảo vệ bằng mật khẩu: Có
📅 Đã tạo: 2024-01-15T10:30:00

🌍 Các quốc gia hàng đầu:
1. Hoa Kỳ: 54 lần nhấp
2. Vương quốc Anh: 23 lần nhấp
3. Canada: 18 lần nhấp

Xác thực URL

Prompt

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

Phản hồi của Claude:
❌ URL không hợp lệ: Phải bao gồm giao thức http:// hoặc https:// và một tên miền hợp lệ

🛠️ Công cụ khả dụng

Máy chủ MCP zip1.io cung cấp bốn công cụ mà Claude có thể sử dụng:

Công cụ	Mô tả	Cách sử dụng ví dụ
create_short_url	Tạo URL rút gọn với bí danh tùy chỉnh, mật khẩu và số lần nhấp tối đa tùy chọn	"Rút gọn URL này với bí danh 'mylink'"
get_url_stats	Truy xuất phân tích chi tiết bao gồm số lần nhấp, quốc gia và dấu thời gian	"Nhận thống kê cho mã rút gọn 'abc123'"
validate_url	Kiểm tra xem URL có hợp lệ và có thể rút gọn không	"Tôi có thể rút gọn example.com không?"
generate_short_code	Tạo một đề xuất mã rút gọn ngẫu nhiên	"Tạo một mã rút gọn ngẫu nhiên"

🔧 Chi tiết kỹ thuật

Điểm cuối MCP

GET /mcp

Trả về thông tin máy chủ, công cụ khả dụng và chi tiết cấu hình.

Thông tin giao thức

• Phiên bản giao thức: MCP 2024-11-05
• Phương thức truyền: HTTP có thể truyền phát
• Định dạng tin nhắn: JSON-RPC 2.0
• Giới hạn tốc độ: 30 yêu cầu mỗi phút mỗi IP

Bảo mật

• Tất cả giao tiếp sử dụng mã hóa HTTPS
• Mật khẩu được băm bằng bcrypt trước khi lưu trữ
• Giới hạn tốc độ ngăn chặn lạm dụng
• Cùng cơ sở hạ tầng bảo mật như REST API

💡 Trường hợp sử dụng

📝 Tạo nội dung

Tạo URL rút gọn trong khi viết bài đăng blog, tài liệu hoặc nội dung mạng xã hội mà không cần rời khỏi trợ lý AI của bạn.

📊 Phân tích nhanh

Yêu cầu hiệu suất liên kết trong khi trò chuyện. "Liên kết chiến dịch của tôi đã nhận được bao nhiêu lần nhấp?"

🔐 Chia sẻ an toàn

Tạo liên kết được bảo vệ bằng mật khẩu nhanh chóng khi chia sẻ thông tin nhạy cảm trong các cuộc trò chuyện nhóm.

🎯 Quản lý chiến dịch

Tạo URL có bí danh tùy chỉnh cho các chiến dịch tiếp thị bằng các lệnh ngôn ngữ tự nhiên.

🔍 Khắc phục sự cố

Lỗi giới hạn tốc độ?

• Điểm cuối MCP có giới hạn 30 yêu cầu mỗi phút
• Đợi một phút và thử lại

Công cụ không xuất hiện trong Claude Code?

• Đảm bảo URL máy chủ MCP có thể truy cập được
• Thử truy cập http://zip1.io/mcp trong trình duyệt của bạn
• Xác minh cấu hình MCP của bạn với claude mcp list

📚 Tài nguyên & Tài liệu

• Tài liệu MCP chính thức - Tìm hiểu thêm về Model Context Protocol
• MCP Python SDK - Xây dựng máy chủ MCP của riêng bạn
• Tài liệu REST API - Truy cập API truyền thống

Sẵn sàng bắt đầu?

Thêm zip1.io vào Claude Code ngay bây giờ và bắt đầu rút gọn URL với AI

Thiết lập nhanh