Zip1

oficial

Un acortador de URL gratuito

Ver en zip1.ioPrueba este MCPPatrocinado

¿Qué puedes hacer con Zip1 MCP?

Acortar URLs — Pídele a tu asistente que cree un enlace corto a partir de cualquier URL válida usando create_short_url.
Alias personalizados y contraseñas — Solicita un enlace corto con marca, un alias personalizado y protección opcional con contraseña mediante create_short_url.
Verificar validez de la URL — Pregunta si una URL se puede acortar antes de crear un enlace, usando la herramienta validate_url.
Obtener análisis del enlace — Consulta recuentos de clics, visitantes únicos y los principales países para cualquier código corto con get_url_stats.
Generar códigos cortos — Pide una sugerencia de código corto aleatorio para usar como alias personalizado.

Documentación

🤖 Integración de IA (MCP)

Usa zip1.io directamente desde asistentes de IA como Claude a través del Protocolo de Contexto de Modelo (MCP). Acorta URLs, obtén analíticas y gestiona enlaces usando comandos en lenguaje natural.

🤖

Gestión de URLs Impulsada por IA

Habla con tu acortador de URLs como hablas con una IA

✨ Interfaz en lenguaje natural: no se necesita sintaxis de API
⚡ Acortamiento de URLs instantáneo desde tu asistente de IA
📊 Obtén analíticas bajo demanda con indicaciones simples
🔒 Crea enlaces protegidos con contraseña de forma conversacional

⚡ Configuración Rápida

Para Claude Code (Recomendado)

Claude Code admite servidores MCP HTTP directamente mediante CLI. Simplemente ejecuta:

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

Verifica la instalación:

claude mcp list

✅ ¡Eso es todo! Ahora puedes usar zip1.io directamente desde Claude Code.

Para Claude Desktop

⚠️ Requiere Proxy: Claude Desktop solo admite servidores MCP basados en stdio, no servidores HTTP. Necesitarás un proxy local para puentear la conexión.

Opción 1: Usando mcp-client-cli (Recomendado)

Instala la herramienta CLI del cliente MCP para puentear stdio a HTTP:

npm install -g @modelcontextprotocol/client-cli

Luego edita tu archivo de configuración de Claude Desktop:

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

Añade esta configuración:

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

Reinicia Claude Desktop y las herramientas de zip1.io estarán disponibles.

Opción 2: Proxy Personalizado en Node.js

Para usuarios avanzados, crea un script de puente stdio-a-HTTP personalizado:

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

Hazlo ejecutable y añádelo a tu configuración de Claude Desktop:

chmod +x zip1-mcp-proxy.js

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

⚙️ Configuración del Servidor

El servidor MCP de zip1.io está disponible como un endpoint HTTP al que cualquier cliente compatible con MCP puede conectarse.

Detalles del Servidor

Elemento de Configuración	Valor
URL del Servidor	`https://zip1.io/mcp`
Transporte	HTTP (Streamable)
Versión del Protocolo	MCP 2024-11-05
Formato de Mensaje	JSON-RPC 2.0
Autenticación	Ninguna (con límite de velocidad)
Límite de Velocidad	30 solicitudes/minuto por IP
Herramientas Disponibles	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Uso con Otros Clientes MCP

Cualquier cliente compatible con MCP que admita transporte HTTP puede conectarse a zip1.io. Aquí hay algunos ejemplos:

Solicitudes HTTP Directas (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"
      }
    }
  }'

Ejemplo de Cliente 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)

Configuración Autoalojada

Si estás ejecutando tu propia instancia de zip1.io, configura los clientes para que apunten a tu instancia:

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

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

💬 Ejemplos de Conversaciones

Aquí hay algunas indicaciones en lenguaje natural que puedes usar con Claude:

Creando URLs Cortas

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

