카카오맵 API 키와 공공데이터 API 키, 클로드 루틴 어디에 넣나

카카오 개발용 키는 루틴 클라우드 환경의 'API 자격 증명'에, 공공데이터포털 인증키는 같은 편집 창의 '환경 변수'에 넣습니다. 그 전에 네트워크를 '사용자 지정'으로 바꾸고 주소 세 줄을 열어 둬야 403이 안 납니다.

시작 전에 확인	내용
클로드 요금제	루틴은 프로·맥스·팀·엔터프라이즈에서 열려요. 키를 숨겨 넣는 API 자격 증명은 프로와 맥스에만 있어요
카톡 연결	클로드 커넥터에 카카오 도구 모음(PlayMCP)이 연결돼 있어야 해요
공공데이터포털	회원 로그인만 되면 돼요
카카오 디벨로퍼스	앱이 없으면 하나 만들어요
걸리는 시간	승인 대기 0분. 활용신청도 카카오맵 사용 설정도 누르는 즉시 반영됐어요

1편 아침 브리핑 루틴을 이미 만든 분이라면 1단계부터 5단계까지 키만 받고 6단계로 가면 돼요. 루틴이 처음인 분이라면 위에서부터 순서대로 보세요. 버스 한 노선 알림만 필요하다면 카카오버스 앱 알람이 더 간단하니 여기서 닫으셔도 됩니다.

요금제와 한도는 2026년 10월 1일 현재 공식 문서로 다시 확인한 값이에요.

1단계 — 공공데이터포털에서 내 지역 창구를 활용신청한다

포털 검색창에 아래 서비스 이름을 그대로 넣어 찾습니다. 지역에 따라 신청할 개수가 달라요.

• 서울: 서울특별시_정류소정보조회 서비스 1개
• 경기: 경기도_버스도착정보 조회, 경기도_정류소 조회 2개

신청 화면에선 활용 목적을 고르고 한두 줄 설명을 적은 뒤, 이용허락범위 동의에 체크하고 제출합니다.

개발계정은 자동 승인이에요. 저는 세 개를 연달아 신청했는데, 제출할 때마다 승인 숫자가 바로 하나씩 늘었어요.

2단계 — 마이페이지에서 일반 인증키를 복사한다

마이페이지에서 신청한 창구를 누르면 상세 화면 아래쪽에 '일반 인증키'가 한 줄로 보입니다. 알파벳 소문자와 숫자가 섞인 64자짜리였어요(제 계정 기준).

창구가 여러 개여도 키는 하나예요. 서울 창구와 경기 창구 상세를 나란히 열어 봤는데 같은 값이었습니다.

이 키는 5단계까지 메모장에 잠깐 두세요. 9단계에서 씁니다.

3단계 — 내 정류장 번호를 확인한다

서울은 정류장 표지판의 노선 안내도 위쪽에 숫자 다섯 개가 붙어 있어요. 그 번호를 그대로 씁니다. 표지판을 볼 수 없으면 같은 서비스의 정류소 명칭 검색으로 이름을 넣어 찾으면 돼요.

경기는 표지판 번호를 그대로 쓰지 않습니다. 정류소 조회 창구에 정류장 이름을 넣으면 정류소 아이디가 돌아오고, 도착 조회엔 그 아이디를 넣어요.

4단계 — 카카오 디벨로퍼스에서 카카오맵 사용 설정을 켠다

카카오 디벨로퍼스에서 쓸 앱을 고르고 제품 설정 → 카카오맵 → 사용 설정을 켭니다. 상태가 '켜짐'으로 바뀌면 끝이에요.

여기서 하나만 화면과 다르게 하세요. 새로 앱을 만들고 싶어지는데, 이미 카카오맵을 켠 앱이 있다면 그 앱을 쓰는 게 맞아요. 무료 몫은 계정에서 처음 켠 앱 하나에만 붙고, 두 번째 앱부터는 무료가 없거든요.

5단계 — 플랫폼 키에서 개발용 키를 확인한다

