Zip1

officiel

Un raccourcisseur d'URL gratuit

Voir sur zip1.io

Que pouvez-vous faire avec Zip1 MCP ?

Raccourcir une URL — Demandez à l'IA de créer un lien court via create_short_url, éventuellement avec un alias personnalisé, un mot de passe ou un nombre maximal de clics.
Obtenir les analyses d'un lien — Demandez le nombre de clics, les visiteurs uniques, les principaux pays et les horodatages pour tout code court à l'aide de get_url_stats.
Valider une URL avant de la raccourcir — Vérifiez si une URL utilise un protocole et un format autorisés avec validate_url.
Générer un code court aléatoire — Utilisez generate_short_code pour obtenir un code suggéré pour un nouveau lien court.

Documentation

Raccourcir
API
MCP
Statistiques
Contact

🤖 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 analyses et gérez des liens à l’aide de commandes en langage naturel.

🤖

Gestion d’URL assistée par IA

Parlez à votre raccourcisseur d’URL comme vous parlez à une IA

✨ Interface en langage naturel – aucune syntaxe d’API nécessaire
⚡ Raccourcissement d’URL instantané depuis votre assistant IA
📊 Obtenez des analyses à la demande avec de simples invites
🔒 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 la CLI. Exécutez simplement :

Terminal

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

Vérifiez l’installation :

Terminal

claude mcp list

✅ C’est tout ! Vous pouvez maintenant 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 : Utiliser mcp-client-cli (recommandé)

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

Terminal

npm install -g @modelcontextprotocol/client-cli

Modifiez ensuite 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 :

claude_desktop_config.json

{
  "mcpServers": {
    "zip1": {
      "command": "mcp-client",
      "args": ["http://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é :

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

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

Terminal

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 en tant que point de terminaison HTTP auquel tout client compatible MCP peut se connecter.

Détails du serveur

Élément de configuration	Valeur
URL du serveur	http://zip1.io/mcp
Transport	HTTP (Streamable)
Version du protocole	MCP 2024-11-05
Format des messages	JSON-RPC 2.0
Authentification	Aucune (limitation de 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)

Lister les outils disponibles

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

Créer une URL courte

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

Exemple de client Python

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

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 Code

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

Claude Desktop (avec mcp-client)

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

💬 Exemples de conversations

Voici quelques invites en langage naturel que vous pouvez utiliser avec Claude :

Créer des URL courtes

Invite

"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

Invite

"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

Obtenir des analyses

Invite

"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éé le : 2024-01-15T10:30:00

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

Validation d’URL

Invite

"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 max	« Raccourcir cette URL avec l’alias ’monlien’ »
get_url_stats	Récupérer des analyses détaillées incluant clics, pays et horodatages	« Obtenir les stats du code court ’abc123’ »
validate_url	Vérifier si une URL est valide et peut être raccourcie	« Puis-je raccourcir exemple.com ? »
generate_short_code	Générer une suggestion de code court aléatoire	« Générer un code court aléatoire »

🔧 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 lors de la rédaction d’articles de blog, de documentation ou de contenu pour les réseaux sociaux sans quitter votre assistant IA.

📊 Analyses rapides

Demandez les performances d’un lien au cours d’une conversation. « Combien de clics mon lien de campagne a-t-il reçu ? »

🔐 Partage sécurisé

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

🎯 Gestion de campagne

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 http://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 traditionnel à l’API

Prêt à démarrer ?

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

Configuration rapide