Zip1

• 단축
• API
• MCP
• 통계
• 연락처

🤖 AI 통합 (MCP)

Claude와 같은 AI 어시스턴트에서 **Model Context Protocol (MCP)**을 통해 zip1.io를 직접 사용하세요. 자연어 명령으로 URL을 단축하고, 분석을 검색하고, 링크를 관리하세요.

🤖

AI 기반 URL 관리

URL 단축기에 AI에게 말하듯 말해보세요

• ✨ 자연어 인터페이스 - API 구문이 필요 없음
• ⚡ AI 어시스턴트에서 즉시 URL 단축
• 📊 간단한 프롬프트로 주문형 분석
• 🔒 대화형으로 비밀번호 보호 링크 생성

⚡ 빠른 설정

Claude Code용 (권장)

Claude Code는 CLI를 통해 HTTP MCP 서버를 직접 지원합니다. 다음을 실행하세요:

터미널

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

설치 확인:

터미널

claude mcp list

✅ 끝입니다! 이제 Claude Code에서 zip1.io를 직접 사용할 수 있습니다.

Claude Desktop용

⚠️ 프록시 필요: Claude Desktop은 HTTP 서버가 아닌 stdio 기반 MCP 서버만 지원합니다. 연결을 브리지하려면 로컬 프록시가 필요합니다.

옵션 1: mcp-client-cli 사용 (권장)

stdio를 HTTP로 브리지하려면 MCP 클라이언트 CLI 도구를 설치하세요:

터미널

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-to-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"]
    }
  }
}

⚙️ 서버 구성

zip1.io MCP 서버는 모든 MCP 호환 클라이언트가 연결할 수 있는 HTTP 엔드포인트로 제공됩니다.

서버 세부 정보

구성 항목	값
서버 URL	http://zip1.io/mcp
전송	HTTP (Streamable)
프로토콜 버전	MCP 2024-11-05
메시지 형식	JSON-RPC 2.0
인증	없음 (요청 제한)
요청 한도	IP당 분당 30회 요청
사용 가능한 도구	4 (create_short_url, get_url_stats, validate_url, generate_short_code)

다른 MCP 클라이언트와 사용

HTTP 전송을 지원하는 모든 MCP 호환 클라이언트는 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:// 프로토콜과 유효한 도메인을 포함해야 합니다

🛠️ 사용 가능한 도구

zip1.io MCP 서버는 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
• 전송: Streamable HTTP
• 메시지 형식: JSON-RPC 2.0
• 요청 한도: IP당 분당 30회 요청

보안

• 모든 통신은 HTTPS 암호화를 사용합니다
• 비밀번호는 저장 전에 bcrypt로 해시됩니다
• 요청 제한은 남용을 방지합니다
• REST API와 동일한 보안 인프라를 사용합니다

💡 사용 사례

📝 콘텐츠 생성

AI 어시스턴트를 떠나지 않고 블로그 게시물, 문서, 소셜 미디어 콘텐츠를 작성하면서 짧은 URL을 생성하세요.

📊 빠른 분석

대화 중에 링크 성과를 물어보세요. "내 캠페인 링크가 몇 번 클릭되었나요?"

🔐 안전한 공유

팀 채팅에서 민감한 정보를 공유할 때 즉시 비밀번호 보호 링크를 생성하세요.

🎯 캠페인 관리

자연어 명령으로 마케팅 캠페인을 위한 사용자 지정 별칭 URL을 생성하세요.

🔍 문제 해결

요청 제한 오류?

• MCP 엔드포인트는 분당 30회 요청으로 제한됩니다
• 1분 기다린 후 다시 시도하세요

Claude Code에 도구가 표시되지 않나요?

• MCP 서버 URL이 접근 가능한지 확인하세요
• 브라우저에서 http://zip1.io/mcp 방문해 보세요
• claude mcp list로 MCP 구성을 확인하세요

📚 리소스 및 문서

• 공식 MCP 문서 - Model Context Protocol에 대해 자세히 알아보기
• MCP Python SDK - 자신만의 MCP 서버 구축
• REST API 문서 - 기존 API 접근

시작할 준비가 되셨나요?

지금 Claude Code에 zip1.io를 추가하고 AI로 URL 단축을 시작하세요

빠른 설정