Zip1

🤖 Integrasi AI (MCP)

Gunakan zip1.io langsung dari asisten AI seperti Claude melalui Model Context Protocol (MCP). Perpendek URL, ambil analitik, dan kelola tautan menggunakan perintah bahasa alami.

🤖

Manajemen URL Bertenaga AI

Bicaralah dengan pemendek URL Anda seperti Anda berbicara dengan AI

• ✨ Antarmuka bahasa alami - tidak perlu sintaks API
• ⚡ Pemendekan URL instan dari asisten AI Anda
• 📊 Dapatkan analitik sesuai permintaan dengan perintah sederhana
• 🔒 Buat tautan yang dilindungi kata sandi secara percakapan

⚡ Pengaturan Cepat

Untuk Claude Code (Direkomendasikan)

Claude Code mendukung server MCP HTTP secara langsung melalui CLI. Cukup jalankan:

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

Verifikasi instalasi:

claude mcp list

✅ Itu saja! Anda sekarang dapat menggunakan zip1.io langsung dari Claude Code.

Untuk Claude Desktop

⚠️ Memerlukan Proksi: Claude Desktop hanya mendukung server MCP berbasis stdio, bukan server HTTP. Anda memerlukan proksi lokal untuk menjembatani koneksi.

Opsi 1: Menggunakan mcp-client-cli (Direkomendasikan)

Instal alat CLI klien MCP untuk menjembatani stdio ke HTTP:

npm install -g @modelcontextprotocol/client-cli

Kemudian edit file konfigurasi Claude Desktop Anda:

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

Tambahkan konfigurasi ini:

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

Mulai ulang Claude Desktop dan alat zip1.io akan tersedia.

Opsi 2: Proksi Node.js Kustom

Untuk pengguna tingkat lanjut, buat skrip jembatan stdio-ke-HTTP kustom:

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

Buat dapat dieksekusi dan tambahkan ke konfigurasi Claude Desktop Anda:

chmod +x zip1-mcp-proxy.js

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

⚙️ Konfigurasi Server

Server MCP zip1.io tersedia sebagai titik akhir HTTP yang dapat dihubungkan oleh klien yang kompatibel dengan MCP.

Detail Server

Item Konfigurasi	Nilai
URL Server	https://zip1.io/mcp
Transport	HTTP (Streamable)
Versi Protokol	MCP 2024-11-05
Format Pesan	JSON-RPC 2.0
Autentikasi	Tidak ada (dibatasi kecepatan)
Batas Kecepatan	30 permintaan/menit per IP
Alat Tersedia	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Menggunakan dengan Klien MCP Lainnya

Klien apa pun yang kompatibel dengan MCP yang mendukung transport HTTP dapat terhubung ke zip1.io. Berikut beberapa contohnya:

Permintaan HTTP Langsung (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"
      }
    }
  }'

Contoh Klien 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)

Konfigurasi Host Sendiri

Jika Anda menjalankan instance zip1.io sendiri, konfigurasikan klien untuk menunjuk ke instance Anda:

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

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

💬 Contoh Percakapan

Berikut beberapa perintah bahasa alami yang dapat Anda gunakan dengan Claude:

Membuat URL Pendek

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

Respons Claude:
✅ URL pendek dibuat: https://zip1.io/\[code\]
🔤 Kode yang dihasilkan: [code]
🔗 URL asli: https://github.com/anthropics/claude-mcp
📊 Lihat statistik: https://zip1.io/stats/\[code\]

Alias Kustom & Kata Sandi

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

Respons Claude:
✅ URL pendek dibuat: https://zip1.io/docs
📝 Alias kustom: docs
🔒 Dilindungi kata sandi: Ya
🔗 URL asli: https://docs.myapp.com

Mendapatkan Analitik

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

Respons Claude:
📊 Statistik untuk: https://zip1.io/docs
👆 Total klik: 127
👤 Klik unik: 89
🔒 Dilindungi kata sandi: Ya
📅 Dibuat: 2024-01-15T10:30:00

🌍 Negara teratas:
1. Amerika Serikat: 54 klik
2. Inggris: 23 klik
3. Kanada: 18 klik

Validasi URL

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

Respons Claude:
❌ URL tidak valid: Harus menyertakan protokol http:// atau https:// dan domain yang valid

🛠️ Alat yang Tersedia

Server MCP zip1.io menyediakan empat alat yang dapat digunakan Claude:

Alat	Deskripsi	Contoh Penggunaan
create_short_url	Buat URL pendek dengan alias kustom opsional, kata sandi, dan klik maksimum	"Perpendek URL ini dengan alias 'mylink'"
get_url_stats	Ambil analitik terperinci termasuk klik, negara, dan stempel waktu	"Dapatkan statistik untuk kode pendek 'abc123'"
validate_url	Periksa apakah URL valid dan dapat dipersingkat	"Bisakah saya mempersingkat example.com?"
generate_short_code	Hasilkan saran kode pendek acak	"Hasilkan kode pendek acak"

description pada create_short_url adalah catatan pribadi opsional untuk integrasi Anda sendiri, hingga 100 karakter. Ini tidak ditampilkan di halaman publik tautan. Jauhkan dari data pribadi yang tidak ingin Anda simpan. Respons pembuatan mengembalikannya.

🔧 Detail Teknis

Titik Akhir MCP

GET /mcp

Mengembalikan informasi server, alat yang tersedia, dan detail konfigurasi.

Informasi Protokol

• Versi Protokol: MCP 2024-11-05
• Transport: HTTP Streamable
• Format Pesan: JSON-RPC 2.0
• Batas Kecepatan: 30 permintaan per menit per IP

Keamanan

• Semua komunikasi menggunakan enkripsi HTTPS
• Kata sandi di-hash dengan bcrypt sebelum penyimpanan
• Pembatasan kecepatan mencegah penyalahgunaan
• Infrastruktur keamanan yang sama dengan REST API

💡 Kasus Penggunaan

📝 Pembuatan Konten

Hasilkan URL pendek saat menulis posting blog, dokumentasi, atau konten media sosial tanpa meninggalkan asisten AI Anda.

📊 Analitik Cepat

Minta kinerja tautan selama percakapan. "Berapa banyak klik yang didapat tautan kampanye saya?"

🔐 Berbagi Aman

Buat tautan yang dilindungi kata sandi dengan cepat saat berbagi informasi sensitif dalam obrolan tim.

🎯 Manajemen Kampanye

Buat URL dengan alias kustom untuk kampanye pemasaran dengan perintah bahasa alami.

🔍 Pemecahan Masalah

Kesalahan pembatasan kecepatan?

• Titik akhir MCP memiliki batas 30 permintaan per menit
• Tunggu satu menit dan coba lagi

Alat tidak muncul di Claude Code?

• Pastikan URL server MCP dapat diakses
• Coba kunjungi https://zip1.io/mcp di browser Anda
• Verifikasi konfigurasi MCP Anda dengan claude mcp list

📚 Sumber Daya & Dokumentasi

• Dokumentasi MCP Resmi - Pelajari lebih lanjut tentang Model Context Protocol
• SDK Python MCP - Bangun server MCP Anda sendiri
• Dokumentasi REST API - Akses API tradisional

Siap Memulai?

Tambahkan zip1.io ke Claude Code sekarang dan mulailah mempersingkat URL dengan AI

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