같은 앱의 앱 설정 → 플랫폼 키로 들어가면 카카오 개발자 키(REST API 키) 카드가 보입니다. 복사 버튼으로 값을 가져와요.

이 키 하나로 주소를 좌표로 바꾸는 창구와 대중교통 경로 창구를 둘 다 부릅니다.

6단계 — 새 루틴 화면에서 클라우드 환경을 하나 추가한다

클로드 웹에서 루틴 → 새 루틴을 누릅니다. 지침 입력란 아래 '기본 클라우드 환경'을 누르면 환경 목록이 열리고, 맨 아래 '클라우드 환경 추가'를 고르면 돼요.

이름은 아무거나 적고, 네트워크 액세스를 '사용자 지정'으로 바꿉니다. 허용된 도메인 입력란에 아래 세 줄을 붙여요.

apis.data.go.kr
ws.bus.go.kr
dapi.kakao.com

위에서부터 경기 버스·정류소 창구, 서울 버스 창구, 카카오 창구의 주소예요. 그 아래 '일반적인 패키지 매니저의 기본 목록도 포함'에 체크하고 환경 추가를 누릅니다.

처음 값인 '신뢰됨'은 자주 쓰는 개발 주소만 열어 둔 목록이에요. 거기에 두 창구가 빠져 있어서, 이 단계를 건너뛰면 실행 기록에 거절 번호 403이 남아요. 기본 환경을 고치는 대신 새 환경을 만들면, 이 주소들이 다른 루틴에까지 열리지 않아요.

7단계 — 톱니 버튼으로 환경 편집 창을 연다

키는 환경을 만든 뒤에 넣습니다. 추가 창엔 API 자격 증명이 없고 편집 창에만 있거든요.

환경 목록에서 방금 만든 환경 이름에 마우스를 올리면 오른쪽에 톱니 모양 버튼이 뜹니다.

이걸 누르면 클라우드 환경 편집 창이 열려요.

8단계 — 카카오 키는 API 자격 증명에 넣는다

편집 창의 API 자격 증명에서 '자격 증명 추가'를 누릅니다.

1. 이름: 알아볼 수 있게 아무거나(저는 '카카오 로컬·경로') 2. 허용된 웹사이트: 카카오 창구 주소(dapi.kakao.com) 3. 사용자 지정 헤더 이름: 이미 들어 있는 Authorization(인증 표시)을 그대로 둠 4. 접두사: 기본값을 지우고 KakaoAK(카카오 키 표시)로 바꿈 5. 값: 5단계에서 복사한 개발용 키

다 채우면 연결을 누릅니다.

접두사가 이 단계에서 제일 놓치기 쉬워요. 빈 창의 기본값은 일반 토큰 표시(Bearer)인데, 카카오는 KakaoAK를 기다리니 그대로 두면 카카오가 키를 알아보지 못해요.

저장한 뒤에는 값을 다시 볼 수도, 고칠 수도 없어요. 바꾸려면 지우고 새로 넣어야 합니다.

9단계 — 공공데이터 키는 환경 변수에 한 줄로 넣는다

같은 편집 창 위쪽의 환경 변수 입력란에 한 줄을 적어요. 키트의 키 등록 형식대로 하면 아래처럼 됩니다.

DATA_GO_KR_KEY=여기에_공공데이터포털_인증키

등호 오른쪽을 2단계에서 복사한 인증키로 바꾸는 줄이에요. 이름 쪽은 루틴 문장이 그 이름으로 키를 찾으니 그대로 두세요. 적고 나면 변경사항 저장을 누릅니다.

여기 적은 값은 클로드 눈에 그대로 보여요. 화면에도 '이 환경을 사용하는 모든 사람에게 표시된다'고 적혀 있습니다. 그래서 이 환경은 혼자 쓰는 개인 환경으로만 두세요.

10단계 — 지침·환경·스케줄·커넥터를 채우고 만든다

편집 창을 닫으면 아까 열어 둔 새 루틴 화면으로 돌아옵니다.

