LEVEL11

문서

연동

토스페이먼츠, 나이스페이, 페이플, 카페24, NHN Cloud, 네이버 클라우드, 메가존, Vercel, 그리고 프로젝트 코드용 Anthropic·OpenAI 키. 자격증명은 OS 키체인으로 암호화되어 환경 변수로만 전달됩니다.

무엇을 연결할 수 있나

Integrations 도구는 한국에서 쓰는 서비스를 먼저 둡니다. 각 항목에 자격증명을 넣어 두면 에이전트가 실행하는 명령에서 환경 변수로 쓸 수 있습니다.

분류 서비스 환경 변수
결제 서비스 토스페이먼츠 TOSS_CLIENT_KEY, TOSS_SECRET_KEY
나이스페이 NICEPAY_CLIENT_ID, NICEPAY_SECRET_KEY
페이플 PAYPLE_CST_ID, PAYPLE_CUST_KEY, PAYPLE_AUTH_KEY(선택)
호스팅 서비스 카페24 CAFE24_MALL_ID, CAFE24_CLIENT_ID, CAFE24_CLIENT_SECRET, CAFE24_SSH_HOST(선택)
NHN Cloud NHN_APP_KEY, NHN_SECRET_KEY, NHN_REGION
클라우드 서비스 네이버 클라우드 NCP_ACCESS_KEY, NCP_SECRET_KEY, NCP_REGION
메가존클라우드 MZC_PROVIDER, MZC_ACCESS_KEY, MZC_SECRET_KEY, MZC_REGION
배포 서비스 Vercel VERCEL_TOKEN
AI 서비스 Anthropic, OpenAI ANTHROPIC_API_KEY, OPENAI_API_KEY

AI 서비스 항목은 프로젝트 코드에서 쓰는 키입니다. 에이전트가 만드는 앱이 Claude나 GPT를 호출할 때 쓰라고 넣어 두는 것이고, LEVEL11 자체가 모델을 호출하는 데 쓰는 키(설정 → LEVEL11 계정의 BYOK 키)와는 별개입니다.

자격증명이 다뤄지는 방식

  • 입력한 값은 OS 보안 저장소(Electron safeStorage: macOS 키체인, Windows DPAPI)로 암호화되어 이 기기에만 저장됩니다. LEVEL11 서버로 올라가지 않습니다.
  • 에이전트가 run_command로 명령을 실행할 때만 그 명령의 환경 변수로 주입됩니다. 프롬프트, 채팅 기록, 파일에는 기록되지 않습니다.
  • 에이전트의 시스템 프롬프트에는 어떤 서비스가 연결되어 있고 어떤 변수 이름이 설정되어 있는지만 들어갑니다. 값은 들어가지 않습니다. 시스템 프롬프트는 에이전트에게 그 값을 출력하거나 로그에 남기거나 파일에 쓰지 말라고 지시합니다.
  • 설정 화면에서 저장된 비밀값은 •••• (변경 없음)으로만 보이고, 다시 입력하면 교체됩니다.
  • 연결 해제를 누르면 저장된 자격증명이 이 기기에서 삭제됩니다.

현재 연동 서비스는 에이전트만 사용합니다. IDE의 다른 부분(에디터, 터미널 탭)은 이 값을 읽지 않습니다. 터미널 도구에서 직접 치는 명령에는 주입되지 않으니, 에이전트에게 실행을 맡기거나 직접 환경 변수를 설정하세요.

에이전트와 함께 쓰기

연결된 서비스는 에이전트에게 "이 서비스의 환경 변수가 run_command에 설정되어 있다"는 한 줄과 공식 문서 링크로 알려집니다. 그래서 "토스 결제위젯으로 결제 승인 API 호출 예제를 만들어서 실행해 봐" 같은 요청에 에이전트가 TOSS_SECRET_KEY를 코드에 박지 않고 환경 변수에서 읽는 코드를 쓰고, 그 명령을 실행해 결과를 확인합니다. 커머스 빌더 프리셋은 이 관례(시크릿은 환경 변수에서, 결제 승인·취소·웹훅 검증은 서버 측에서, 테스트 키와 라이브 키 구분)를 시스템 프롬프트에 담고 있습니다. 프리셋은 규칙과 MCP에서 설명합니다.

테스트 키(test_ck_…, test_sk_…)로 시작해서 흐름을 확인한 뒤 라이브 키로 바꾸는 것을 권합니다. 라이브 키를 넣은 기기에서는 자동 실행 모드를 쓸 때 어떤 명령이 실행되는지 더 주의 깊게 보세요. 위험한 명령은 자동 실행에서도 승인을 묻지만, 결제 API 호출은 일반 명령입니다.