jangbu-connect

# jangbu-connect CODEF 자격증명 설정 가이드 스킬. ## 왜 CODEF인가 한국에서 홈택스·은행·카드·4대보험 데이터를 **합법적·합리적 비용**으로 자동 수집할 수 있는 유일한 프록시 API. - 한국 공공기관·금융기관 통합 API - 간편인증(카카오·PASS·공동인증서) 지원 - **개인 개발자 샌드박스 무료** (월 1,000건까지) - 사업자등록 없어도 가입 가능 ## BYOK 보안 원칙 - **스킬 제작자는 자격증명 취급 안함** — 사용자 본인 계정의 키만 사용 - 키는 **로컬에만 저장** (macOS Keychain 기본, 실패 시 `~/.jangbu/credentials.env`) - **외부 서버 동기화 없음** - 모든 API 호출은 사용자 자신의 비용으로 실행 ## 인터뷰 플로우 ### Step 1. CODEF 계정 발급 (5분) ``` CODEF 자동 수집을 쓰려면 개인 개발자 키가 필요합니다. [1] 브라우저에서 https://developer.codef.io 접속 [2] 우측 상단 "회원가입" → 이메일 인증 (사업자번호 불필요) [3] 로그인 후 상단 "My Page" → "서비스 관리" → "신규 서비스 등록" - 서비스 명: 예) korean-jangbu-for - 서비스 구분: "개발용" 선택 - 이용 서비스: "대한민국" · "공공" · "금융" 체크 [4] 등록 직후 표시되는 - Client ID - Client Secret 두 값을 복사해 두세요. [5] (선택) "My Page" → "RSA Public Key" 에서 공개키 PEM도 복사해 두면 프로덕션 API에서 비밀번호 암호화 전송이 가능해요 (샌드박스는 불필요). 준비 끝나면 Enter 누르세요. ``` ### Step 2. 자격증명 등록 ``` 아래 값을 순서대로 입력받습니다. 값은 로컬에만 저장됩니다. Client ID: (CODEF My Page에서 복사한 값) Client Secret: (CODEF My Page에서 복사한 값) RSA Public Key: (선택, 프로덕션 전환 시만 필요) 샌드박스 사용: Y/n (기본 Y — 개인 체험·테스트) Keychain 저장: Y/n (기본 Y — 실패 시 envfile로 fallback) ``` 입력이 끝나면 내부적으로 MCP 도구 `codef_credentials_save`를 호출: ```python codef_credentials_save( client_id="...", client_secret="...", public_key_pem="...", # 선택 sandbox=True, use_keyring=True, ) ``` ### Step 3. 등록 확인 ``` codef_credentials_status ``` 응답 예시: ```json { "CODEF_CLIENT_ID": {"...