Zip1

🤖 AI 통합 (MCP)

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

🤖

AI 기반 URL 관리

AI와 대화하듯 URL 단축 서비스와 소통하세요

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

⚡ 빠른 설정

Claude Code용 (권장)

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

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

설치 확인:

claude mcp list

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

Claude Desktop용

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

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

MCP 클라이언트 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"]
    }
  }
}

⚙️ 서버 구성

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

서버 세부 정보

구성 항목	값
서버 URL	https://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 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:// 프로토콜과 유효한 도메인이 포함되어야 합니다

🛠️ 사용 가능한 도구

zip1.io MCP 서버는 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
• 속도 제한: IP당 분당 30회 요청

보안

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

💡 사용 사례

📝 콘텐츠 제작

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

📊 빠른 분석

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

🔐 안전한 공유

팀 채팅에서 민감한 정보를 공유할 때 즉석에서 비밀번호 보호 링크를 만드세요.

🎯 캠페인 관리

자연어 명령으로 마케팅 캠페인용 사용자 지정 별칭 URL을 만드세요.

🔍 문제 해결

속도 제한 오류가 발생하나요?

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

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

• MCP 서버 URL에 접근할 수 있는지 확인하세요
• 브라우저에서 https://zip1.io/mcp을 방문해 보세요
• claude mcp list으로 MCP 구성을 확인하세요

📚 리소스 및 문서

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

시작할 준비가 되셨나요?

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

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