Zip1

officiel

Un raccourcisseur d'URL gratuit

Voir sur zip1.ioEssayer ce MCPSponsorisé

Que pouvez-vous faire avec Zip1 MCP ?

Raccourcir les URLs — Demandez à votre assistant de créer un lien court à partir de toute URL valide en utilisant create_short_url.
Alias personnalisés et mots de passe — Demandez un lien court de marque avec un alias personnalisé et une protection facultative par mot de passe via create_short_url.
Vérifier la validité d’une URL — Demandez si une URL peut être raccourcie avant de créer un lien, à l’aide de l’outil validate_url.
Récupérer les statistiques des liens — Obtenez le nombre de clics, les visiteurs uniques et les principaux pays pour tout code court avec get_url_stats.
Générer des codes courts — Demandez une suggestion de code court aléatoire à utiliser comme alias personnalisé.

Documentation

🤖 Intégration IA (MCP)

Utilisez zip1.io directement depuis des assistants IA comme Claude grâce au Model Context Protocol (MCP). Raccourcissez des URL, récupérez des statistiques et gérez des liens à l'aide de commandes en langage naturel.

🤖

Gestion d'URL propulsée par l'IA

Parlez à votre raccourcisseur d'URL comme vous parleriez à une IA

✨ Interface en langage naturel - aucune syntaxe API requise
⚡ Raccourcissement d'URL instantané depuis votre assistant IA
📊 Obtenez des statistiques à la demande avec des requêtes simples
🔒 Créez des liens protégés par mot de passe de manière conversationnelle

⚡ Configuration rapide

Pour Claude Code (recommandé)

Claude Code prend en charge les serveurs MCP HTTP directement via CLI. Exécutez simplement :

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

Vérifiez l'installation :

claude mcp list

✅ C'est tout ! Vous pouvez désormais utiliser zip1.io directement depuis Claude Code.

Pour Claude Desktop

⚠️ Proxy requis : Claude Desktop ne prend en charge que les serveurs MCP basés sur stdio, pas les serveurs HTTP. Vous aurez besoin d'un proxy local pour établir la connexion.

Option 1 : Utilisation de mcp-client-cli (recommandé)

Installez l'outil client MCP CLI pour faire le pont entre stdio et HTTP :

npm install -g @modelcontextprotocol/client-cli

Ensuite, modifiez votre fichier de configuration Claude Desktop :

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

Ajoutez cette configuration :

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

Redémarrez Claude Desktop et les outils zip1.io seront disponibles.

Option 2 : Proxy Node.js personnalisé

Pour les utilisateurs avancés, créez un script de pont stdio-vers-HTTP personnalisé :

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

Rendez-le exécutable et ajoutez-le à votre configuration Claude Desktop :

chmod +x zip1-mcp-proxy.js

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

⚙️ Configuration du serveur

Le serveur MCP zip1.io est disponible sous forme de point de terminaison HTTP auquel tout client compatible MCP peut se connecter.

Détails du serveur

Élément de configuration	Valeur
URL du serveur	`https://zip1.io/mcp`
Transport	HTTP (Streamable)
Version du protocole	MCP 2024-11-05
Format des messages	JSON-RPC 2.0
Authentification	Aucune (limité en débit)
Limite de débit	30 requêtes/minute par IP
Outils disponibles	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Utilisation avec d'autres clients MCP

Tout client compatible MCP prenant en charge le transport HTTP peut se connecter à zip1.io. Voici quelques exemples :

Requêtes HTTP directes (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"
      }
    }
  }'

Exemple de client 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)

Configuration auto-hébergée

Si vous exécutez votre propre instance de zip1.io, configurez les clients pour qu'ils pointent vers votre instance :

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

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

💬 Exemples de conversations

Voici quelques requêtes en langage naturel que vous pouvez utiliser avec Claude :

Création d'URL courtes

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

