계정과 API 키 설정

연결하려는 서비스의 계정과 인증 방식을 확인하세요. 현재 앱이 비밀정보 입력란이나 로그인 절차를 제공하면 그 경로를 사용합니다. 앱 이름만으로 입력 폼의 존재나 저장 위치를 단정하지 않습니다.

flowchart TD
accTitle: 계정 선택부터 실제 조회 확인까지
accDescr: 서비스와 업무 계정을 선택한 뒤 현재 앱의 인증 절차 또는 로컬 서버의 자격증명 설정을 사용한다. 현재 노출된 도구로 읽기 전용 조회를 하고 계정과 결과를 비교한다.
 A["서비스 · 업무 계정 선택"] --> B{"지원되는 인증 경로는?"}
 B -->|앱 로그인 · 비밀정보 입력| C["앱이 제공하는 인증 절차"]
 B -->|로컬 서버| D["환경변수 · 계정별 파일 설정"]
 C --> E["현재 도구 노출 확인"]
 D --> E
 E --> F["읽기 전용 조회"]
 F --> G["계정 · 조직 · 기간 · 결과 비교"]

여러 쇼핑몰 계정을 쓰는 프로젝트라면 먼저 이번 업무가 어느 계정의 주문을 다루는지 정합니다. 앱 인증과 로컬 서버 설정 중 실제 지원하는 경로를 사용하며, 로컬 자격증명 파일이 웹 Projects에 자동으로 전달된다고 가정하지 않습니다.

키는 채팅이나 프로젝트 지침에 넣지 않습니다. 설정 후에는 변경 작업보다 읽기 전용 조회를 먼저 하고, 반환된 계정·기간·자료를 비교합니다. 파일이 존재해도 키가 만료되었거나 다른 계정이라면 업무 자료를 올바르게 조회한 상태가 아닙니다.

MoAI 자체 서버 중 공통 자격증명 모듈을 사용하는 서버는 환경변수 또는 로컬 파일을 읽습니다. 기본 경로는 ~/.moai/mcp/<서비스>.json입니다. 이 경로는 계정의 웹 Projects 저장소가 아닙니다. 파일을 읽을 수 있는 로컬 실행 환경에서만 사용합니다.

{
  "DART_API_KEY": "본인 컴퓨터에서 입력"
}

키 값은 채팅·지침·Git 저장소에 넣지 않습니다. 실제 키 입력은 본인 컴퓨터의 지원되는 비밀정보 경로에서 진행합니다.

지원되는 공통 모듈의 <SERVICE>_CREDENTIALS_FILE 설정으로 프로젝트·계정별 파일을 지정할 수 있습니다. 예를 들어 SMARTSTORE_CREDENTIALS_FILE은 스마트스토어 파일 경로를 선택합니다. 실제 키 환경변수와 파일 선택 설정을 함께 사용할 때는 서버의 우선순위를 확인합니다.

OAuth 로그인은 실제 인증된 사용자와 권한을 확인하세요. 토큰 저장과 갱신 방식은 서버별로 다릅니다. 전역 파일 하나에 서로 다른 업무 계정을 섞지 않습니다.

파일 생성은 인증 성공이 아닙니다. 읽기 전용 조회로 계정·권한·유효 기간을 확인합니다. API 이용료와 앱 구독은 각 서비스에서 확인하세요. 실패하면 연결 문제 해결로 이동합니다.

• 공통 자격증명 구현
• ChatGPT 연결과 인증
• Claude 연결 범위