Linkly MCP 서버

Linkly — URL 단축기이자 링크 관리 플랫폼 — 의 공식 Model Context Protocol(MCP) 서버입니다.

이 저장소는 https://mcp.linklyhq.com에서 호스팅되는 MCP 서버를 구동합니다. 이것이 AI 어시스턴트를 MCP를 통해 Linkly에 연결하는 유일하게 지원되는 방식입니다. 설정 방법은 https://linklyhq.com/support/mcp-server를 참조하세요.

⚠️ linkly-mcp-server npm 패키지는 더 이상 사용되지 않습니다. 자체 호스팅 / API 키 방식은 더 이상 유지 관리되지 않습니다. 모든 사용자는 호스팅 서버로 마이그레이션해야 합니다 — OAuth 2.1 with PKCE를 사용하며, API 키나 로컬 설치가 필요 없고, 항상 최신 도구 세트를 실행합니다. npm 패키지는 이전 버전과의 호환성을 위해 레지스트리에 계속 존재하지만 새 도구나 버그 수정은 받지 않으며, 향후 게시가 중단될 수 있습니다.

문서

전체 문서, 설정 가이드 및 예제는 다음을 방문하세요: https://linklyhq.com/support/mcp-server

Related MCP server: DWZ Short URL MCP Server

기능

• 짧은 링크 생성, 업데이트 및 삭제

• 클릭 분석 및 통계 보기

• 사용자 지정 도메인 및 파비콘 관리

• 클릭 이벤트에 대한 웹훅 구성

• 링크 검색 및 필터링

• 클릭 데이터 내보내기

호스팅 서버 사용

서버 URL: https://mcp.linklyhq.com

MCP 클라이언트를 호스팅 서버에 연결하고 브라우저가 열리면 Linkly에 로그인하세요. 그게 전부입니다 — API 키도, 설치도, 구성 변경도 필요 없습니다.

Claude Desktop

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Code (CLI)

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

ChatGPT Desktop

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

사용 가능한 도구

링크

• Linkly 웹사이트

• 문서

• API 참조

• GitHub 저장소

지원

도움말 및 지원은 Linkly 지원을 방문하거나 support@linklyhq.com으로 이메일을 보내세요.

MCP 레지스트리에 게시 (관리자)

저장소 루트의 server.json은 com.linklyhq/linkly 서버의 공식 MCP 레지스트리 매니페스트입니다. 원격 전용입니다: 클라이언트를 호스팅 서버로 안내하며 의도적으로 패키지를 포함하지 않습니다 (deprecated된 npm 배포는 v2.0.0에서 제거되었습니다).

게시하려면 linklyhq.com에 대한 DNS 액세스가 필요합니다 — com.linklyhq 네임스페이스는 도메인 에이펙스의 DNS TXT 레코드를 통해 검증됩니다:

# 1. Generate an Ed25519 key + TXT record (macOS: use openssl@3; system LibreSSL lacks Ed25519)
openssl genpkey -algorithm Ed25519 -out key.pem
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "linklyhq.com. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""   # add at the APEX of linklyhq.com

# 2. Authenticate the namespace + publish
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain linklyhq.com --private-key "$PRIVATE_KEY"
mcp-publisher publish

자세한 내용은 레지스트리 인증 가이드를 참조하세요.

ChatGPT 앱 업데이트 (관리자)

chatgpt-app-submission.json은 OpenAI Apps SDK 제출 가져오기입니다 — 25개 도구 모두에 대한 도구별 주석과 세 가지 안전 근거 (읽기 전용 / 개방형 세계 / 파괴적)를 미리 채워 대시보드에서 수동으로 입력할 필요가 없습니다.

OpenAI는 게시 시 메타데이터 스냅샷을 고정하며 MCP 변경 사항을 자동 감지하지 않으므로, 서버 변경 사항을 배포한 후 새 버전을 게시해야 합니다:

1. 워커를 배포합니다 (연결된 브랜치에 푸시 / wrangler deploy).

2. 플랫폼 대시보드 → Linkly 앱 → 새 초안 버전 생성 (동일한 MCP URL https://mcp.linklyhq.com 유지).

3. MCP 섹션에서 도구 스캔을 클릭하여 실시간 도구 목록 + 주석을 다시 읽습니다.

4. chatgpt-app-submission.json을 양식(페이지 상단)에 끌어다 놓아 근거를 채웁니다.

5. 테스트를 검토한 다음 제출합니다. 게시된 버전은 새 버전이 승인될 때까지 실시간 서버에 대해 계속 실행됩니다.

도구가 추가/제거되거나 readOnlyHint/destructiveHint가 변경될 때마다 이 파일을 워커와 동기화하세요. 파괴 플래그는 5개의 진정한 파괴 도구(delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook)에 대해서만 true입니다; 생성/업데이트/구독은 추가적(false)입니다.

라이선스

MIT