Réponse de Claude :
✅ URL courte créée : https://zip1.io/\[code\]
🔤 Code généré : [code]
🔗 URL d'origine : https://github.com/anthropics/claude-mcp
📊 Voir les statistiques : https://zip1.io/stats/\[code\]

Alias personnalisés et mots de passe

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

Réponse de Claude :
✅ URL courte créée : https://zip1.io/docs
📝 Alias personnalisé : docs
🔒 Protégé par mot de passe : Oui
🔗 URL d'origine : https://docs.myapp.com

Obtention de statistiques

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

Réponse de Claude :
📊 Statistiques pour : https://zip1.io/docs
👆 Clics totaux : 127
👤 Clics uniques : 89
🔒 Protégé par mot de passe : Oui
📅 Créé : 2024-01-15T10:30:00

🌍 Principaux pays :
1. États-Unis : 54 clics
2. Royaume-Uni : 23 clics
3. Canada : 18 clics

Validation d'URL

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

Réponse de Claude :
❌ URL invalide : doit inclure le protocole http:// ou https:// et un domaine valide

🛠️ Outils disponibles

Le serveur MCP zip1.io fournit quatre outils que Claude peut utiliser :

Outil	Description	Exemple d'utilisation
`create_short_url`	Créer des URL raccourcies avec alias personnalisés, mots de passe et clics maximum facultatifs	"Raccourcis cette URL avec l'alias 'mylink'"
`get_url_stats`	Récupérer des statistiques détaillées incluant clics, pays et horodatages	"Obtenir les statistiques du code court 'abc123'"
`validate_url`	Vérifier si une URL est valide et peut être raccourcie	"Puis-je raccourcir example.com ?"
`generate_short_code`	Générer une suggestion de code court aléatoire	"Générer un code court aléatoire"

description sur create_short_url est une note privée facultative pour votre propre intégration, jusqu'à 100 caractères. Elle n'est pas affichée sur les pages publiques du lien. Évitez d'y inclure des données personnelles que vous ne souhaiteriez pas stocker. La réponse de création la renvoie.

🔧 Détails techniques

Point de terminaison MCP

GET /mcp

Renvoie les informations du serveur, les outils disponibles et les détails de configuration.

Informations sur le protocole

Version du protocole : MCP 2024-11-05
Transport : HTTP Streamable
Format des messages : JSON-RPC 2.0
Limite de débit : 30 requêtes par minute par IP

Sécurité

Toutes les communications utilisent le chiffrement HTTPS
Les mots de passe sont hachés avec bcrypt avant stockage
La limitation de débit empêche les abus
Même infrastructure de sécurité que l'API REST

💡 Cas d'utilisation

📝 Création de contenu

Générez des URL courtes pendant la rédaction d'articles de blog, de documentation ou de contenu pour les réseaux sociaux sans quitter votre assistant IA.

📊 Statistiques rapides

Demandez les performances des liens pendant les conversations. "Combien de clics mon lien de campagne a-t-il obtenus ?"

🔐 Partage sécurisé

Créez des liens protégés par mot de passe à la volée lors du partage d'informations sensibles dans les discussions d'équipe.

🎯 Gestion de campagnes

Créez des URL avec alias personnalisés pour les campagnes marketing à l'aide de commandes en langage naturel.

🔍 Dépannage

Erreurs de limitation de débit ?

Le point de terminaison MCP a une limite de 30 requêtes par minute
Attendez une minute et réessayez

Les outils n'apparaissent pas dans Claude Code ?

Assurez-vous que l'URL du serveur MCP est accessible
Essayez de visiter https://zip1.io/mcp dans votre navigateur
Vérifiez votre configuration MCP avec claude mcp list

📚 Ressources et documentation

Documentation officielle MCP - En savoir plus sur le Model Context Protocol
SDK Python MCP - Créez vos propres serveurs MCP
Documentation de l'API REST - Accès API traditionnel

Prêt à commencer ?

Ajoutez zip1.io à Claude Code dès maintenant et commencez à raccourcir des URL avec l'IA

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