Zip1 MCP Server

resmi

Ücretsiz bir URL kısaltıcı

Dokümantasyon

Kısalt
API
MCP
İstatistikler
İletişim

🤖 AI Entegrasyonu (MCP)

Model Context Protocol (MCP) aracılığıyla Claude gibi AI asistanlarından doğrudan zip1.io'yu kullanın. Doğal dil komutlarıyla URL'leri kısaltın, analitikleri alın ve bağlantıları yönetin.

🤖

AI Destekli URL Yönetimi

URL kısaltıcınızla bir AI ile konuşur gibi konuşun

✨ Doğal dil arayüzü - API sözdizimine gerek yok
⚡ AI asistanınızdan anında URL kısaltma
📊 Basit istemlerle isteğe bağlı analitikler alın
🔒 Sohbet yoluyla parola korumalı bağlantılar oluşturun

⚡ Hızlı Kurulum

Claude Code için (Önerilir)

Claude Code, HTTP MCP sunucularını CLI üzerinden doğrudan destekler. Basitçe çalıştırın:

Terminal

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

Kurulumu doğrulayın:

Terminal

claude mcp list

✅ Hepsi bu kadar! Artık zip1.io'yu doğrudan Claude Code'dan kullanabilirsiniz.

Claude Desktop için

⚠️ Proxy Gerektirir: Claude Desktop, HTTP sunucularını değil, yalnızca stdio tabanlı MCP sunucularını destekler. Bağlantıyı köprülemek için yerel bir proxy'ye ihtiyacınız olacak.

Seçenek 1: mcp-client-cli Kullanma (Önerilir)

stdio'yu HTTP'ye köprülemek için MCP istemci CLI aracını yükleyin:

Terminal

npm install -g @modelcontextprotocol/client-cli

Ardından Claude Desktop yapılandırma dosyanızı düzenleyin:

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

Bu yapılandırmayı ekleyin:

claude_desktop_config.json

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

Claude Desktop'ı yeniden başlatın ve zip1.io araçları kullanılabilir olacak.

Seçenek 2: Özel Node.js Proxy'si

İleri düzey kullanıcılar için özel bir stdio-HTTP köprü betiği oluşturun:

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

Çalıştırılabilir yapın ve Claude Desktop yapılandırmanıza ekleyin:

Terminal

chmod +x zip1-mcp-proxy.js

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

⚙️ Sunucu Yapılandırması

zip1.io MCP sunucusu, herhangi bir MCP uyumlu istemcinin bağlanabileceği bir HTTP uç noktası olarak kullanılabilir.

Sunucu Detayları

Yapılandırma Öğesi	Değer
Sunucu URL'si	http://zip1.io/mcp
Aktarım	HTTP (Akışlı)
Protokol Sürümü	MCP 2024-11-05
Mesaj Formatı	JSON-RPC 2.0
Kimlik Doğrulama	Yok (hız sınırlı)
Hız Sınırı	IP başına dakikada 30 istek
Kullanılabilir Araçlar	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Diğer MCP İstemcileriyle Kullanma

HTTP aktarımını destekleyen herhangi bir MCP uyumlu istemci zip1.io'ya bağlanabilir. İşte bazı örnekler:

Doğrudan HTTP İstekleri (curl)

Kullanılabilir Araçları Listele

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

Kısa URL Oluştur

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 İstemci Örneği

Python Betiği

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)

Kendi Barındırdığınız Yapılandırma

Kendi zip1.io örneğinizi çalıştırıyorsanız, istemcileri örneğinize işaret edecek şekilde yapılandırın:

Claude Code

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

Claude Desktop (mcp-client ile)

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

💬 Örnek Konuşmalar

İşte Claude ile kullanabileceğiniz bazı doğal dil istemleri:

Kısa URL'ler Oluşturma

İstem

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

Claude'un Yanıtı:
✅ Kısa URL oluşturuldu: https://zip1.io/\[code\]
🔤 Oluşturulan kod: [code]
🔗 Orijinal URL: https://github.com/anthropics/claude-mcp
📊 İstatistikleri görüntüle: https://zip1.io/stats/\[code\]

Özel Takma Adlar ve Parolalar

