AI 도구로 연동하기

Claude Code·Codex·Cursor 같은 AI 도구로 Signox 라이센스를 연동하는 방법이에요. 문서를 AI에 연결하고, 고객 포털 활성화와 기능 권한 검증을 실제 앱에 적용하는 방법을 알아보세요.

AI가 올바른 코드를 만들려면 SDK 이름뿐 아니라 사용하는 버전, 필요한 입력과 성공 조건도 알아야 해요. Signox가 제공하는 자원을 연결하면 메서드나 요청 필드를 추측하는 일을 줄일 수 있어요.

AI를 위한 Signox 자원

Signox는 AI가 문서를 찾고 읽을 수 있도록 세 가지 자원을 제공해요.

자원	역할	언제 사용하나요?
LLM Quick Reference	활성화 흐름·기본 판단 규칙·흔한 실수를 한 페이지에 정리해요.	새 앱 연동을 시작할 때 먼저 전달하세요.
MCP 서버	AI가 문서 목록을 검색하고 필요한 원문을 읽게 해요.	메서드와 오류의 자세한 설명이 필요할 때 사용하세요.
llms.txt	문서의 구조와 페이지 경로를 알려주는 인덱스예요.	MCP 없이 문서를 찾아가거나 문서 소스를 등록할 때 사용하세요.

LLM Quick Reference 활용하기

LLM Quick Reference에는 ActivationClient의 동작, 고객 승인 흐름, 필수 입력과 잘못 쓰기 쉬운 패턴이 있어요. 짧은 영문 계약으로 제공하며, 상세 설명은 해당 페이지에서 연결한 가이드를 읽을 수 있어요.

AI 채팅에 페이지 주소를 전달하고 다음처럼 요청하세요.

Signox LLM Quick Reference와 Node SDK 가이드를 읽고,
고객이 브라우저로 로그인해 기기를 활성화하는 앱을 만들어줘.
SDK 버전은 0.3.1이야. 문서에 없는 메서드나 필드는 만들지 말아줘.

MCP 서버 연결하기

MCP(Model Context Protocol)는 AI 도구가 외부 자료와 기능을 사용할 수 있게 연결하는 규약이에요. Signox 문서 MCP는 문서를 조회하는 서버이며 라이센스를 발급하거나 고객 대신 승인하지 않아요.

문서 MCP 주소는 https://api.signox.kr/mcp예요. 별도 테스트 환경을 사용한다면 제공받은 API 주소에 /mcp를 붙이세요. SDK API 주소와 고객 포털 주소는 서로 다르므로 혼동하지 마세요.

터미널 명령으로 연결하기

사용하는 AI 도구에 맞는 명령 한 개를 실행하세요.

# Codex
codex mcp add signox-docs --url https://api.signox.kr/mcp

# Claude Code
claude mcp add --transport http signox-docs https://api.signox.kr/mcp

연결을 추가한 뒤 새 AI 세션에서 문서 도구가 표시되는지 확인하세요. Codex에서는 codex mcp list로 등록 목록을 볼 수 있어요. 자세한 설정은 Codex MCP 안내와 Claude Code MCP 안내를 참고하세요.

설정 파일로 연결하기

Codex의 프로젝트 설정 .codex/config.toml에는 다음 내용을 추가해요. 프로젝트 설정은 신뢰한 프로젝트에 적용돼요.

[mcp_servers.signox-docs]
url = "https://api.signox.kr/mcp"

Claude Code의 .mcp.json 또는 Cursor의 .cursor/mcp.json에서는 다음 형식을 사용해요.

{
  "mcpServers": {
    "signox-docs": {
      "type": "http",
      "url": "https://api.signox.kr/mcp"
    }
  }
}

VS Code의 .vscode/mcp.json은 최상위 키가 servers예요. 사용하는 도구의 설정 형식을 확인하세요.

{
  "servers": {
    "signox-docs": {
      "type": "http",
      "url": "https://api.signox.kr/mcp"
    }
  }
}

문서 도구가 연결됐는지 확인하기

AI에 “Signox 문서 MCP로 Node SDK 가이드를 읽어줘”라고 요청해보세요.

