MCP Server

원격 MCP 서버 연결

외부 클라이언트용 주소는 https://design.klic.co.kr/api/v1/mcp입니다. 공개 JSON API와 동일한 디자인 자료만 읽으며 로그인 없이 연결합니다. ChatGPT의 Sites 개인 플러그인은 별도의 관리형 /mcp 경로와 Sites 인증을 사용합니다.

{
  "mcpServers": {
    "klic": {
      "url": "https://design.klic.co.kr/api/v1/mcp"
    }
  }
}

기존 관리형 MCP 경로는 외부 연결에 사용하지 마세요. 원격 HTTP MCP를 지원하는 클라이언트에 위 주소를 설정합니다. ChatGPT에서는 KLIC 개인 플러그인을 설치·연결합니다. 사용량 면제 키는 요청 한도만 조절하며 관리 권한을 부여하지 않습니다.

로컬 stdio 서버 연결

{
  "mcpServers": {
    "klic": {
      "command": "bun",
      "args": [
        "/absolute/path/klic.mjs",
        "mcp"
      ]
    }
  }
}

시작 시 공개 레지스트리를 한 번 읽고, 도구 호출은 메모리의 같은 스냅샷을 사용합니다. 새 release를 읽으려면 프로세스를 재시작합니다. 소스 체크아웃의 완전한 오프라인 실행은 args에 --local을 추가하고 cwd를 저장소 루트로 지정합니다. stdout에 서버 로그를 섞지 마세요.

도구와 입력

검색은 ready·limit 20이 기본이며 최대 100개입니다. 설치 계획은 파일을 쓰지 않습니다. klic_get_item의 item.variants에는 해당 컴포넌트에 등록된 형태와 소스 경로가 있고, item.design에는 사용 원칙, 금지 사항, 상태, 밀도, 접근성과 토큰 매핑 및 내보내기 경로가 있습니다.

{
  "name": "klic_get_theme_install_plan",
  "arguments": {
    "id": "paper",
    "profile": "studio",
    "material": "glass",
    "mode": "system"
  }
}

전송과 프로토콜

원격 서버는 POST /api/v1/mcp의 stateless JSON HTTP 전송을 제공합니다. GET 이벤트 스트림과 서버 저장 세션은 제공하지 않습니다. stdio는 줄 단위 JSON-RPC를 사용합니다. HTTP 요청 본문은 1 MiB로 제한합니다.

구현이 지원하는 프로토콜: 2026-07-28, 2025-11-25. 2026-07-28 요청은 각 params._meta에 protocolVersion과 clientCapabilities를 넣고, 본문과 일치하는 MCP-Protocol-Version·Mcp-Method 헤더를 전송합니다. tools/call에는 Mcp-Name도 필요합니다. 2025-11-25 연결은 initialize → notifications/initialized 순서이며 HTTP 도구 요청에 MCP-Protocol-Version 헤더를 사용합니다.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "server/discover",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

HTTP 호출과 브라우저 출처

curl -f https://design.klic.co.kr/api/v1/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/call' -H 'Mcp-Name: klic_get_contract' --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"klic_get_contract","arguments":{},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

Origin이 없는 네이티브 MCP 클라이언트는 로그인 없이 공개 자료를 읽습니다. 브라우저 MCP는 사이트 출처와 서버의 KLIC_MCP_ALLOWED_ORIGINS 허용 목록을 검사합니다. 추가 출처는 ["https://agent.example"]처럼 정확한 origin 문자열의 JSON 배열로 설정합니다. 와일드카드·경로·자격 증명·불투명 출처는 허용하지 않습니다. JSON API의 공개 교차 출처 읽기는 유지됩니다.

응답과 실패 처리

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"schemaVersion\":\"1.0\",\"release\":\"444ee642b9edec32\"}"
      }
    ],
    "structuredContent": {
      "schemaVersion": "1.0"
    },
    "isError": false
  }
}

위 응답은 구조를 설명하는 축약 예시입니다. 실제 반환값은 도구별로 다릅니다. 도구 실패는 result.isError=true와 structuredContent.error, 프로토콜 실패는 최상위 error로 구분합니다. 헤더 누락·불일치는 HTTP 400과 -32020, 미지원 버전은 400, 없는 메서드는 404입니다. 허용되지 않은 Origin은 403입니다. 도구 실패는 HTTP 200을 유지합니다. 401/403은 연결 인증과 출처, 429는 요청 한도를 확인하세요.

테마 컨텍스트와 범위

전체 정의 인벤토리는 호환성을 위해 3,751개 토큰을 유지합니다. 외부 전달은 선택한 컨텍스트의 활성 참조를 따라 사용하지 않는 Primitive를 제외하며, 토큰 탐색기는 현재 컨텍스트와 전체 정의 범위를 구분합니다. Primitive 3,143개 중 2,496개(79.41%)는 재질 정의입니다.

형식은 프로젝트가 지원하는 타입과 4계층 참조 규칙을 검증합니다. 모든 DTCG 기능 지원이나 모든 화면의 WCAG 인증을 의미하지 않습니다.

요청 한도와 권한 키

초과 요청은 HTTP 429와 Retry-After를 반환합니다. API·MCP는 X-KLIC-API-Key 헤더, CLI는 KLIC_API_KEY 환경 변수를 지원합니다. 서버에 등록된 키만 한도에서 제외되며 관리 권한이나 MCP 인증을 부여하지 않습니다. 키를 URL·문서·브라우저 코드에 넣지 마세요.

이미 읽은 스냅샷의 stdio·WebMCP 호출과 --local 실행은 서버 요청을 만들지 않습니다. 초기 HTTP 레지스트리 조회와 소스 다운로드는 각각 서버 한도를 사용합니다.

수치의 집계 범위

제공 형태와 버전 읽기

KLIC은 7개 디자인 디멘션과 4계층 토큰을 공통 기반으로 씁니다. 적용 기준은 다릅니다. 컴포넌트는 개별 조작 요소, 블록은 업무 흐름, 모션은 시간에 따른 전환을 다룹니다. 공개 npm: [email protected]. 소스 후보 [email protected]는 미발행이며 [email protected]가 현재 발행본입니다.

컴포넌트 109개와 실행 블록 247개는 CLI plan/add로 독립 참고 작업 폴더 356개를 제공합니다. 모션 884개는 source id + pattern 출처와 보존된 고지를 포함한 KLIC 각색 패턴이며 상세 화면·API·CLI motion get에서 HTML/CSS/JavaScript/React 소스를 제공합니다(CSS/React 예제 포함). 미리보기와 JavaScript/React 구현은 같은 런타임을 사용하며 Canvas 재생은 CSS만으로 재현되지 않습니다. 패키지는 components/*·blocks/*·motions/*를 제공하고, 모션 수는 작업 폴더 수와 별도로 집계합니다. 소스 후보 [email protected]는 미발행이며 [email protected]가 현재 발행본입니다.

라이선스 안내는 파일별 출처와 보존 고지의 색인입니다. 사이트 전체에 새 단일 라이선스를 부여하지 않습니다. Figma는 manifest와 이관 가이드를 제공하며 자동 동기화 기능과 구분합니다. 공개 KLIC 소스 저장소 주소는 현재 제공 계약에 등록되어 있지 않습니다.

https://design.klic.co.kr/licenses/README.md
https://design.klic.co.kr/design-contract/materials/figma-manifest.json
https://design.klic.co.kr/design-contract/materials/figma-migration.md