Zip1

🤖 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 Giao thức Ngữ cảnh Mô hình (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 hỗ trợ AI

Nói chuyện với trình rút gọn URL của bạn như nói 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ệnh đơn giản
• 🔒 Tạo liên kết bảo vệ bằng mật khẩu một cách trò chuyện

⚡ 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:

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

Xác minh cài đặt:

claude mcp list

✅ 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 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:

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:

{
  "mcpServers": {
    "zip1": {
      "command": "mcp-client",
      "args": ["https://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 tập lệnh cầu nối stdio-to-HTTP tùy chỉnh:

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

const MCP_URL = 'https://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:

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 đ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ủ	https://zip1.io/mcp
Giao thức vận chuyển	HTTP (Streamable)
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ợ giao thức vận chuyển 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)

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

curl -X POST https://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ụ máy khách Python

import requests

MCP_URL = "https://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 mcp add --transport http zip1 https://your-domain.com/mcp

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

💬 Ví dụ về hội thoại

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

Tạo URL rút gọn

"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

"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
🔒 Bảo vệ bằng mật khẩu: Có
🔗 URL gốc: https://docs.myapp.com

Nhận phân tích

"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ượt nhấp: 127
👤 Lượt nhấp duy nhất: 89
🔒 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ượt nhấp
2. Vương quốc Anh: 23 lượt nhấp
3. Canada: 18 lượt nhấp

Xác thực URL

"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à tên miền hợp lệ

🛠️ Các 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ả	Ví dụ sử dụng
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ượt nhấp tối đa	"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 lượt nhấp, quốc gia và dấu thời gian	"Lấy thống kê cho mã ngắ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 gợi ý mã ngắn ngẫu nhiên	"Tạo một mã ngắn ngẫu nhiên"

description trên create_short_url là ghi chú riêng tư tùy chọn cho tích hợp của riêng bạn, tối đa 100 ký tự. Nó không được hiển thị trên các trang công khai của liên kết. Giữ nó không chứa dữ liệu cá nhân mà bạn không muốn lưu trữ. Phản hồi tạo sẽ trả về nó.

🔧 Chi tiết kỹ thuật

Điểm cuối MCP

GET /mcp

Trả về thông tin máy chủ, các 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
• Giao thức vận chuyển: HTTP Streamable
• Đị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

💡 Các 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 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

Hỏi về hiệu suất liên kết trong các cuộc trò chuyện. "Liên kết chiến dịch của tôi có bao nhiêu lượt nhấp?"

🔐 Chia sẻ an toàn

Tạo liên kết bảo vệ bằng mật khẩu ngay lập tức 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 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 https://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ề Giao thức Ngữ cảnh Mô hình
• 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

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