Claude Desktop에서 Linkly 사용하기
Claude Desktop을 Linkly 계정에 연결하고 Linkly MCP 서버를 사용하여 자연스러운 대화를 통해 단축 링크를 관리하세요.
사용 가능한 기능
연결하면 Claude에게 다음을 요청할 수 있습니다:
- 단축 링크 생성 - "https://example.com에 대한 단축 링크를 만들어줘"
- 성과 추적 - "이번 주에 내 링크가 얼마나 많은 클릭을 받았어?"
- 링크 관리 - "'promo'라는 링크를 새 대상으로 업데이트해줘"
- 분석 보기 - "지난 30일간 국가별 클릭 수를 보여줘"
- 링크 검색 - "제품 출시와 관련된 모든 링크를 찾아줘"
- 도메인 관리 - "내 사용자 지정 도메인 목록을 보여줘"
- 웹훅 설정 - "클릭 이벤트를 받을 수 있도록 https://my-site.com/webhook을 구독해줘"
Claude Desktop에 Linkly 설정하는 방법
Linkly에서 API 자격 증명 가져오기
Linkly 대시보드에 로그인하고, 설정 → API 키로 이동한 다음 API 키와 워크스페이스 ID를 복사하세요.
Claude Desktop 설정 열기
설정(톱니바퀴 아이콘) → 개발자 → 구성 편집으로 이동하여 구성 파일을 여세요.
Linkly MCP 서버 구성 추가
구성 파일에 다음을 추가하고, 플레이스홀더 값을 실제 자격 증명으로 교체하세요:
{
"mcpServers": {
"linkly": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.linklyhq.com?apiKey=<api_key>&workspaceId=<workspace_id>"]
}
}
}
저장 후 Claude Desktop 재시작
구성 파일을 저장한 후 변경 사항을 적용하려면 Claude Desktop을 재시작하세요.
연결 확인
Claude Desktop 입력 영역에서 망치 아이콘을 찾으세요. 클릭하면 사용 가능한 Linkly 도구를 볼 수 있으며, "내 Linkly 링크 목록을 보여줘"라고 물어보세요.
추가 정보
사용 가능한 도구, 링크 생성 옵션 및 문제 해결에 대한 자세한 문서는 Linkly MCP 서버 문서를 참조하세요.
관련 리소스
- Linkly MCP 서버 - 전체 MCP 문서
- ChatGPT 통합
- Linkly API 문서
- 웹훅
Claude Desktop 통합 FAQ
"MCP 서버에 연결할 수 없습니다"
API 키와 워크스페이스 ID가 올바른지 확인하세요. Node.js(v18 이상)가 설치되어 있는지 확인하세요. 터미널에서 npx mcp-remote https://mcp.linklyhq.com?apiKey=<api_key>&workspaceId=<workspace_id>를 실행하여 오류를 확인해보세요.
"인증 실패"
Linkly 대시보드의 설정 → API에서 API 키를 확인하세요. 자격 증명에 공백이 추가로 없는지 확인하세요.
Claude Desktop에 도구가 나타나지 않음
구성을 저장한 후 Claude Desktop을 재시작하세요. 구성 파일의 JSON 구문이 유효한지 확인하세요. 올바르게 구성되면 입력 영역에 망치 아이콘이 나타나야 합니다.
Claude Desktop 통합으로 무엇을 할 수 있나요?
Claude와의 자연스러운 대화를 통해 링크를 생성, 업데이트 및 삭제하고, 분석 및 클릭 데이터를 보고, 링크를 검색하며, 사용자 지정 도메인을 관리하고, 웹훅을 설정할 수 있습니다. 전체 도구 목록을 참조하세요.