Linkly MCP 서버

Linkly MCP 서버를 사용하면 Model Context Protocol을 사용하여 AI 어시스턴트를 Linkly 계정에 연결할 수 있습니다. 연결하면 자연스러운 대화를 통해 단축 링크를 생성하고 관리할 수 있습니다.

Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구 및 데이터 소스에 안전하게 연결할 수 있도록 하는 개방형 표준입니다. 앱 간에 복사하여 붙여넣는 대신 AI 어시스턴트에게 직접 작업을 수행하도록 요청할 수 있습니다.

Linkly MCP 서버는 다음과 함께 작동합니다:

• Claude Desktop
• ChatGPT Desktop
• 기타 MCP 호환 클라이언트(Cursor, Windsurf 등)

연결되면 AI 어시스턴트에게 다음을 요청할 수 있습니다:

• 단축 링크 생성 - "https://example.com에 대한 단축 링크 만들어줘"
• 성과 추적 - "이번 주에 내 링크에 클릭이 몇 번 발생했어?"
• 링크 관리 - "'promo'라는 링크를 새 대상으로 업데이트해줘"
• 분석 보기 - "지난 30일간 국가별 클릭 수를 보여줘"
• 링크 검색 - "제품 출시와 관련된 모든 링크를 찾아줘"
• 도메인 관리 - "내 커스텀 도메인을 나열해줘"
• 웹훅 설정 - "https://my-site.com/webhook을 구독하여 클릭 이벤트를 받도록 해줘"

Linkly MCP 서버는 두 가지 방법으로 사용할 수 있습니다:

호스팅된 MCP 서버 사용 - 설치 불필요:

https://mcp.linklyhq.com

npx를 사용하여 로컬에서 설치 및 실행:

npx -y linkly-mcp-server

또는 전역으로 설치:

npm install -g linkly-mcp-server

npm에서 패키지를 확인하세요.

1. 1Linkly 대시보드에 로그인
2. 2설정 → API 키로 이동
3. 3API 키 및 워크스페이스 ID를 복사

Claude Desktop 구성 파일 열기:

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

Linkly MCP 서버 추가:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

ChatGPT 구성 파일 열기:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

Linkly MCP 서버 추가:

npx 사용:

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

호스팅 서버 사용:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

링크를 생성할 때 다음을 지정할 수 있습니다:

• 기본: url, name, note, domain, slug, enabled
• UTM 매개변수: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Open Graph: og_title, og_description, og_image
• 추적: fb_pixel_id, ga4_tag_id, gtm_id
• 고급: cloaking, forward_params, block_bots, hide_referrer
• 만료: expiry_datetime, expiry_destination

• API 키와 워크스페이스 ID가 올바른지 확인
• Node.js가 설치되어 있는지 확인 (v18 이상)
• 터미널에서 npx linkly-mcp-server를 실행하여 오류 확인

• 설정 → API 키에서 Linkly 대시보드에서 API 키 확인
• 자격 증명에 추가 공백이 없는지 확인
• API 키 재생성 시도

• 구성을 저장한 후 AI 어시스턴트 재시작
• 구성 파일의 JSON 구문이 유효한지 확인
• MCP 서버가 실행 중인지 확인 (어시스턴트에서 도구 아이콘 확인)

• 명령 경로가 올바른지 확인
• 호스팅 서버를 사용하는 경우 인터넷 연결 확인
• 터미널에서 MCP 서버가 수동으로 실행되는지 확인

• Claude Desktop 통합
• ChatGPT 통합
• Linkly API 문서
• 웹훅
• npm의 MCP 서버
• Model Context Protocol