Linkly Link Shortener

공식

Linkly는 지리적 리디렉션, 링크 로테이터, 전환 추적 및 강력한 링크 단축 API를 갖춘 링크 단축기입니다.

Linkly Link Shortener MCP(으)로 무엇을 할 수 있나요?

단축 링크 만들기 — 어시스턴트에게 create_link으로 URL을 단축하도록 요청하세요. UTM 매개변수, 픽셀, 만료 설정도 포함할 수 있습니다.
링크 성과 추적 — get_clicks 또는 get_analytics를 사용하여 특정 기간 동안 링크가 받은 클릭 수를 확인하세요.
링크 검색 및 관리 — search_links로 링크를 찾고, update_link로 대상 주소나 설정을 업데이트하세요.
분석 세부 내역 보기 — get_analytics_by를 사용하여 국가, 브라우저 또는 플랫폼별 클릭 수를 확인하세요.
사용자 지정 도메인 관리 — list_domains로 사용자 지정 도메인 목록을 확인하여 새 링크에 사용할 수 있는 도메인을 파악하세요.
웹훅 설정 — subscribe_webhook으로 클릭 이벤트에 대한 URL을 구독하여 알림을 받으세요.

문서

Linkly MCP 서버를 사용하면 Model Context Protocol을 통해 AI 어시스턴트를 Linkly 계정에 연결할 수 있습니다. 연결이 완료되면 자연어 대화를 통해 단축 링크를 만들고 관리할 수 있습니다.

MCP란 무엇인가요?

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

지원되는 AI 어시스턴트

Linkly MCP 서버는 다음에서 작동합니다:

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

어디에서 찾을 수 있나요?

Linkly MCP 서버는 주요 MCP 디렉터리에 등록되어 있으므로, 커넥터를 찾는 기존 경로에서 바로 설치할 수 있습니다:

Claude 커넥터 디렉터리 — Claude(웹 및 Desktop)에서 원클릭 연결
공식 MCP 레지스트리 — com.linklyhq/linkly
Smithery
Glama
mcp.so
ClaudePluginHub — Claude Code 및 Cowork용 Linkly 플러그인
GitHub 소스 — MIT 라이선스

MCP 서버 또는 Linkly CLI?

AI 어시스턴트가 셸 명령을 실행할 수 있는 코딩 에이전트(예: Claude Code 또는 Cursor)라면 MCP 서버보다 Linkly CLI가 더 적합한 경우가 많습니다. 코딩 에이전트는 이미 명령줄 도구를 다루는 데 익숙하며, CLI는 모든 명령에서 --json 출력과 전체 명령 트리를 출력하는 linkly schema 명령을 제공하므로 에이전트가 수행할 수 있는 모든 작업을 스스로 발견할 수 있습니다. MCP 서버는 Claude Desktop 및 ChatGPT Desktop처럼 셸 명령을 실행할 수 없는 어시스턴트에게 더 나은 선택입니다.

할 수 있는 작업

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

단축 링크 만들기 - "https://example.com에 대한 단축 링크를 만들어 줘"
성과 추적 - "이번 주 내 링크 클릭 수는 얼마인가요?"
링크 관리 - "'promo'라는 링크의 대상을 새 주소로 업데이트해 줘"
분석 보기 - "지난 30일간 국가별 클릭 수를 보여 줘"
링크 검색 - "제품 출시와 관련된 모든 링크를 찾아 줘"
도메인 관리 - "내 사용자 지정 도메인 목록을 보여 줘"
웹훅 설정 - "https://my-site.com/webhook를 클릭 이벤트 수신에 등록해 줘"

시작하기

호스팅된 Linkly MCP 서버는 https://mcp.linklyhq.com에 있습니다. 설치할 것이 없고 복사할 API 키도 없습니다. 서버는 OAuth를 사용하므로 AI 어시스턴트가 처음 연결할 때 브라우저 창이 열려 Linkly에 로그인하고 액세스를 승인하라는 메시지가 표시됩니다. 이후에는 어시스턴트가 연결된 상태를 유지합니다.

https://mcp.linklyhq.com

구성

Claude Desktop

Claude Desktop에서 설정 → 커넥터 → 사용자 지정 커넥터 추가로 이동합니다. 이름(Linkly)과 원격 MCP 서버 URL을 입력합니다:

https://mcp.linklyhq.com

추가를 클릭한 다음 Linkly 커넥터에서 연결을 클릭합니다. 로그인하고 액세스를 승인할 수 있는 브라우저 탭이 열립니다. 그러면 Claude Desktop이 연결된 상태를 유지합니다. 구성 파일이나 추가 도구가 필요 없습니다.