도구	인자	동작
`list_docs`	`locale?: “ko"	"en”`, 생략하면 한국어. 검색어 인자는 없어요.
`read_doc`	`slug: string`에 `sdk/node` 같은 경로를 넣어요. `locale`은 선택이며 기본 한국어예요.	선택한 문서의 전체 원문을 읽어요.

연결이 되지 않으면 API 주소에 /mcp가 붙었는지, 대상 환경에 접속할 수 있는지, 설정 파일의 최상위 키가 도구와 맞는지 확인하세요. 설정을 바꾼 뒤에도 도구가 보이지 않으면 새 세션에서 다시 확인하세요. AI가 문서를 사용하지 않는다면 MCP로 조회해달라고 명시적으로 요청하세요.

llms.txt 활용하기

llms.txt는 Signox 문서 목록을 AI가 읽기 좋은 형태로 제공해요. llms-full.txt에는 문서 본문도 함께 들어 있어요.

처음부터 전체 문서를 넣기보다 인덱스에서 필요한 언어와 흐름을 찾아 읽게 하세요. 입력 길이를 줄이면서 현재 작업에 필요한 설명을 전달할 수 있어요.

이 Wiki의 llms.txt에서 Java SDK와 기기 이전 문서를 찾아 읽어줘.
같은 기기 복구와 다른 기기 이전의 차이를 확인한 뒤 구현해줘.

AI에게 연동을 요청하기

다음 입력을 준비해 AI에 전달하세요. 비밀번호와 토큰을 채팅에 붙여넣지 말고 필요한 경우 비공개 입력 파일의 위치만 알려주세요.

사용하는 언어와 SDK 버전.
테스트 API 주소, 제품 UUID, 제품 공개키 파일 경로.
설치마다 따로 보존할 상태 디렉터리.
테스트 고객의 라이센스 준비 여부와 검증할 기능 코드.
실제 오프라인 시험에 사용할 OS와 보호 기기 접근 방법.

작업 프롬프트 예시

Signox 0.3.1 SDK를 사용해 CSV 내보내기 앱에 라이센스를 붙여줘.
LLM Quick Reference → 해당 언어 SDK → 샘플 → 활성화 가이드 순서로 읽어줘.
필요한 환경 입력은 제공한 비공개 파일에서 확인하고, 누락된 입력은 질문해줘.

ActivationClient로 브라우저 승인과 요청·응답 파일 전달을 연결해줘.
고객 비밀번호는 앱이 받지 않고 고객 포털에서만 입력하게 해줘.
valid와 demo_export가 모두 참일 때만 실제 CSV 파일을 생성해줘.

같은 상태로 재시작, 다른 기기 이전, 변조 응답, 기능 없는 라이센스,
서버의 명시적 거절을 받은 뒤 연결이 끊긴 경우를 검증해줘.
명령·종료 코드·예상 결과·관찰 결과·증거 경로를 기록해줘.
승인 대기·장비 미지원·미실행은 통과로 표시하지 말아줘.
질문과 답변은 별도 파일에 모으고, 최초 결과를 보존한 뒤 개선점을 제안해줘.

문제를 물어보는 예시

“STATE_INVALID가 나와요. 상태 디렉터리를 바꾸었는지 확인하고 복구 절차를 알려줘.”
“새 기기에서 TRANSFER_REQUIRED가 나와요. 고객 요청과 벤더 승인 순서를 설명해줘.”
“라이센스는 유효한데 demo_export가 false예요. 정책과 실제 CSV 제어를 확인해줘.”

페이지 원문을 전달하기

페이지 제목 아래 Markdown으로 복사 버튼을 누르면 현재 문서의 원문을 복사할 수 있어요. 복사 권한이 없으면 Markdown 원문 링크를 여세요.

모든 Wiki 페이지는 마지막 /를 .md로 바꾸면 Markdown 원문을 읽을 수 있어요. 예를 들어 /sdk/node/의 원문은 /sdk/node.md예요. 필요한 페이지의 원문을 AI에 전달하면 메뉴나 화면 코드를 제외한 설명을 읽힐 수 있어요.

AI가 만든 코드도 실제 SDK로 실행해 확인해야 해요. 통합 검증 가이드에서 성공·실패 결과와 실제 기능을 함께 확인하세요.