1. 이름을 적고 지침에 루틴 문장을 붙여요(키트 스킬이 만든 문장이면 정류장·주소가 이미 들어 있어요) 2. 클라우드 환경을 방금 만든 환경으로 바꿔요 3. 트리거 → 스케줄 → 평일, 시각을 골라요 4. 커넥터 목록에 카카오 도구 모음이 있는지 보고, 안 쓰는 커넥터는 지워요 5. 만들기를 눌러요

시각은 저는 7:57에 맞췄어요. 공식 문서가 정각 예약은 출발이 조금 밀릴 수 있다며 9:07처럼 비킨 시각을 예로 들거든요.

커넥터는 목록에 남아 있는 것을 루틴이 묻지 않고 씁니다. 쓰기 기능이 있는 커넥터까지요. 버스 브리핑엔 카카오 도구 모음 하나면 돼요.

11단계 — 지금 실행을 누르고 실행 기록을 연다

만들기를 누르면 그 루틴 화면이 바로 열려요. 지금 실행을 누르고 조금 기다리면 기록에 초록 표시가 뜹니다.

여기서 끝내면 안 돼요. 초록은 작업이 오류 없이 시작했다가 끝났다는 뜻일 뿐, 카톡 전송 성공을 말해 주지 않아요. 기록을 눌러 버스·경로·날씨 값이 찍혔는지, 카톡 보내는 도구를 부른 줄이 있는지 직접 봅니다.

지금 실행 버튼으로 저도 두 번 시험했는데, 두 번 다 카톡을 받았고 두 번째 메시지가 175자였어요.

카카오 키가 제대로 붙었는지는 어떻게 확인하나요?

루틴을 돌리기 전에 키만 따로 확인할 수 있어요. 같은 환경에서 작업을 하나 열고 클로드에게 이렇게 부탁합니다.

curl -s -G "https://dapi.kakao.com/v2/local/search/address.json" --data-urlencode "query=서울 중구 세종대로 110" 를 실행해서 결과를 보여 줘.

카카오 주소 검색 창구에 시청 주소를 넣어 보라는 부탁이에요. 키를 직접 적지 않았는데도 주소와 좌표 값이 돌아오면 자격 증명이 붙은 겁니다.

자격 증명 목록에 '보내지 않음' 표시가 뜨면 그 밑에 이유와 고치는 법이 적혀 있어요. 그 설명대로 고치면 됩니다.

증상별 해결표

이렇게 막혔어요	원인	해결	고친 뒤 확인할 숫자
초록인데 카톡이 안 와요	초록은 작업 성공 표시가 아님	실행 기록을 열어 값과 카톡 도구 호출을 확인	카톡 도구 호출 1회
기록에 403이 찍혀요	허용 주소에 없어서 막힘	네트워크 사용자 지정 + 6단계 주소 세 줄	403 0회, 도착 분 값이 찍힘
키 미등록 오류가 나요	키를 잘못 붙였거나 그 창구를 활용신청 안 함	마이페이지에서 키를 다시 복사, 활용신청 승인 확인	승인 숫자에 그 창구가 포함
자격 증명에 보내지 않음이 떠요	키가 요청에 안 붙음	표시 아래 설명대로 수정	표시가 사라지고 주소 검색이 값을 돌려줌
값은 다 있는데 카톡이 없어요	카카오 도구 모음 연결이 끊김, 또는 200자 초과	커넥터 연결 확인, 줄 줄이기	메시지 200자 이하(제 경우 175자)
경로 시간이 2280 같은 큰 숫자로 와요	걸리는 시간이 초 단위로 옴	지침에 '초를 분으로 환산'이라고 한 줄	2,280초 → 38분

키 미등록 오류(SERVICE_KEY_IS_NOT_REGISTERED_ERROR)는 키를 주소에 붙이는 과정에서 글자가 두 번 바뀌어도 난다는 보고가 개발자 커뮤니티에 여럿 있어요. 제 키는 특수문자 없이 영문 소문자와 숫자뿐이라 그 문제는 없었습니다.

같은 조건에서 두 키를 비교하면 무엇이 다른가?