Claude Code(CLI)

Claude Code는 원격 MCP 서버를 기본적으로 지원합니다. 한 가지 명령으로 Linkly를 추가하세요:

claude mcp add --transport http linkly https://mcp.linklyhq.com

그런 다음 Claude Code에서 /mcp를 실행하고 linkly를 선택한 다음, 메시지가 표시되면 브라우저에서 인증합니다.

ChatGPT Desktop

ChatGPT 구성 파일을 엽니다:

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

Linkly MCP 서버를 추가합니다:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

사용 가능한 도구

도구	설명
`create_link`	선택적 UTM 매개변수, 픽셀 등을 포함한 새 단축 링크 만들기
`update_link`	기존 링크의 설정 업데이트
`delete_link`	링크 삭제
`get_link`	특정 링크의 세부 정보 가져오기
`list_links`	작업 공간의 모든 링크 나열
`search_links`	이름, URL 또는 메모로 링크 검색
`get_clicks`	최근 클릭 데이터 가져오기
`get_analytics`	차트용 시계열 클릭 데이터 가져오기
`get_analytics_by`	국가, 브라우저, 플랫폼 등으로 그룹화된 클릭 수 가져오기
`list_domains`	사용자 지정 도메인 나열
`list_webhooks`	작업 공간 웹훅 구독 목록
`subscribe_webhook`	클릭 이벤트 수신을 위한 URL 구독

링크 생성 옵션

링크를 만들 때 다음을 지정할 수 있습니다:

기본: 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

문제 해결

"MCP 서버에 연결할 수 없습니다"

https://mcp.linklyhq.com이(가) 사용자 머신에서 연결 가능한지 확인하세요
Claude Code에서 /mcp을(를) 실행하고 linkly를 선택하여 OAuth 흐름을 다시 트리거하세요

"인증 실패", "invalid_client" 또는 브라우저가 계속 로그인을 요청함

이는 클라이언트가 만료된 연결 등록을 보유하고 있음을 의미합니다. 캐시된 자격 증명을 지우고 다시 인증하세요. Claude Code에서 /mcp → linkly → 다시 연결을 실행하세요. Claude Desktop에서는 설정 → 커넥터에서 Linkly 커넥터를 제거하고 다시 추가한 다음 다시 로그인하세요.

도구가 표시되지 않음

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

MCP 서버 FAQ

MCP 서버를 사용하려면 무엇을 설치해야 하나요?

아니요. https://mcp.linklyhq.com의 호스팅 서버는 OAuth를 사용합니다. 브라우저에서 한 번 로그인하면 AI 어시스턴트가 연결된 상태를 유지합니다. AI 어시스턴트 자체 외에 머신에 설치할 소프트웨어는 없습니다.

API 키가 필요한가요?

아니요. MCP 서버는 OAuth를 사용합니다. AI 어시스턴트가 처음 연결할 때 브라우저를 통해 Linkly에 로그인하면 되며, 복사하거나 붙여넣을 API 키는 없습니다.

어떤 AI 어시스턴트가 MCP를 지원하나요?

Claude Desktop, Claude Code(CLI), ChatGPT Desktop 모두 MCP를 지원합니다. Cursor 및 Windsurf와 같은 다른 도구도 MCP를 지원합니다.

내 계정은 안전한가요?

예. 호스팅 서버는 PKCE가 포함된 OAuth 2.1을 사용합니다. Linkly 비밀번호는 app.linklyhq.com에서만 입력되며, AI 어시스턴트는 작업 공간에 범위가 지정된 액세스 토큰만 볼 수 있습니다. AI 모델 자체는 사용자의 자격 증명을 볼 수 없습니다.

Claude 또는 ChatGPT의 웹 버전에서 MCP를 사용할 수 있나요?

아니요. MCP는 데스크톱 애플리케이션 또는 Claude Code CLI가 필요합니다. 웹 버전은 MCP 연결을 지원하지 않습니다.

MCP 서버를 어떻게 업데이트하나요?

업데이트할 것이 없습니다. 호스팅 서버에 개선 사항을 지속적으로 배포하며, 연결된 모든 클라이언트가 자동으로 받게 됩니다.

무료로 단축 링크 100개를 만들고 월간 클릭 500회를 추적하세요.

무료로 시작하기

신용카드 불필요

대용량이 필요하신가요? 팀에 문의하세요