Zip1

🤖 AI एकीकरण (MCP)

Claude जैसे AI सहायकों से सीधे Model Context Protocol (MCP) के माध्यम से zip1.io का उपयोग करें। प्राकृतिक भाषा कमांड का उपयोग करके URL छोटा करें, एनालिटिक्स प्राप्त करें, और लिंक प्रबंधित करें।

🤖

AI-संचालित URL प्रबंधन

अपने URL शॉर्टनर से ऐसे बात करें जैसे आप AI से बात करते हैं

• ✨ प्राकृतिक भाषा इंटरफ़ेस - कोई API सिंटैक्स आवश्यक नहीं
• ⚡ अपने AI सहायक से तुरंत URL छोटा करना
• 📊 सरल प्रॉम्प्ट के साथ ऑन-डिमांड एनालिटिक्स प्राप्त करें
• 🔒 बातचीत के माध्यम से पासवर्ड-सुरक्षित लिंक बनाएं

⚡ त्वरित सेटअप

Claude Code के लिए (अनुशंसित)

Claude Code CLI के माध्यम से सीधे HTTP MCP सर्वर का समर्थन करता है। बस चलाएं:

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

स्थापना सत्यापित करें:

claude mcp list

✅ बस इतना ही! अब आप Claude Code से सीधे zip1.io का उपयोग कर सकते हैं।

Claude Desktop के लिए

⚠️ प्रॉक्सी आवश्यक: Claude Desktop केवल stdio-आधारित MCP सर्वर का समर्थन करता है, HTTP सर्वर का नहीं। कनेक्शन को जोड़ने के लिए आपको एक स्थानीय प्रॉक्सी की आवश्यकता होगी।

विकल्प 1: mcp-client-cli का उपयोग करना (अनुशंसित)

stdio को HTTP से जोड़ने के लिए MCP क्लाइंट CLI टूल स्थापित करें:

npm install -g @modelcontextprotocol/client-cli

फिर अपनी Claude Desktop कॉन्फ़िगरेशन फ़ाइल संपादित करें:

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

यह कॉन्फ़िगरेशन जोड़ें:

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

Claude Desktop को पुनरारंभ करें और zip1.io टूल उपलब्ध होंगे।

विकल्प 2: कस्टम Node.js प्रॉक्सी

उन्नत उपयोगकर्ताओं के लिए, एक कस्टम stdio-to-HTTP ब्रिज स्क्रिप्ट बनाएं:

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

इसे निष्पादन योग्य बनाएं और अपनी Claude Desktop कॉन्फ़िगरेशन में जोड़ें:

chmod +x zip1-mcp-proxy.js

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

⚙️ सर्वर कॉन्फ़िगरेशन

zip1.io MCP सर्वर एक HTTP एंडपॉइंट के रूप में उपलब्ध है जिससे कोई भी MCP-संगत क्लाइंट कनेक्ट हो सकता है।

सर्वर विवरण

कॉन्फ़िगरेशन आइटम	मान
सर्वर URL	https://zip1.io/mcp
ट्रांसपोर्ट	HTTP (स्ट्रीमेबल)
प्रोटोकॉल संस्करण	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 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"
      }
    }
  }'

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)

स्व-होस्टेड कॉन्फ़िगरेशन

यदि आप zip1.io का अपना इंस्टेंस चला रहे हैं, तो क्लाइंट को अपने इंस्टेंस की ओर इंगित करने के लिए कॉन्फ़िगर करें:

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

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

💬 उदाहरण वार्तालाप

यहाँ कुछ प्राकृतिक भाषा प्रॉम्प्ट हैं जिन्हें आप Claude के साथ उपयोग कर सकते हैं:

छोटे URL बनाना

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

कस्टम उपनाम और पासवर्ड

"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

एनालिटिक्स प्राप्त करना

"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 सत्यापन

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

Claude की प्रतिक्रिया:
❌ URL अमान्य है: इसमें http:// या https:// प्रोटोकॉल और एक मान्य डोमेन शामिल होना चाहिए

🛠️ उपलब्ध टूल

zip1.io MCP सर्वर चार टूल प्रदान करता है जिनका उपयोग Claude कर सकता है:

