@limelink/mcp

한국어 · Documentation · Capability reference

LimeLink 동적 링크 관리를 위한 Model Context Protocol (MCP) 서버입니다. Claude Code, Claude Desktop 또는 MCP 호환 클라이언트에서 직접 동적 링크를 생성, 조회 및 관리할 수 있습니다.

시작하는 데 API 키가 필요 없습니다! 문서 및 SDK 설정 가이드는 구성 없이도 사용할 수 있습니다. AI 어시스턴트와 함께 LimeLink 기능을 바로 연결하고 탐색해 보세요.

기능

• 문서 리소스 — AI 어시스턴트에서 LimeLink 문서(15개 페이지 + 인덱스)에 직접 접근 — API 키 불필요

• 5가지 도구 — 프로필 및 프로젝트 검색, 동적 링크 생성, 링크 조회 (API 도구는 구성된 프로필 필요)

• 인메모리 캐싱 — 문서 가져오기에 대한 1시간 TTL 캐시

런타임

• Node.js 18 이상

• stdio 전송만 지원; Remote MCP/HTTP 전송은 지원하지 않음

• npm 패키지: @limelink/mcp; 전역 실행 파일: limelink-mcp

• stdout은 MCP 프로토콜 전용; 진단 및 래퍼 로그는 stderr를 사용해야 함

전체 운영 계약은 설치 및 구성 및 네트워크 동작을 참조하세요.

API 키 없이 사용할 수 있는 기능은 무엇인가요?

Related MCP server: lynxprompt-mcp

빠른 시작

API 키 없이 (문서 및 가이드)

API 키가 필요 없습니다. 연결하고 즉시 LimeLink 문서 및 설정 가이드를 탐색하세요:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"]
    }
  }
}

AI 어시스턴트에게 다음과 같이 물어보세요:

• "LimeLink 시작하기 문서를 읽어줘"

• "iOS용 딥 링크를 어떻게 설정하나요?"

• "LimeLink SDK 통합 가이드를 보여줘"

조직 프로필 사용 (전체 기능)

아래 표시된 버전 1 프로필 파일을 만들고 절대 경로를 전달하세요:

