연동
Claude, ChatGPT, n8n용 MCP 서버
AI 어시스턴트가 링크 목록 조회, 방문 기록 확인, 추적 URL 생성을 할 수 있는 원격 Model Context Protocol 엔드포인트.
Ultimate 워크스페이스는 https://letl.ink/mcp에서 원격 Model Context Protocol 서버를 제공합니다. Claude, ChatGPT, n8n의 MCP Client는 Streamable HTTP를 통해 JSON-RPC로 통신합니다. 토큰은 REST API와 같은 API 토큰입니다. Free, Solo 또는 Growth 워크스페이스는 다른 이유로 이미 토큰이 있더라도 /mcp에서 403을 받습니다.
프로토콜 및 인증
- 프로토콜 버전
2025-03-26. - 메서드:
initialize,ping,tools/list,tools/call.resources/list와prompts/list는 빈 목록을 반환합니다. Authorization: Bearer YOUR_TOKEN또는X-API-KEY: YOUR_TOKEN으로 인증하세요.- 소유자와 관리자는 연동 → MCP에서 토큰을 생성합니다. 토큰을 다시 생성하면 모든 MCP 클라이언트의 연결이 한 번에 해제됩니다.
Claude 연결
- Claude에서 설정 → 커넥터 → 사용자 지정 커넥터 추가를 여세요.
- URL:
https://letl.ink/mcp. - 인증 헤더:
Authorization: Bearer와 토큰. - 연결되면 Claude에게 워크스페이스 요약, 링크 목록 조회, 추적 단축 URL 생성을 요청해 보세요.
ChatGPT 연결
- ChatGPT에서 설정 → 커넥터 → MCP를 여세요.
- 같은 URL과 Bearer 토큰을 사용하세요.
- 일부 ChatGPT 워크스페이스에서는 사용자 지정 MCP 서버가 표시되려면 개발자 모드가 필요합니다. 커넥터가 보이지 않으면 먼저 이 설정을 확인하세요.
n8n 연결
MCP Client 노드 → 전송 방식 Streamable HTTP → URL https://letl.ink/mcp → 헤더 Authorization: Bearer YOUR_TOKEN. 자세한 내용과 나머지 두 가지 n8n 연결 방법은 n8n 문서를 참고하세요.
도구
| 도구 | 반환 값 / 기능 |
|---|---|
| workspace_summary | 워크스페이스 이름, 요금제, 사용한/최대 링크 수, 이번 달 클릭 수, 도메인, QR 코드, 보관 일수, 지역 정보 및 API 사용 여부, 봇 차단 사용 여부 |
| list_links | 활성 링크(선택 사항 limit, 기본값 50, 최대 200) |
| get_link | 숫자 id 또는 short_code로 지정한 링크 하나 |
| get_recent_visits | 최근 기록된 클릭(선택 사항 limit, 기본값 25, 최대 100), 국가 포함 |
| create_link | 추적 링크를 만듭니다. type은 direct, utm, appstore, instagram, mobile 또는 device일 수 있습니다. 스마트 유형은 요금제를 따르며, 대상 URL, UTM, 스토어 URL은 REST 생성 본문과 동일합니다 |
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": { "name": "docs", "version": "1" }
}
}모델에 전달되는 안내
initialize 시 서버는 자신을 letlink로 소개하고, 클라이언트에 지역 필드를 포함해 이 워크스페이스의 추적 단축 링크를 조회하고 생성하도록 안내합니다. 도구는 JSON을 텍스트 콘텐츠와 structuredContent 두 가지로 반환하므로, 구조화된 결과를 이해하는 클라이언트는 파싱을 생략할 수 있습니다.
안전
연결된 어시스턴트는 API 접근 권한이 있는 팀원처럼 취급하세요. 방문 기록(일부 방문 페이로드의 IP 포함)을 읽을 수 있고, 한도에 포함되는 링크를 만들 수 있습니다. Bearer 토큰을 채팅에 붙여 넣지 마세요. 더 이상 필요 없는 클라이언트는 커넥터를 비활성화하고 토큰을 교체하세요.