टूल	विवरण	उदाहरण उपयोग
create_short_url	वैकल्पिक कस्टम उपनाम, पासवर्ड और अधिकतम क्लिक के साथ छोटे URL बनाएं	"इस URL को उपनाम 'mylink' के साथ छोटा करें"
get_url_stats	क्लिक, देश और टाइमस्टैम्प सहित विस्तृत एनालिटिक्स प्राप्त करें	"शॉर्ट कोड 'abc123' के लिए आँकड़े प्राप्त करें"
validate_url	जाँचें कि क्या URL मान्य है और छोटा किया जा सकता है	"क्या मैं example.com को छोटा कर सकता हूँ?"
generate_short_code	एक यादृच्छिक शॉर्ट कोड सुझाव उत्पन्न करें	"एक यादृच्छिक शॉर्ट कोड उत्पन्न करें"

description पर create_short_url आपके अपने एकीकरण के लिए एक वैकल्पिक निजी नोट है, जो 100 वर्णों तक हो सकता है। यह लिंक के सार्वजनिक पृष्ठों पर नहीं दिखाया जाता है। इसे व्यक्तिगत डेटा से मुक्त रखें जिसे आप संग्रहीत नहीं करना चाहेंगे। निर्माण प्रतिक्रिया इसे लौटाती है।

🔧 तकनीकी विवरण

MCP एंडपॉइंट

GET /mcp

सर्वर जानकारी, उपलब्ध टूल और कॉन्फ़िगरेशन विवरण लौटाता है।

प्रोटोकॉल जानकारी

• प्रोटोकॉल संस्करण: MCP 2024-11-05
• ट्रांसपोर्ट: स्ट्रीमेबल HTTP
• संदेश प्रारूप: JSON-RPC 2.0
• दर सीमा: 30 अनुरोध प्रति मिनट प्रति IP

सुरक्षा

• सभी संचार HTTPS एन्क्रिप्शन का उपयोग करते हैं
• पासवर्ड संग्रहीत करने से पहले bcrypt के साथ हैश किए जाते हैं
• दर सीमित करना दुरुपयोग को रोकता है
• REST API के समान सुरक्षा बुनियादी ढांचा

💡 उपयोग के मामले

📝 सामग्री निर्माण

अपने AI सहायक को छोड़े बिना ब्लॉग पोस्ट, दस्तावेज़ीकरण या सोशल मीडिया सामग्री लिखते समय छोटे URL उत्पन्न करें।

📊 त्वरित एनालिटिक्स

बातचीत के दौरान लिंक प्रदर्शन के बारे में पूछें। "मेरे अभियान लिंक को कितने क्लिक मिले?"

🔐 सुरक्षित साझाकरण

टीम चैट में संवेदनशील जानकारी साझा करते समय तुरंत पासवर्ड-सुरक्षित लिंक बनाएं।

🎯 अभियान प्रबंधन

प्राकृतिक भाषा कमांड के साथ मार्केटिंग अभियानों के लिए कस्टम-उपनाम URL बनाएं।

🔍 समस्या निवारण

दर सीमित करने में त्रुटियाँ?

• MCP एंडपॉइंट की सीमा 30 अनुरोध प्रति मिनट है
• एक मिनट प्रतीक्षा करें और पुनः प्रयास करें

Claude Code में टूल दिखाई नहीं दे रहे?

• सुनिश्चित करें कि MCP सर्वर URL सुलभ है
• अपने ब्राउज़र में https://zip1.io/mcp पर जाने का प्रयास करें
• claude mcp list के साथ अपनी MCP कॉन्फ़िगरेशन सत्यापित करें

📚 संसाधन और दस्तावेज़ीकरण

• आधिकारिक MCP दस्तावेज़ीकरण - Model Context Protocol के बारे में और जानें
• MCP Python SDK - अपने स्वयं के MCP सर्वर बनाएं
• REST API दस्तावेज़ीकरण - पारंपरिक API पहुंच

शुरू करने के लिए तैयार?

अभी Claude Code में zip1.io जोड़ें और AI के साथ URL छोटा करना शुरू करें

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