# 문제 해결

> 자주 만나는 오류와 해결 방법입니다.

## "macOS is asking for permission to use the keychain"

macOS가 키체인 사용 허가 창을 띄웠는데 20초 안에 아무도 답하지 않았습니다. 화면이 잠겨 있거나 사람이 없는 컴퓨터에서 생깁니다. 그 컴퓨터 앞에서 허용한 뒤 다시 실행하세요. 사람이 없는 컴퓨터라면 `aisync keystore file`로 키를 파일(권한 0600)에 두세요. 이 선택은 aisync 설정에 저장되므로, Claude Code가 셸 환경 없이 MCP 서버를 띄울 때도 그대로 적용됩니다. 바꾼 뒤에는 `aisync unlock`(Vault는 `aisync vault login`)을 다시 하세요.

## "secrets for … are locked on this machine"

이 컴퓨터에 저장소 키가 없습니다. 처음 쓰는 컴퓨터이거나 다른 곳에서 `aisync passwd`로 패스프레이즈를 바꾼 경우입니다.

```sh
aisync unlock
```

## MCP 서버가 뜨지 않음

`.claude.json`에 적힌 서버 명령을 터미널에서 그대로 실행하면 오류가 보입니다.

```sh
aisync exec --repo you/aisync-config -- npx -y @modelcontextprotocol/server-slack
```

키가 없거나(위 항목), 참조한 토큰 이름이 저장소에 없거나, Vault 토큰이 만료된 경우가 대부분입니다.

## "profile … changed in the repo since your last pull"

다른 컴퓨터에서 같은 프로필을 올렸습니다. 먼저 받으세요. 이 컴퓨터에서만 고친 파일은 그대로 남습니다.

```sh
aisync pull default
aisync push default
```

## "these changed both here and in the repo"

같은 파일을 양쪽에서 고쳤습니다. 리포 것을 받으려면 `aisync pull --force`, 내 것을 남기려면 `aisync push --force`입니다. 자세한 내용은 [동기화와 충돌](/docs/sync/)을 보세요.

## "secret-looking values would be committed in plain text"

올리려는 내용에 토큰이 보입니다. MCP 서버라면 `--secrets`를 붙여 저장소로 옮기고, 파일이라면 값을 빼세요. [시크릿](/docs/secrets/)에 방법이 있습니다.

## 받은 뒤에도 새 MCP 서버가 안 보임

Claude Code는 세션을 시작할 때만 MCP 서버를 읽습니다. 세션을 다시 시작하세요.

## 처음 받을 때 기존 설정이 사라질까 걱정됨

받기 전에 `aisync pull default --dry-run`으로 무엇을 바꿀지 볼 수 있습니다. 실제로 받을 때도 바꾸거나 지우는 파일은 `<설정 폴더>/.aisync/backup/`에 먼저 복사합니다.