사례 2주차 2026-08-03 · B2B 잠재고객 발굴 에이전트 연재

클로드 커넥터가 안 될 때, 이미 설치해둔 CLI로 우회한 이야기

구글시트 커넥터가 계속 권한 오류로 막혀서, 원인을 찾는 대신 이미 인증돼 있던 gws CLI로 갈아타 일단 진도를 나간 트러블슈팅 기록.

누구에게 도움: 클로드(또는 AI 도구)의 특정 연동이 계속 권한 오류로 막혀서, 원인은 못 찾았지만 일단 진도를 나가고 싶은 사람.

Before

PRD 세부계획 Day 1은 “구글시트에 클로드가 직접 읽고 쓸 수 있게 연결하기”였다. 클로드 코드가 가이드해준 방식대로 커스텀 커넥터(구글시트 연동)를 설정하고 진행했는데, 계속 오류가 났다. 지난주(7/30) 일지에도 “권한 없음(permission) 에러가 계속 남”이라고 적어뒀을 정도로, 며칠째 안 풀리고 있었다.

어떻게 했나

1) 다시 시도했는데 또 막혔다

기존 시트 셀에 값을 쓰는 건 됐지만(“테스트”를 A4 셀에 성공적으로 씀), 새 구글시트를 만드는 건 여전히 안 됐다.

Error: Permission denied
Please ensure the service account has access to the spreadsheet.

새 파일을 만드는 요청 자체를 거부하는 걸 보고, “이 커넥터는 이미 공유받은 파일만 다룰 수 있고, 새로 만드는 권한 자체가 없는 구조인가 보다”라는 심증까지는 갔다. 하지만 커넥터 설정 화면에서 이 연동 자체를 찾을 수가 없어서, 권한을 직접 고칠 방법도 없었다.

2) 원인 찾기를 포기하고, 이미 있는 다른 길을 확인했다

근본 원인을 계속 파기보다, “혹시 이걸 우회할 다른 방법이 이미 있나?”로 방향을 틀었다. 마침 예전에 지피터스 설치 클래스를 따라 gws라는 구글 워크스페이스 CLI를 설치해서 로그인까지 해뒀던 게 있었다.

gws auth status

확인해보니 이미 내 구글 계정으로 OAuth 인증이 돼 있었고, drive·spreadsheets 권한까지 다 갖고 있었다.

3) CLI로 직접 새 시트를 만들고 값을 썼다

gws sheets spreadsheets create --json '{"properties": {"title": "lead gen test 2"}}'
gws sheets spreadsheets values update \
  --params '{"spreadsheetId": "생성된ID", "range": "B1", "valueInputOption": "USER_ENTERED"}' \
  --json '{"values": [["테스트"]]}'

새 시트가 바로 만들어지고, B1 셀에 값도 정상적으로 들어갔다.

여기에 실제로 만들어진 구글시트에 “테스트” 값이 채워진 화면 스크린샷을 넣으면 좋다.

막힘 → 해결

  • 막힘: 커넥터가 왜 새 파일 생성 권한만 없는지, 근본 원인(root cause)은 끝내 못 찾았다.
  • 해결(우회): 원인 파악과 별개로, 이미 설치·인증돼 있던 다른 도구(gws CLI)로 같은 작업을 완전히 다른 경로로 성공시켰다.
  • 커넥터 오류의 진짜 원인은 다음 과제로 남겨뒀다.

After

  • 며칠째 막혀 있던 PRD 세부계획 Day 1(구글시트 연결)의 완료 기준 — “빈 구글시트에 테스트로 아무 값이나 써넣는 데 성공” — 을 오늘 달성했다.
  • 다음 단계(공공데이터 API 키 발급, ICP 설정 등)로 넘어갈 수 있게 됐다.
  • 다만 마음은 100% 개운하지 않다. 문제를 “해결”한 게 아니라 “우회”한 거라서, 근본 원인은 여전히 찜찜하게 남아 있다.

배운 것 / 재사용 자산

막힌 연동이 있을 때 시도해볼 체크리스트

  1. 정확히 어느 단계에서, 어떤 메시지로 막히는지부터 기록한다 (오늘처럼 “Permission denied” 원문을 남겨두면 나중에 검색하기도 쉽다).
  2. 근본 원인을 못 찾겠으면, 오래 붙잡고 있지 말고 “이미 설치·인증해둔 다른 도구가 있나?”부터 확인한다. (which <도구명>, <도구명> auth status 같은 명령으로 빠르게 확인 가능)
  3. 우회로 일단 진도를 나가되, 원인 파악은 완전히 잊지 말고 다음 과제로 명시적으로 남겨둔다.

같은 목표(구글시트에 값 쓰기)라도 접근 경로가 여러 개일 수 있다는 것, 그리고 “원인을 몰라도 일단 우회해서 앞으로 나가도 된다”는 걸 배웠다.