Zip1 MCP Server

ทางการ

เครื่องย่อ URL ฟรี

เอกสาร

ย่อ
API
MCP
สถิติ
ติดต่อ

🤖 การผสานรวม AI (MCP)

ใช้ zip1.io ได้โดยตรงจากผู้ช่วย AI อย่าง Claude ผ่าน Model Context Protocol (MCP) ย่อ URL เรียกดูข้อมูลวิเคราะห์ และจัดการลิงก์ด้วยคำสั่งภาษาธรรมชาติ

🤖

การจัดการ URL ด้วยพลัง AI

พูดคุยกับเครื่องมือย่อ URL ของคุณเหมือนคุยกับ AI

✨ อินเทอร์เฟซภาษาธรรมชาติ - ไม่ต้องใช้ไวยากรณ์ API
⚡ ย่อ URL ทันใจจากผู้ช่วย AI ของคุณ
📊 รับข้อมูลวิเคราะห์ตามต้องการด้วยคำสั่งง่ายๆ
🔒 สร้างลิงก์ที่มีการป้องกันด้วยรหัสผ่านผ่านการสนทนา

⚡ การตั้งค่าอย่างรวดเร็ว

สำหรับ Claude Code (แนะนำ)

Claude Code รองรับเซิร์ฟเวอร์ MCP แบบ HTTP โดยตรงผ่าน CLI เพียงรัน:

Terminal

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

ตรวจสอบการติดตั้ง:

Terminal

claude mcp list

✅ เท่านี้ก็เสร็จ! คุณสามารถใช้ zip1.io ได้โดยตรงจาก Claude Code แล้ว

สำหรับ Claude Desktop

⚠️ ต้องใช้พร็อกซี: Claude Desktop รองรับเฉพาะเซิร์ฟเวอร์ MCP แบบ stdio ไม่ใช่เซิร์ฟเวอร์ HTTP คุณจะต้องใช้พร็อกซีภายในเพื่อเชื่อมต่อ

ตัวเลือก 1: ใช้ mcp-client-cli (แนะนำ)

ติดตั้งเครื่องมือ CLI ไคลเอนต์ MCP เพื่อเชื่อม stdio กับ HTTP:

Terminal

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 ของคุณ:

Terminal

chmod +x zip1-mcp-proxy.js

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

⚙️ การตั้งค่าเซิร์ฟเวอร์

เซิร์ฟเวอร์ MCP ของ zip1.io พร้อมใช้งานในรูปแบบปลายทาง HTTP ที่ไคลเอนต์ที่เข้ากันได้กับ MCP ทุกตัวสามารถเชื่อมต่อได้

รายละเอียดเซิร์ฟเวอร์

รายการตั้งค่า	ค่า
URL เซิร์ฟเวอร์	http://zip1.io/mcp
การขนส่ง	HTTP (Streamable)
เวอร์ชันโปรโตคอล	MCP 2024-11-05
รูปแบบข้อความ	JSON-RPC 2.0
การตรวจสอบสิทธิ์	ไม่มี (จำกัดอัตรา)
การจำกัดอัตรา	30 คำขอ/นาที ต่อ IP
เครื่องมือที่พร้อมใช้งาน	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

การใช้กับไคลเอนต์ MCP อื่นๆ

ไคลเอนต์ที่เข้ากันได้กับ MCP ใดๆ ที่รองรับการขนส่ง HTTP สามารถเชื่อมต่อกับ 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 Script

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 แบบสั้น

Prompt

"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\]

นามแฝงและรหัสผ่านแบบกำหนดเอง

Prompt

"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

การรับข้อมูลวิเคราะห์

Prompt

"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

Prompt

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

การตอบกลับของ Claude:
❌ URL ไม่ถูกต้อง: ต้องมีโปรโตคอล http:// หรือ https:// และโดเมนที่ถูกต้อง

🛠️ เครื่องมือที่พร้อมใช้งาน

เซิร์ฟเวอร์ MCP ของ zip1.io มีเครื่องมือสี่อย่างที่ Claude สามารถใช้ได้:

เครื่องมือ	คำอธิบาย	ตัวอย่างการใช้งาน
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
การจำกัดอัตรา: 30 คำขอต่อนาทีต่อ IP

ความปลอดภัย

การสื่อสารทั้งหมดใช้การเข้ารหัส HTTPS
รหัสผ่านถูกแฮชด้วย bcrypt ก่อนจัดเก็บ
การจำกัดอัตราป้องกันการใช้งานในทางที่ผิด
โครงสร้างพื้นฐานด้านความปลอดภัยเดียวกันกับ REST API

💡 กรณีการใช้งาน

📝 การสร้างเนื้อหา

สร้าง URL แบบสั้นขณะเขียนบล็อกโพสต์ เอกสาร หรือเนื้อหาโซเชียลมีเดียโดยไม่ต้องออกจากผู้ช่วย AI ของคุณ

📊 การวิเคราะห์อย่างรวดเร็ว

ถามประสิทธิภาพของลิงก์ระหว่างการสนทนา "ลิงก์แคมเปญของฉันมีคลิกเท่าไหร่?"

🔐 การแชร์อย่างปลอดภัย

สร้างลิงก์ที่มีการป้องกันด้วยรหัสผ่านได้ทันทีเมื่อแชร์ข้อมูลที่ละเอียดอ่อนในการแชททีม

🎯 การจัดการแคมเปญ

สร้าง URL ที่มีนามแฝงแบบกำหนดเองสำหรับแคมเปญการตลาดด้วยคำสั่งภาษาธรรมชาติ

🔍 การแก้ไขปัญหา

ข้อผิดพลาดการจำกัดอัตรา?

ปลายทาง MCP มีขีดจำกัด 30 คำขอต่อนาที
รอสักครู่แล้วลองอีกครั้ง

เครื่องมือไม่ปรากฏใน Claude Code?

ตรวจสอบว่า URL เซิร์ฟเวอร์ MCP สามารถเข้าถึงได้
ลองไปที่ http://zip1.io/mcp ในเบราว์เซอร์ของคุณ
ตรวจสอบการตั้งค่า MCP ของคุณด้วย claude mcp list

📚 แหล่งข้อมูลและเอกสาร

เอกสาร MCP อย่างเป็นทางการ - เรียนรู้เพิ่มเติมเกี่ยวกับ Model Context Protocol
MCP Python SDK - สร้างเซิร์ฟเวอร์ MCP ของคุณเอง
เอกสาร REST API - การเข้าถึง API แบบดั้งเดิม

พร้อมเริ่มต้นหรือยัง?

เพิ่ม zip1.io ใน Claude Code ตอนนี้และเริ่มย่อ URL ด้วย AI

การตั้งค่าอย่างรวดเร็ว