Linkly MCP 서버

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에서 Settings → Connectors → Add custom connector로 이동합니다. 이름(Linkly)과 원격 MCP 서버 URL을 입력합니다:

https://mcp.linklyhq.com

Add를 클릭한 다음 Linkly 커넥터에서 Connect를 클릭합니다. 로그인하고 액세스를 승인하기 위한 브라우저 탭이 열립니다. 그러면 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"
    }
  }
}

사용 가능한 도구

링크 생성 옵션

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

• 기본: 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에서 Settings → Connectors 아래의 Linkly 커넥터를 제거하고 다시 추가한 다음 다시 로그인합니다.

도구가 표시되지 않음

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

관련 리소스

• Claude Desktop 통합
• ChatGPT 통합
• Linkly API 문서
• Linkly CLI
• 웹훅
• Model Context Protocol