İstem

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

Claude'un Yanıtı:
✅ Kısa URL oluşturuldu: https://zip1.io/docs
📝 Özel takma ad: docs
🔒 Parola korumalı: Evet
🔗 Orijinal URL: https://docs.myapp.com

Analitik Alma

İstem

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

Claude'un Yanıtı:
📊 İstatistikler: https://zip1.io/docs
👆 Toplam tıklama: 127
👤 Benzersiz tıklama: 89
🔒 Parola korumalı: Evet
📅 Oluşturulma: 2024-01-15T10:30:00

🌍 En çok tıklanan ülkeler:
1. Amerika Birleşik Devletleri: 54 tıklama
2. Birleşik Krallık: 23 tıklama
3. Kanada: 18 tıklama

URL Doğrulama

İstem

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

Claude'un Yanıtı:
❌ URL geçersiz: http:// veya https:// protokolü ve geçerli bir alan adı içermelidir

🛠️ Kullanılabilir Araçlar

zip1.io MCP sunucusu, Claude'un kullanabileceği dört araç sağlar:

Araç	Açıklama	Örnek Kullanım
create_short_url	İsteğe bağlı özel takma adlar, parolalar ve maksimum tıklama ile kısaltılmış URL'ler oluşturun	"Bu URL'yi 'baglantim' takma adıyla kısalt"
get_url_stats	Tıklamalar, ülkeler ve zaman damgaları dahil ayrıntılı analitikleri alın	"'abc123' kısa kodu için istatistikleri getir"
validate_url	Bir URL'nin geçerli olup olmadığını ve kısaltılıp kısaltılamayacağını kontrol edin	"ornek.com'u kısaltabilir miyim?"
generate_short_code	Rastgele bir kısa kod önerisi oluşturun	"Rastgele bir kısa kod oluştur"

🔧 Teknik Detaylar

MCP Uç Noktası

GET /mcp

Sunucu bilgilerini, kullanılabilir araçları ve yapılandırma detaylarını döndürür.

Protokol Bilgisi

Protokol Sürümü: MCP 2024-11-05
Aktarım: Akışlı HTTP
Mesaj Formatı: JSON-RPC 2.0
Hız Sınırı: IP başına dakikada 30 istek

Güvenlik

Tüm iletişim HTTPS şifrelemesi kullanır
Parolalar depolamadan önce bcrypt ile hashlenir
Hız sınırlaması kötüye kullanımı önler
REST API ile aynı güvenlik altyapısı

💡 Kullanım Örnekleri

📝 İçerik Oluşturma

AI asistanınızdan ayrılmadan blog yazıları, dokümantasyon veya sosyal medya içeriği yazarken kısa URL'ler oluşturun.

📊 Hızlı Analitikler

Konuşmalar sırasında bağlantı performansını sorun. "Kampanya bağlantım kaç tıklama aldı?"

🔐 Güvenli Paylaşım

Ekip sohbetlerinde hassas bilgileri paylaşırken anında parola korumalı bağlantılar oluşturun.

🎯 Kampanya Yönetimi

Doğal dil komutlarıyla pazarlama kampanyaları için özel takma adlı URL'ler oluşturun.

🔍 Sorun Giderme

Hız sınırlama hataları mı alıyorsunuz?

MCP uç noktasının dakikada 30 istek sınırı vardır
Bir dakika bekleyin ve tekrar deneyin

Araçlar Claude Code'da görünmüyor mu?

MCP sunucu URL'sinin erişilebilir olduğundan emin olun
Tarayıcınızda http://zip1.io/mcp adresini ziyaret etmeyi deneyin
MCP yapılandırmanızı claude mcp list ile doğrulayın

📚 Kaynaklar ve Dokümantasyon

Resmi MCP Dokümantasyonu - Model Context Protocol hakkında daha fazla bilgi edinin
MCP Python SDK - Kendi MCP sunucularınızı oluşturun
REST API Dokümantasyonu - Geleneksel API erişimi

Başlamaya Hazır mısınız?

zip1.io'yu şimdi Claude Code'a ekleyin ve AI ile URL'leri kısaltmaya başlayın

Hızlı Kurulum