Respuesta de Claude:
✅ URL corta creada: https://zip1.io/\[código\]
🔤 Código generado: [código]
🔗 URL original: https://github.com/anthropics/claude-mcp
📊 Ver estadísticas: https://zip1.io/stats/\[código\]

Aliases Personalizados y Contraseñas

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

Respuesta de Claude:
✅ URL corta creada: https://zip1.io/docs
📝 Alias personalizado: docs
🔒 Protegido con contraseña: Sí
🔗 URL original: https://docs.myapp.com

Obteniendo Analíticas

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

Respuesta de Claude:
📊 Estadísticas para: https://zip1.io/docs
👆 Clics totales: 127
👤 Clics únicos: 89
🔒 Protegido con contraseña: Sí
📅 Creado: 2024-01-15T10:30:00

🌍 Principales países:
1. Estados Unidos: 54 clics
2. Reino Unido: 23 clics
3. Canadá: 18 clics

Validación de URLs

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

Respuesta de Claude:
❌ La URL no es válida: Debe incluir el protocolo http:// o https:// y un dominio válido

🛠️ Herramientas Disponibles

El servidor MCP de zip1.io proporciona cuatro herramientas que Claude puede usar:

Herramienta	Descripción	Ejemplo de Uso
`create_short_url`	Crear URLs acortadas con aliases personalizados opcionales, contraseñas y clics máximos	"Acorta esta URL con el alias 'mylink'"
`get_url_stats`	Recuperar analíticas detalladas incluyendo clics, países y marcas de tiempo	"Obtén estadísticas para el código corto 'abc123'"
`validate_url`	Comprobar si una URL es válida y puede acortarse	"¿Puedo acortar example.com?"
`generate_short_code`	Generar una sugerencia de código corto aleatorio	"Genera un código corto aleatorio"

description en create_short_url es una nota privada opcional para tu propia integración, de hasta 100 caracteres. No se muestra en las páginas públicas del enlace. Mantenla libre de datos personales que no quieras almacenar. La respuesta de creación la devuelve.

🔧 Detalles Técnicos

Endpoint MCP

GET /mcp

Devuelve información del servidor, herramientas disponibles y detalles de configuración.

Información del Protocolo

Versión del Protocolo: MCP 2024-11-05
Transporte: HTTP Streamable
Formato de Mensaje: JSON-RPC 2.0
Límite de Velocidad: 30 solicitudes por minuto por IP

Seguridad

Toda la comunicación utiliza cifrado HTTPS
Las contraseñas se cifran con bcrypt antes de almacenarse
El límite de velocidad previene el abuso
Misma infraestructura de seguridad que la API REST

💡 Casos de Uso

📝 Creación de Contenido

Genera URLs cortas mientras escribes publicaciones de blog, documentación o contenido para redes sociales sin salir de tu asistente de IA.

📊 Analíticas Rápidas

Pregunta por el rendimiento de enlaces durante las conversaciones. "¿Cuántos clics obtuvo mi enlace de campaña?"

🔐 Compartición Segura

Crea enlaces protegidos con contraseña sobre la marcha al compartir información sensible en chats de equipo.

🎯 Gestión de Campañas

Crea URLs con aliases personalizados para campañas de marketing con comandos en lenguaje natural.

🔍 Solución de Problemas

¿Errores por límite de velocidad?

El endpoint MCP tiene un límite de 30 solicitudes por minuto
Espera un minuto e inténtalo de nuevo

¿Las herramientas no aparecen en Claude Code?

Asegúrate de que la URL del servidor MCP sea accesible
Intenta visitar https://zip1.io/mcp en tu navegador
Verifica tu configuración MCP con claude mcp list

📚 Recursos y Documentación

Documentación Oficial de MCP - Aprende más sobre el Protocolo de Contexto de Modelo
SDK de Python para MCP - Construye tus propios servidores MCP
Documentación de la API REST - Acceso tradicional a la API

¿Listo para Empezar?

Añade zip1.io a Claude Code ahora y comienza a acortar URLs con IA

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