Zip1 MCP Server

• Shorten
• API
• MCP
• Stats
• Contact

🤖 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 prompt sederhana
• 🔒 Buat tautan yang dilindungi kata sandi secara percakapan

⚡ Pengaturan Cepat

Untuk Claude Code (Direkomendasikan)

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

Terminal

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

Verifikasi instalasi:

Terminal

claude mcp list

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

Untuk Claude Desktop

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

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

Instal alat CLI klien MCP untuk menjembatani stdio ke HTTP:

Terminal

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:

claude_desktop_config.json

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

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

Opsi 2: Proxy Node.js Kustom

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

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

Jadikan dapat dieksekusi dan tambahkan ke konfigurasi Claude Desktop Anda:

Terminal

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 endpoint HTTP yang dapat dihubungkan oleh klien yang kompatibel dengan MCP.

Detail Server

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

Menggunakan dengan Klien MCP Lain

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

Permintaan HTTP Langsung (curl)

Daftar Alat Tersedia

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

Buat URL Pendek

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

Contoh Klien Python

Skrip 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)

Konfigurasi Self-Hosted

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

Claude Code

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

Claude Desktop (dengan mcp-client)

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

💬 Contoh Percakapan

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

Membuat URL Pendek

Prompt

"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

Prompt

"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

Prompt

"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 Raya: 23 klik
3. Kanada: 18 klik

Validasi URL

Prompt

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

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

🛠️ Alat 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, kata sandi, dan klik maks opsional	"Perpendek URL ini dengan alias 'tautanku'"
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 dipendekkan	"Bisakah saya memendekkan example.com?"
generate_short_code	Hasilkan saran kode pendek acak	"Hasilkan kode pendek acak"

🔧 Detail Teknis

Endpoint 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 Laju: 30 permintaan per menit per IP

Keamanan

• Semua komunikasi menggunakan enkripsi HTTPS
• Kata sandi di-hash dengan bcrypt sebelum disimpan
• Pembatasan laju 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

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

🔐 Berbagi Aman

Buat tautan yang dilindungi kata sandi secara langsung saat berbagi informasi sensitif dalam obrolan tim.

🎯 Manajemen Kampanye

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

🔍 Pemecahan Masalah

Kesalahan batas laju?

• Endpoint MCP memiliki batas 30 permintaan per menit
• Tunggu sebentar dan coba lagi

Alat tidak muncul di Claude Code?

• Pastikan URL server MCP dapat diakses
• Coba kunjungi http://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
• MCP Python SDK - Bangun server MCP Anda sendiri
• Dokumentasi REST API - Akses API tradisional

Siap Memulai?

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

Pengaturan Cepat