Zip1 MCP Server

официальный

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

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

Сократить
API
MCP
Статистика
Контакты

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

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

🤖

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

Общайтесь с вашим сокращателем ссылок так же, как с ИИ

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

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

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

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

Терминал

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

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

Терминал

claude mcp list

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

Для Claude Desktop

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

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

Установите CLI-инструмент MCP-клиента для соединения 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

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

claude_desktop_config.json

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

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

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

Для опытных пользователей создайте собственный скрипт-мост stdio-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();
});

Сделайте его исполняемым и добавьте в конфигурацию 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 сервера	http://zip1.io/mcp
Транспорт	HTTP (потоковый)
Версия протокола	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 http://zip1.io/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Создание короткого URL

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

Пример клиента на Python

Скрипт 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)

Конфигурация для собственного хостинга

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

Claude Code

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

Claude Desktop (с mcp-client)

{
  "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	Генерация случайного короткого кода	«Сгенерируй случайный короткий код»

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

MCP-эндпоинт

GET /mcp

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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