두 키는 넣는 곳이 다르고 그 이유도 달라요. 같은 편집 창 안에서 비교하면 이렇습니다.

	카카오 키	공공데이터 키
넣는 곳	API 자격 증명	환경 변수
클로드가 값을 보나	안 봄	읽을 수 있음
저장 후 수정	불가, 지우고 다시	고쳐서 다시 저장
키가 실리는 곳	요청 머리말	요청 주소 끝

카카오 키는 요청 머리말에 실리는 방식이라 자격 증명 창의 사용자 지정 헤더에 그대로 맞아요. 반면 공공데이터 키는 주소 끝에 붙는 방식이에요. 자격 증명 쪽에도 그런 방식이 목록에 있긴 한데, 세부 동작이 공식 문서에 없어서 저는 확실히 되는 환경 변수를 골랐어요.

이 방법으로 안 되는 것

• 출발 시각을 정해서 경로를 받을 수 없어요. 카카오 대중교통 경로 창구에 그 값이 없어요.
• 집에서 첫 정류장까지 걷는 구간은 빠져요. 카카오 운영진이 정상 응답이라고 답한 부분이에요.
• 경로 값을 저장해 두고 쓰면 안 돼요. 그래서 루틴 문장엔 좌표 대신 주소를 적고, 매일 아침 새로 찾게 합니다.
• 루틴은 정식 출시 전 미리보기 단계예요. 한도와 동작이 달라질 수 있어요.

줄을 더 붙이는 법

루틴 편집에서 커넥터 추가로 구글 캘린더를 넣으면 오늘 일정 줄을, 노션을 넣으면 할 일 줄을 받을 수 있어요. 우산 안내는 도구가 필요 없고 루틴 문장에 '비 예보면 우산 한 줄'이라고 적으면 됩니다. 퇴근 경로는 출발과 도착을 뒤집어 경로 창구를 한 번 더 부르는 문장을 추가하세요.

다만 나와의 채팅 도구가 받는 글은 200자가 끝이에요. 175자였던 제 메시지엔 25자밖에 여유가 없었습니다. 줄을 늘리려면 노선이나 종목 줄을 먼저 덜어 내세요.

아침 한 번 돌리면 창구 요금은 얼마인가?

버스 도착은 한 번 부르고 한도는 하루 1,000번이에요. 주소를 좌표로 바꾸는 건 집과 회사 두 번, 하루 100,000건까지 무료고요. 경로는 한 번이라 무료 1,000건 중 1건만 씁니다.

세 창구 다 하루 한도의 1%를 넘지 않아 창구 요금은 들지 않아요. 비용이 생기는 쪽은 클로드 구독이에요. 루틴은 대화할 때처럼 구독 사용량을 쓰고, 예약 실행은 한 계정이 시간당 100회까지 걸 수 있어요.

다 했는지 점검

• [ ] 활용신청 승인 숫자에 내 지역 창구가 들어 있다
• [ ] 카카오맵 사용 설정이 켜짐이다
• [ ] 새 환경의 네트워크가 사용자 지정이고 주소 세 줄이 있다
• [ ] 자격 증명에 카카오 주소 한 줄이 보이고 보내지 않음 표시가 없다
• [ ] 환경 변수에 공공데이터 키 한 줄이 있다
• [ ] 루틴의 환경이 기본 환경이 아니라 새 환경이다
• [ ] 실행 기록에 버스·경로·날씨 값과 카톡 도구 호출이 보인다

하나라도 비면 그 단계로 돌아가세요. 일곱 개가 다 차면 다음 평일 아침부터 카톡이 옵니다.

막힌 단계 번호와 실행 기록 첫 줄을 댓글로 남겨 주시면 같이 볼게요. 단계별 클릭 장면은 따라 하기 영상으로 보실 수 있어요. 내 정류장·주소가 들어간 문장을 대신 써 주는 무료 스킬은 방구석모각코 오픈채팅방 공지에 올려 두었고, 파일을 여는 비밀번호는 영상 4:03 화면에 있어요.