Zip1 MCP Server

• Acortar
• API
• MCP
• Estadísticas
• Contacto

🤖 Integración con 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 Potenciada por IA

Habla con tu acortador de URLs como hablas con una IA

• ✨ Interfaz en lenguaje natural - sin necesidad de sintaxis de API
• ⚡ Acortamiento instantáneo de URLs desde tu asistente de IA
• 📊 Obtén analíticas a demanda con instrucciones simples
• 🔒 Crea enlaces protegidos con contraseña de forma conversacional

⚡ Configuración Rápida

Para Claude Code (Recomendado)

Claude Code soporta servidores MCP HTTP directamente vía CLI. Simplemente ejecuta:

Terminal

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

Verifica la instalación:

Terminal

claude mcp list

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

Para Claude Desktop

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

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

Instala la herramienta CLI del cliente MCP para conectar stdio con HTTP:

Terminal

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:

claude_desktop_config.json

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

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

Opción 2: Proxy Node.js Personalizado

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

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

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

Terminal

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	http://zip1.io/mcp
Transporte	HTTP (Streamable)
Versión del Protocolo	MCP 2024-11-05
Formato de Mensaje	JSON-RPC 2.0
Autenticación	Ninguna (limitado por tasa)
Límite de Tasa	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 soporte transporte HTTP puede conectarse a zip1.io. Aquí hay algunos ejemplos:

Solicitudes HTTP Directas (curl)

Listar Herramientas Disponibles

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

Crear una URL Corta

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

Ejemplo de Cliente Python

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

Configuración Autoalojada

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

Claude Code

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

Claude Desktop (con mcp-client)

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

💬 Ejemplos de Conversación

Aquí tienes algunas instrucciones en lenguaje natural que puedes usar con Claude:

Creando URLs Cortas

Instrucción

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

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

Alias Personalizados y Contraseñas

Instrucción

"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
🔒 Protegida con contraseña: Sí
🔗 URL original: https://docs.myapp.com

Obteniendo Analíticas

Instrucción

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

Respuesta de Claude:
📊 Estadísticas para: https://zip1.io/docs
👆 Clics totales: 127
👤 Clics únicos: 89
🔒 Protegida con contraseña: Sí
📅 Creada: 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 URL

Instrucción

"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	Uso de Ejemplo
create_short_url	Crea URLs acortadas con alias personalizados, contraseñas y máximo de clics opcionales	"Acorta esta URL con el alias 'mienlace'"
get_url_stats	Recupera analíticas detalladas incluyendo clics, países y marcas de tiempo	"Obtén estadísticas para el código corto 'abc123'"
validate_url	Verifica si una URL es válida y puede ser acortada	"¿Puedo acortar ejemplo.com?"
generate_short_code	Genera una sugerencia de código corto aleatorio	"Genera un código corto aleatorio"

🔧 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 Transmisible
• Formato de Mensaje: JSON-RPC 2.0
• Límite de Tasa: 30 solicitudes por minuto por IP

Seguridad

• Toda la comunicación usa cifrado HTTPS
• Las contraseñas se hashean con bcrypt antes de almacenarse
• El límite de tasa previene abusos
• La 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 los enlaces durante las conversaciones. "¿Cuántos clics recibió el enlace de mi 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 alias personalizados para campañas de marketing con comandos en lenguaje natural.

🔍 Solución de Problemas

¿Errores de límite de tasa?

• 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 http://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

Configuración Rápida