Zip1

официальный

Бесплатный сокращатель ссылок

Смотреть на zip1.ioПопробовать этот MCPСпонсировано

Что можно делать с Zip1 MCP?

Сокращение ссылок — Попросите ассистента создать короткую ссылку из любого допустимого URL с помощью create_short_url.
Пользовательские алиасы и пароли — Запросите брендированную короткую ссылку с пользовательским алиасом и необязательной защитой паролем через create_short_url.
Проверка валидности URL — Спросите, можно ли сократить URL перед созданием ссылки, используя инструмент validate_url.
Получение аналитики по ссылкам — Получите количество кликов, уникальных посетителей и топ-стран для любого короткого кода с помощью get_url_stats.
Генерация коротких кодов — Попросите предложить случайный короткий код для использования в качестве пользовательского алиаса.

Документация

🤖 Интеграция с ИИ (MCP)

Используйте zip1.io напрямую из ИИ-ассистентов, таких как Claude, через Model Context Protocol (MCP). Сокращайте URL-адреса, получайте аналитику и управляйте ссылками с помощью команд на естественном языке.

🤖

Управление URL-адресами с помощью ИИ

Общайтесь со своим сокращателем URL-адресов, как с ИИ

✨ Интерфейс на естественном языке — синтаксис API не нужен
⚡ Мгновенное сокращение URL-адресов из вашего ИИ-ассистента
📊 Получайте аналитику по запросу с помощью простых подсказок
🔒 Создавайте ссылки с паролем в режиме диалога

⚡ Быстрая настройка

Для Claude Code (рекомендуется)

Claude Code поддерживает HTTP MCP-серверы напрямую через CLI. Просто выполните:

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

Проверьте установку:

claude mcp list

✅ Вот и всё! Теперь вы можете использовать zip1.io напрямую из Claude Code.

Для Claude Desktop

⚠️ Требуется прокси: Claude Desktop поддерживает только MCP-серверы на основе stdio, а не HTTP-серверы. Вам понадобится локальный прокси для соединения.

Вариант 1: Использование mcp-client-cli (рекомендуется)

Установите инструмент MCP client CLI для соединения stdio с HTTP:

npm install -g @modelcontextprotocol/client-cli

Затем отредактируйте файл конфигурации Claude Desktop:

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

Добавьте эту конфигурацию:

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

Перезапустите Claude Desktop, и инструменты zip1.io станут доступны.

Вариант 2: Пользовательский Node.js прокси

Для продвинутых пользователей создайте собственный скрипт-мост stdio-to-HTTP:

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

Сделайте его исполняемым и добавьте в конфигурацию Claude Desktop:

chmod +x zip1-mcp-proxy.js

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

⚙️ Конфигурация сервера

MCP-сервер zip1.io доступен как HTTP-эндпоинт, к которому может подключиться любой MCP-совместимый клиент.

Детали сервера

Элемент конфигурации	Значение
URL сервера	`https://zip1.io/mcp`
Транспорт	HTTP (Streamable)
Версия протокола	MCP 2024-11-05
Формат сообщений	JSON-RPC 2.0
Аутентификация	Нет (с ограничением частоты)
Лимит запросов	30 запросов/минуту на IP
Доступные инструменты	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

Использование с другими MCP-клиентами

Любой MCP-совместимый клиент, поддерживающий HTTP-транспорт, может подключиться к zip1.io. Вот несколько примеров:

Прямые HTTP-запросы (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"
      }
    }
  }'

Пример клиента на 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)

Самостоятельная конфигурация

Если вы запускаете собственный экземпляр zip1.io, настройте клиенты на ваш экземпляр:

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

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

💬 Примеры диалогов

Вот несколько подсказок на естественном языке, которые вы можете использовать с Claude:

Создание коротких URL-адресов

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

Ответ Claude:
✅ Короткий URL создан: https://zip1.io/\[code\]
🔤 Сгенерированный код: [code]
🔗 Исходный URL: https://github.com/anthropics/claude-mcp
📊 Просмотр статистики: https://zip1.io/stats/\[code\]

Пользовательские псевдонимы и пароли

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

Ответ Claude:
✅ Короткий URL создан: https://zip1.io/docs
📝 Пользовательский псевдоним: docs
🔒 Защита паролем: Да
🔗 Исходный URL: https://docs.myapp.com

Получение аналитики

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

Ответ Claude:
📊 Статистика для: https://zip1.io/docs
👆 Всего кликов: 127
👤 Уникальных кликов: 89
🔒 Защита паролем: Да
📅 Создано: 2024-01-15T10:30:00

🌍 Лучшие страны:
1. США: 54 клика
2. Великобритания: 23 клика
3. Канада: 18 кликов

Проверка URL-адресов

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

Ответ Claude:
❌ URL недействителен: должен включать протокол http:// или https:// и действительный домен

🛠️ Доступные инструменты

MCP-сервер zip1.io предоставляет четыре инструмента, которые может использовать Claude:

Инструмент	Описание	Пример использования
`create_short_url`	Создание сокращённых URL-адресов с необязательными пользовательскими псевдонимами, паролями и максимальным количеством кликов	"Сократи этот URL с псевдонимом 'mylink'"
`get_url_stats`	Получение подробной аналитики, включая клики, страны и временные метки	"Получи статистику для короткого кода 'abc123'"
`validate_url`	Проверка, действителен ли URL и можно ли его сократить	"Могу ли я сократить example.com?"
`generate_short_code`	Генерация случайного предложения короткого кода	"Сгенерируй случайный короткий код"

description на create_short_url — это необязательная приватная заметка для вашей собственной интеграции, до 100 символов. Она не отображается на публичных страницах ссылки. Не включайте в неё личные данные, которые вы не хотели бы хранить. Ответ на создание возвращает её.

🔧 Технические детали

MCP-эндпоинт

GET /mcp

Возвращает информацию о сервере, доступные инструменты и детали конфигурации.

Информация о протоколе

Версия протокола: MCP 2024-11-05
Транспорт: Streamable HTTP
Формат сообщений: JSON-RPC 2.0
Лимит запросов: 30 запросов в минуту на IP

Безопасность

Вся связь зашифрована с помощью HTTPS
Пароли хешируются с помощью bcrypt перед хранением
Ограничение частоты предотвращает злоупотребления
Та же инфраструктура безопасности, что и в REST API

💡 Варианты использования

📝 Создание контента

Генерируйте короткие URL-адреса при написании блогов, документации или контента для соцсетей, не покидая своего ИИ-ассистента.

📊 Быстрая аналитика

Спрашивайте о производительности ссылок во время разговоров. "Сколько кликов получила моя кампания?"

🔐 Безопасный обмен

Создавайте ссылки с паролем на лету при обмене конфиденциальной информацией в командных чатах.

🎯 Управление кампаниями

Создавайте URL-адреса с пользовательскими псевдонимами для маркетинговых кампаний с помощью команд на естественном языке.

🔍 Устранение неполадок

Ошибки ограничения частоты?

MCP-эндпоинт имеет лимит 30 запросов в минуту
Подождите минуту и попробуйте снова

Инструменты не отображаются в Claude Code?

Убедитесь, что URL MCP-сервера доступен
Попробуйте открыть https://zip1.io/mcp в браузере
Проверьте конфигурацию MCP с помощью claude mcp list

📚 Ресурсы и документация

Официальная документация MCP — узнайте больше о Model Context Protocol
MCP Python SDK — создавайте собственные MCP-серверы
Документация REST API — традиционный доступ к API

Готовы начать?

Добавьте zip1.io в Claude Code и начните сокращать URL-адреса с помощью ИИ

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