Zip1

• Kürzen
• API
• MCP
• Statistiken
• Kontakt

🤖 KI-Integration (MCP)

Nutzen Sie zip1.io direkt aus KI-Assistenten wie Claude über das Model Context Protocol (MCP). Kürzen Sie URLs, rufen Sie Analysen ab und verwalten Sie Links mit natürlichsprachlichen Befehlen.

🤖

KI-gestützte URL-Verwaltung

Sprechen Sie mit Ihrem URL-Kürzer wie mit einer KI

• ✨ Natürlichsprachliche Schnittstelle – keine API-Syntax nötig
• ⚡ Sofortiges URL-Kürzen aus Ihrem KI-Assistenten
• 📊 Analysen auf Abruf mit einfachen Eingabeaufforderungen
• 🔒 Erstellen Sie passwortgeschützte Links im Gespräch

⚡ Schnelleinrichtung

Für Claude Code (Empfohlen)

Claude Code unterstützt HTTP-MCP-Server direkt über die Befehlszeile. Führen Sie einfach aus:

Terminal

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

Installation überprüfen:

Terminal

claude mcp list

✅ Das war's! Sie können zip1.io jetzt direkt aus Claude Code verwenden.

Für Claude Desktop

⚠️ Proxy erforderlich: Claude Desktop unterstützt nur stdio-basierte MCP-Server, keine HTTP-Server. Sie benötigen einen lokalen Proxy, um die Verbindung zu überbrücken.

Option 1: mcp-client-cli verwenden (Empfohlen)

Installieren Sie das MCP-Client-CLI-Tool, um stdio mit HTTP zu verbinden:

Terminal

npm install -g @modelcontextprotocol/client-cli

Bearbeiten Sie dann Ihre Claude Desktop-Konfigurationsdatei:

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

Fügen Sie diese Konfiguration hinzu:

claude_desktop_config.json

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

Starten Sie Claude Desktop neu und die zip1.io-Tools sind verfügbar.

Option 2: Benutzerdefinierter Node.js-Proxy

Für fortgeschrittene Benutzer: Erstellen Sie ein benutzerdefiniertes stdio-zu-HTTP-Brückenskript:

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

Machen Sie es ausführbar und fügen Sie es Ihrer Claude Desktop-Konfiguration hinzu:

Terminal

chmod +x zip1-mcp-proxy.js

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

⚙️ Serverkonfiguration

Der zip1.io MCP-Server ist als HTTP-Endpunkt verfügbar, mit dem sich jeder MCP-kompatible Client verbinden kann.

Serverdetails

Konfigurationselement	Wert
Server-URL	http://zip1.io/mcp
Transport	HTTP (Streamable)
Protokollversion	MCP 2024-11-05
Nachrichtenformat	JSON-RPC 2.0
Authentifizierung	Keine (ratenbegrenzt)
Ratenlimit	30 Anfragen/Minute pro IP
Verfügbare Tools	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Verwendung mit anderen MCP-Clients

Jeder MCP-kompatible Client, der HTTP-Transport unterstützt, kann sich mit zip1.io verbinden. Hier einige Beispiele:

Direkte HTTP-Anfragen (curl)

Verfügbare Tools auflisten

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

Kurz-URL erstellen

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-Client-Beispiel

Python-Skript

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)

Selbst gehostete Konfiguration

Wenn Sie Ihre eigene zip1.io-Instanz betreiben, konfigurieren Sie Clients so, dass sie auf Ihre Instanz verweisen:

Claude Code

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

Claude Desktop (mit mcp-client)

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

💬 Beispielkonversationen

Hier sind einige natürlichsprachliche Eingabeaufforderungen, die Sie mit Claude verwenden können:

Kurz-URLs erstellen

Eingabeaufforderung

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

Claudes Antwort:
✅ Kurz-URL erstellt: https://zip1.io/\[code\]
🔤 Generierter Code: [code]
🔗 Original-URL: https://github.com/anthropics/claude-mcp
📊 Statistiken anzeigen: https://zip1.io/stats/\[code\]

Benutzerdefinierte Aliase & Passwörter

Eingabeaufforderung

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