{
  "mcpServers": {
    "limelink": {
      "command": "npx",
      "args": ["-y", "@limelink/mcp"],
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

전역 설치 사용

npm install -g @limelink/mcp

{
  "mcpServers": {
    "limelink": {
      "command": "limelink-mcp",
      "env": {
        "LIMELINK_PROFILES_FILE": "/absolute/path/to/limelink-profiles.json"
      }
    }
  }
}

구성

Claude Code

MCP 서버를 추가하는 가장 쉬운 방법은 claude mcp add 명령을 사용하는 것입니다:

# Without API key (docs & guides only)
claude mcp add --scope user --transport stdio limelink -- npx -y @limelink/mcp

# With API key (full features)
claude mcp add --scope user --transport stdio limelink \
  --env LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json \
  -- npx -y @limelink/mcp

범위 옵션:

• --scope user — 모든 프로젝트에서 사용 가능

• --scope project — .mcp.json에 저장 (Git을 통해 팀과 공유 가능)

Claude Desktop 및 기타 MCP 클라이언트

클라이언트의 구성 파일에 JSON 구성을 추가하세요:

프로필 파일

{"version":1,"defaultProfile":"work","profiles":{"work":{"apiKey":"your_api_key","organizationLabel":"Work","projects":{"marketing":"11111111-1111-4111-8111-111111111111"}}}}

환경 변수

LIMELINK_API_KEY 및 LIMELINK_PROJECT_ID는 무시됩니다. 자격 증명 프로필이 구성되지 않은 경우, API 기반 도구는 에이전트를 조직으로 안내하여 조직 API 키를 발급하고 프로필 파일을 구성하도록 합니다. 프로젝트 기반 도구는 프로젝트 UUID를 직접 허용합니다. 프로필의 선택적 projects 맵은 반복적으로 사용되는 프로젝트에 대한 권장 편의 기능이지 필수 사항은 아닙니다. list-projects 검색 후 별칭을 추가하면 유용합니다. 프로필은 첫 번째 API 기반 호출 시 자격 증명 검사를 통해 지연 초기화됩니다. 별칭 추가를 포함한 프로필 파일 변경은 MCP 서버 재시작이 필요합니다.

API 키는 LimeLink 대시보드에서 얻을 수 있습니다. API 키 없이도 문서 리소스와 SDK 설정 가이드를 완전히 사용할 수 있습니다.

도구

list-profiles

API에 접촉하지 않고 구성된 별칭, 조직 레이블, 기본 상태 및 현재 초기화 상태를 나열합니다. 이미 초기화된 프로필에는 범위가 포함됩니다. API 키 값은 비밀로 유지되며 절대 반환되지 않습니다. 조직, 프로젝트, 사용자 지정 도메인 및 자격 증명 식별자와 키 접두사는 비밀 식별자가 아니며 유용한 경우 API 기반 도구 응답에 나타날 수 있습니다.

list-projects

선택한 프로필의 자격 증명에서 검색된 조직의 프로젝트를 나열합니다. 선택적 profile을 허용합니다. 자격 증명에는 projects:read 권한이 필요합니다.

list-custom-domains

필수 project(별칭 또는 UUID)에 대한 사용자 지정 도메인을 나열합니다. 선택적 profile을 허용합니다. 자격 증명에는 domains:read 권한이 필요합니다.

create-link

플랫폼별 딥 링크, 사용자 지정 도메인 선택, 소셜 미리보기 및 UTM 추적을 지원하는 V2 Core 링크를 생성합니다.

매개변수:

Claude에서의 사용 예:

"https://example.com/product/123에 대한 동적 링크를 접미사 'product-123'로 만들고 분석을 활성화해줘"

get-link-by-suffix

접미사로 동적 링크를 조회합니다.

get-link-by-url

전체 URL을 사용하여 V2 API를 통해 링크를 확인합니다. 백엔드는 URL이 Free 기본 네임스페이스, 프로젝트 호스트 이름 또는 활성 사용자 지정 도메인에 속하는지 결정합니다. 프로젝트 선택기나 로컬 접미사 구문 분석이 필요하지 않습니다.

URL은 절대 HTTPS여야 하며 정확히 하나의 /{suffix} 경로 세그먼트가 있어야 하고 쿼리, 프래그먼트, 명시적 포트 또는 자격 증명이 없어야 합니다.

리소스

limelink://docs/index

전체 LimeLink 문서 인덱스(llms.txt)를 반환합니다.

limelink://docs/{slug}

개별 문서 페이지를 반환합니다. 사용 가능한 슬러그:

introduction, getting-started, project, application, dynamic-link, create-link, link-detail, link-management, appearance, sdk-integration, ios-sdk, android-sdk, api-integration, advanced, llm-agent

Claude에서의 사용 예:

"LimeLink API 통합 문서를 읽어줘"

Claude는 limelink://docs/api-integration에 접근합니다.

개발

사전 요구 사항

• Node.js >= 18

• pnpm

설정

git clone https://github.com/hellovelop/limelink-mcp-server.git
cd limelink-mcp-server
pnpm install
pnpm run build

로컬 실행

LIMELINK_PROFILES_FILE=/absolute/path/to/limelink-profiles.json node dist/index.js

테스트

pnpm test          # Unit tests
pnpm test:e2e      # E2E tests (MCP stdio communication)
pnpm test:watch    # Unit tests in watch mode
pnpm test:coverage # Coverage report

프로젝트 구조

src/
├── index.ts              # Entry point
├── lib/
│   ├── config.ts         # Environment variable loading
│   ├── cache.ts          # In-memory TTL cache
│   ├── api-client.ts     # LimeLink API HTTP client
│   └── doc-fetcher.ts    # Documentation fetcher with caching
├── tools/
│   ├── create-link.ts    # create-link tool
│   ├── get-link-by-suffix.ts
│   └── get-link-by-url.ts
└── resources/
    └── documentation.ts  # Documentation resources

라이선스

MIT