Linkly MCP Server
Linkly MCP 서버
Linkly — URL 단축기이자 링크 관리 플랫폼 — 의 공식 Model Context Protocol(MCP) 서버입니다.
이 저장소는 https://mcp.linklyhq.com에서 호스팅되는 MCP 서버를 구동합니다. 이것이 AI 어시스턴트를 MCP를 통해 Linkly에 연결하는 유일하게 지원되는 방식입니다. 설정 방법은 https://linklyhq.com/support/mcp-server를 참조하세요.
⚠️
linkly-mcp-servernpm 패키지는 더 이상 사용되지 않습니다. 자체 호스팅 / API 키 방식은 더 이상 유지 관리되지 않습니다. 모든 사용자는 호스팅 서버로 마이그레이션해야 합니다 — OAuth 2.1 with PKCE를 사용하며, API 키나 로컬 설치가 필요 없고, 항상 최신 도구 세트를 실행합니다. npm 패키지는 이전 버전과의 호환성을 위해 레지스트리에 계속 존재하지만 새 도구나 버그 수정은 받지 않으며, 향후 게시가 중단될 수 있습니다.
문서
전체 문서, 설정 가이드 및 예제는 다음을 방문하세요: https://linklyhq.com/support/mcp-server
Related MCP server: filoo 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.comChatGPT Desktop
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com"
}
}
}사용 가능한 도구
도구 | 설명 |
| 새 짧은 링크 생성 |
| 기존 링크 업데이트 |
| 링크 삭제 |
| 링크 세부 정보 가져오기 |
| 작업 공간의 모든 링크 나열 |
| 이름, URL 또는 메모로 링크 검색 |
| 시계열 클릭 데이터 가져오기 |
| 차원별로 그룹화된 클릭 가져오기 |
| 최근 클릭 데이터 가져오기 |
| 상세 클릭 기록 내보내기 |
| 사용자 지정 도메인 나열 |
| 사용자 지정 도메인 추가 |
| 사용자 지정 도메인 제거 |
| 도메인 파비콘 업데이트 |
| 작업 공간 웹훅 나열 |
| 웹훅 추가 |
| 웹훅 제거 |
| 링크별 웹훅 나열 |
| 링크 웹훅 추가 |
| 링크 웹훅 제거 |
링크
지원
도움말 및 지원은 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 변경 사항을 자동 감지하지 않으므로, 서버 변경 사항을 배포한 후 새 버전을 게시해야 합니다:
워커를 배포합니다 (연결된 브랜치에 푸시 /
wrangler deploy).플랫폼 대시보드 → Linkly 앱 → 새 초안 버전 생성 (동일한 MCP URL
https://mcp.linklyhq.com유지).MCP 섹션에서 도구 스캔을 클릭하여 실시간 도구 목록 + 주석을 다시 읽습니다.
chatgpt-app-submission.json을 양식(페이지 상단)에 끌어다 놓아 근거를 채웁니다.테스트를 검토한 다음 제출합니다. 게시된 버전은 새 버전이 승인될 때까지 실시간 서버에 대해 계속 실행됩니다.
도구가 추가/제거되거나 readOnlyHint/destructiveHint가 변경될 때마다 이 파일을 워커와 동기화하세요. 파괴 플래그는 5개의 진정한 파괴 도구(delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook)에 대해서만 true입니다; 생성/업데이트/구독은 추가적(false)입니다.
라이선스
MIT
Available Tools
20 toolscreate_domainCInspect
Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.
Inputs: name (required).
create_linkCInspect
Create a new Linkly short link. Returns the created link with its short URL.
Inputs: url (required), name, note, slug, +19 more.
delete_domainCInspect
Remove a custom domain from the workspace.
Inputs: domain_id (required).
delete_linkCInspect
Delete a Linkly link by its ID
Inputs: link_id (required).
export_clicksCInspect
Export detailed click records with full information (timestamp, browser, country, URL, platform, referer, bot, ISP, params).
Inputs: end, bots, start, country, +2 more.
get_analyticsAInspect
Get time-series click analytics data for charting. Returns click counts over time.
Inputs: end, bots, start, unique, +5 more.
get_analytics_byBInspect
Get click counts grouped by a dimension (country, platform, browser, etc.). Useful for breakdowns and top-N reports.
Inputs: counter (required), end, bots, start, +4 more.
get_clicksCInspect
Get recent click data for the workspace
Inputs: link_id.
list_domainsBInspect
List all custom domains in the workspace.
Inputs: no named parameters.
list_linksBInspect
List all links in the workspace. Returns links with click statistics.
Inputs: no named parameters.
list_link_webhooksBInspect
List all webhook URLs subscribed to a specific link.
Inputs: link_id (required).
list_webhooksAInspect
List all webhook URLs subscribed to the workspace. These receive click events for all links.
Inputs: no named parameters.
search_linksBInspect
Search for links by name, URL, or note. Returns matching links with click statistics.
Inputs: query (required).
subscribe_link_webhookCInspect
Subscribe a webhook URL to receive click events for a specific link.
Inputs: url (required), link_id (required).
subscribe_webhookCInspect
Subscribe a webhook URL to receive click events for all links in the workspace.
Inputs: url (required).
unsubscribe_link_webhookBInspect
Unsubscribe a webhook URL from a specific link's click events.
Inputs: url (required), link_id (required).
unsubscribe_webhookCInspect
Unsubscribe a webhook URL from workspace click events.
Inputs: url (required).
update_domain_faviconCInspect
Update the favicon URL for a custom domain.
Inputs: domain_id (required), favicon_url (required).
update_linkCInspect
Update an existing Linkly link by its ID
Inputs: link_id (required), url, name, note, +18 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool has a distinct purpose with clear boundaries, targeting specific resources (domains, links, webhooks, analytics) and actions (create, delete, get, list, update, subscribe, unsubscribe, export). There is no overlap or ambiguity; for example, get_analytics and get_analytics_by serve different analytical functions, and webhook tools are clearly separated by scope (link-specific vs. workspace-wide).
Tool names follow a consistent verb_noun pattern throughout, with verbs like create, delete, get, list, update, subscribe, unsubscribe, export, and search applied to nouns such as domain, link, webhook, analytics, and clicks. There are no deviations in style (e.g., no camelCase or mixed conventions), making the set predictable and readable.
With 20 tools, the count is slightly high but reasonable for a link management and analytics domain, covering domains, links, webhooks, and analytics comprehensively. It avoids being excessive (e.g., not over 25) and each tool appears justified, though it could be streamlined slightly without losing functionality.
The tool set provides complete CRUD/lifecycle coverage for domains (create, list, delete, update_favicon), links (create, get, list, update, delete, search), and webhooks (subscribe, unsubscribe, list for both link-specific and workspace-wide). Analytics tools (get_analytics, get_analytics_by, export_clicks, get_clicks) offer robust data access, leaving no obvious gaps for agent workflows in this domain.
Maintenance
Related MCP Connectors
Create branded short links and QR codes, and pull click analytics by country, device and referrer.
Create, search and pause deep links; QR codes; analytics, taps, events; domains; webhooks.
Short links, QR codes, link and website analytics: create and edit links, read clicks and visitors.
Create, edit and track LickityClick short links, campaigns and click stats from your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables interaction with the Firelinks link shortening platform to create and manage short links, track click statistics, manage custom domains, and compare analytics periods through natural language.3MIT
- AlicenseAqualityDmaintenanceEnables AI agents to shorten URLs, manage links, and track click analytics through 8 first-class tools, designed for use with Claude Desktop, Cursor, and other MCP clients.946 npmMIT
- AlicenseAqualityBmaintenanceEnables users to shorten links, bulk create URLs, generate QR codes, manage and disable links, and retrieve click analytics from MCP clients like Claude, ChatGPT, Cursor, and n8n.9MIT
- AlicenseBqualityCmaintenanceEnables users to shorten links, bulk-create URLs, generate QR codes, and retrieve click analytics through MCP clients such as Claude, ChatGPT, Cursor, and n8n.940 npmMIT