Claudes Antwort:
✅ Kurz-URL erstellt: https://zip1.io/docs
📝 Benutzerdefinierter Alias: docs
🔒 Passwortgeschützt: Ja
🔗 Original-URL: https://docs.myapp.com

Analysen abrufen

Eingabeaufforderung

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

Claudes Antwort:
📊 Statistiken für: https://zip1.io/docs
👆 Klicks gesamt: 127
👤 Eindeutige Klicks: 89
🔒 Passwortgeschützt: Ja
📅 Erstellt: 2024-01-15T10:30:00

🌍 Top-Länder:
1. Vereinigte Staaten: 54 Klicks
2. Vereinigtes Königreich: 23 Klicks
3. Kanada: 18 Klicks

URL-Validierung

Eingabeaufforderung

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

Claudes Antwort:
❌ URL ist ungültig: Muss das Protokoll http:// oder https:// und eine gültige Domain enthalten

🛠️ Verfügbare Tools

Der zip1.io MCP-Server stellt vier Tools bereit, die Claude verwenden kann:

Tool	Beschreibung	Beispielverwendung
create_short_url	Kurz-URLs mit optionalen benutzerdefinierten Aliasen, Passwörtern und maximalen Klicks erstellen	"Kürze diese URL mit Alias 'mylink'"
get_url_stats	Detaillierte Analysen inkl. Klicks, Länder und Zeitstempel abrufen	"Statistiken für Kurzcode 'abc123' abrufen"
validate_url	Prüfen, ob eine URL gültig ist und gekürzt werden kann	"Kann ich example.com kürzen?"
generate_short_code	Einen zufälligen Kurzcode-Vorschlag generieren	"Generiere einen zufälligen Kurzcode"

🔧 Technische Details

MCP-Endpunkt

GET /mcp

Gibt Serverinformationen, verfügbare Tools und Konfigurationsdetails zurück.

Protokollinformationen

• Protokollversion: MCP 2024-11-05
• Transport: Streamable HTTP
• Nachrichtenformat: JSON-RPC 2.0
• Ratenlimit: 30 Anfragen pro Minute pro IP

Sicherheit

• Gesamte Kommunikation verwendet HTTPS-Verschlüsselung
• Passwörter werden vor der Speicherung mit bcrypt gehasht
• Ratenbegrenzung verhindert Missbrauch
• Gleiche Sicherheitsinfrastruktur wie die REST-API

💡 Anwendungsfälle

📝 Inhaltserstellung

Generieren Sie Kurz-URLs beim Schreiben von Blogbeiträgen, Dokumentationen oder Social-Media-Inhalten, ohne Ihren KI-Assistenten zu verlassen.

📊 Schnelle Analysen

Fragen Sie während Gesprächen nach der Link-Performance. "Wie viele Klicks hat mein Kampagnen-Link erhalten?"

🔐 Sicheres Teilen

Erstellen Sie spontan passwortgeschützte Links, wenn Sie sensible Informationen in Team-Chats teilen.

🎯 Kampagnenmanagement

Erstellen Sie URLs mit benutzerdefinierten Aliasen für Marketingkampagnen mit natürlichsprachlichen Befehlen.

🔍 Fehlerbehebung

Ratenbegrenzungsfehler?

• Der MCP-Endpunkt hat ein Limit von 30 Anfragen pro Minute
• Warten Sie eine Minute und versuchen Sie es erneut

Tools erscheinen nicht in Claude Code?

• Stellen Sie sicher, dass die MCP-Server-URL erreichbar ist
• Versuchen Sie, http://zip1.io/mcp in Ihrem Browser aufzurufen
• Überprüfen Sie Ihre MCP-Konfiguration mit claude mcp list

📚 Ressourcen & Dokumentation

• Offizielle MCP-Dokumentation – Erfahren Sie mehr über das Model Context Protocol
• MCP Python SDK – Erstellen Sie Ihre eigenen MCP-Server
• REST-API-Dokumentation – Traditioneller API-Zugriff

Bereit zum Start?

Fügen Sie zip1.io jetzt zu Claude Code hinzu und beginnen Sie mit dem Kürzen von URLs per KI

Schnelleinrichtung