Koko 커넥터

최종 업데이트: 2026년 8월 13일

Koko는 Claude 및 ChatGPT에 앱으로 연결됩니다. 그래서 대화에서 계획한 여행을 Koko 계정에 저장하고, 지도에서 열고, 함께 가는 사람들과 공유하고, 나중에 같은 대화에서 다시 편집할 수 있습니다. 이 페이지에서는 설정 방법, 각 도구의 역할, 어시스턴트가 접근할 수 있는 것과 없는 것, 제한 사항을 설명합니다.

설정하기

무료 Koko 계정이 필요합니다. 먼저 kokotravel.ai에서 가입하거나, 연결 과정에서 계정을 만드세요.

서버 세부 정보

MCP endpoint: https://kokotravel.ai/mcp
Transport: 스트리밍 가능한 HTTP(상태 비저장 JSON-RPC)
Authentication: PKCE 및 동적 클라이언트 등록을 사용하는 OAuth 2.1. 붙여 넣을 클라이언트 ID나 API 키는 없습니다.

Claude에서

Settings → Connectors를 열고 디렉터리에서 Koko를 추가하거나, 위 엔드포인트를 사용해 커스텀 커넥터로 추가하세요.
Connect를 클릭하면 Koko 로그인 페이지가 열립니다.
Google로 로그인하거나, 이메일과 6자리 코드로 로그인하거나, Koko 사용자 이름과 비밀번호로 로그인하세요. 그런 다음 접근을 허용하세요.

ChatGPT에서

앱 디렉터리에서 Koko를 추가하거나, 위 엔드포인트를 사용해 커넥터로 추가하세요.
Connect를 클릭하고 같은 방식으로 Koko에 로그인하세요.

Claude Code 또는 다른 MCP 클라이언트에서

claude mcp add --transport http koko https://kokotravel.ai/mcp

그런 다음 /mcp를 실행하고 브라우저에서 로그인을 완료하세요.

커넥터로 할 수 있는 일

여섯 가지 도구가 있으며, 모두 로그인한 계정 범위 안에서만 작동합니다. 읽기 도구는 매번 프롬프트 없이 실행될 수 있습니다. 쓰기 도구는 저장된 내용을 변경하며, update_koko는 목록을 통째로 교체하므로 Claude가 실행 전에 확인을 요청합니다.

send_to_koko 목록 또는 일정을 Koko에 저장 쓰기

대화에서 설명한 장소를 바탕으로 계정에 새 목록 또는 일정을 만듭니다. 단순한 장소 묶음은 목록이 되고, 날짜별로 묶인 시간 있는 장소들은 일정이 됩니다. Koko가 각 장소를 지오코딩한 뒤, 평점, 영업시간, 사진을 백그라운드에서 채웁니다. 보기 링크는 바로 반환됩니다.

my_koko 내 목록 & 일정 읽기 전용

계정에 이미 있는 항목을 나열합니다: 제목, 종류, 장소 수, id. 계정의 다른 내용은 노출되지 않습니다.

get_koko 편집할 목록 또는 일정 열기 읽기 전용

어시스턴트가 수정한 뒤 새 버전을 다시 보낼 수 있도록, 목록 또는 일정을 편집 가능한 구조로 반환합니다.

check_koko_status 빌드 진행 확인 읽기 전용

빌드가 어디까지 진행됐는지 보고합니다: 수신됨, 위치 찾는 중, 정보 보강 중, 준비됨. 저장 직후에 유용합니다. 핀이 먼저 나타나고 사진은 나중에 따라오기 때문입니다.

update_koko 목록 또는 일정 업데이트 전체 교체

기존 목록 또는 일정의 내용을 새 버전으로 교체합니다. 교체본에서 빠진 항목은 삭제되므로 파괴적 작업으로 간주되어 먼저 확인을 요청합니다. id와 공유 링크는 그대로 유지되므로, 이미 공유받은 사람도 업데이트된 내용을 보게 됩니다.

refresh_details 평점 & 사진 새로고침 쓰기

기존 목록의 평점, 리뷰, 영업시간, 사진을 다시 가져옵니다. 이 작업은 장소마다 Koko에 비용이 발생하므로, 먼저 예상 비용을 계산하고 사용자가 확인한 경우에만 진행합니다.

파트너 도구 (인증 크리에이터)

Discover에 공개하는 파트너 프로그램 회원, 즉 인증 크리에이터에게는 8개의 도구가 추가로 열립니다. 그 외 계정에서는 “인증 크리에이터가 아닙니다”라고 답하고 아무것도 바꾸지 않습니다. 모두 자기 크리에이터 페이지 범위 안에서만 동작합니다.

creator_profile 내 크리에이터 프로필 보기 읽기 전용

크리에이터 페이지의 프로필을 읽습니다. 이름, 필, 한 줄 소개, 소개, 활동 지역, 링크, 소셜, 기본 가격, 그리고 Discover 노출 여부.

update_creator_profile 내 크리에이터 프로필 수정 쓰기

같은 항목들을 바꿉니다. 바꿀 것만 보내세요. 필은 세트 단위로 통째로 교체됩니다. 핸들은 공개 URL 그 자체라 변경할 수 없습니다.

my_listings 내 판매 항목 읽기 전용

내가 가진 모든 리스트와 플랜을 Discover 공개 여부, 가격 티어, 공유 링크, 최근 30일 조회수, 누적 구매 수와 수익까지 함께 보여줍니다.

set_listing Discover에 공개 / 공개 내리기 쓰기

내 리스트나 플랜 하나를 표준 가격 단계(무료, $1, $2, $5, $10) 중 하나로 공개 Discover 선반에 올리거나, 내립니다. 내리면 가격은 항상 지워집니다.

creator_stats 크리에이터 통계 읽기 전용

7일, 30일, 90일 기준 조회수, 순 방문자, 구매 수, 수익을 크리에이터 페이지 전체 또는 판매 항목 하나에 대해, 합계와 일별 추이로 보여줍니다.

create_coupons 쿠폰 코드 발행 쓰기

유료 판매 항목의 코드를 만듭니다. 한 장이든 쉰 장이든, 1회용이든, 여러 번 쓸 수 있는 코드 하나든 가능합니다. 쿠폰은 구매자가 낼 더 낮은 티어를 정하는 것이고(기본값은 무료), 할인율이 아닙니다.

coupons 판매 항목의 쿠폰 읽기 전용

내 판매 항목 하나에 발행된 모든 코드를, 사용 중인 것도 비활성화된 것도, 몇 번 누가 썼는지와 함께 보여줍니다.

disable_coupon 쿠폰 비활성화 쓰기

코드를 더 이상 쓸 수 없게 합니다. 기록은 남습니다.

예시 프롬프트

“도쿄 시부야의 유명 라멘 가게 세 곳, Ichiran Shibuya, Nagi Golden Gai, Hakata Ippudo Shibuya 목록을 만들어 줘. ‘Shibuya Ramen’으로 Koko에 저장해.”

send_to_koko를 사용합니다. 보기 링크가 반환됩니다.

“도쿄 아사쿠사에서의 하루를 계획해 줘: 09:00에 센소지, 12:00에 Daikokuya Tempura에서 점심, 14:00에 도쿄 스카이트리. ‘Asakusa Day’로 Koko에 저장해.”

send_to_koko를 사용하며, 정류지에 시간이 있으므로 목록이 아니라 계획으로 저장합니다.

“Koko에 내가 저장한 게 뭐가 있어?”

my_koko를 사용합니다.

“내 Shibuya Ramen 목록 준비됐어?”

check_koko_status를 사용합니다.

“내 Shibuya Ramen 목록에서 Hakata Ippudo를 빼고 대신 Afuri Ebisu를 추가해.”

get_koko 다음 update_koko를 사용합니다. 같은 링크에 내용만 업데이트됩니다.

어시스턴트가 접근할 수 있는 것과 없는 것

가능: 로그인한 Koko 계정의 목록과 계획을 생성, 읽기, 업데이트할 수 있습니다.
불가: 다른 사용자의 콘텐츠를 보거나, 계정을 삭제하거나, 로그인 정보를 변경하거나, 무엇이든 공개 상태로 만들 수 없습니다. Koko의 공개 Discover 선반에 게시하는 기능은 Koko의 운영자 계정으로 제한됩니다. 일반 계정에서 그런 요청을 하면 대신 비공개로 저장되며, 응답에서 그 사실을 알려줍니다.
저장되는 내용의 개인정보: 커넥터를 통해 생성된 목록과 계획은 비공개입니다. 보기 링크는 Koko 웹 앱에 로그인한 본인에게만 표시됩니다. 공유는 앱에서 별도로, 의도적으로 실행하는 단계입니다.
Koko가 받는 것: 어시스턴트가 사용자를 대신해 보내는 요청뿐입니다. 예를 들면 저장할 장소 이름 목록입니다. 대화 내용은 어시스턴트 제공업체에 남습니다. 자세한 내용은 개인정보 처리방침을 확인하세요.

제한

도구 호출은 사용자당 분당 약 30회로 속도 제한됩니다. 이를 초과하면 Retry-After 헤더와 함께 429가 반환됩니다.
저장은 백그라운드에서 생성되며, 사용량이 많을 때는 대기열에 들어갑니다. 큰 계획은 사진과 평점이 모두 반영되기까지 약 1분 정도 걸립니다.
커넥터는 무료이고, 커넥터가 하는 어떤 일도 돈을 쓰지 않습니다. Koko의 핵심 기능도 무료입니다. 앱의 Discover 선반에서는 일부 크리에이터가 App Store 결제로 리스트를 판매하지만, 어느 쪽이든 결제 정보가 Koko에 오는 일은 없습니다. 일반 계정의 사용 한도는 약관에 있습니다.
Koko는 작은 팀이 만든 얼리 액세스 프리뷰입니다. 장소 정보는 서드파티에서 제공되며 오래되었을 수 있으니, 여행 전에 중요한 내용은 직접 확인하세요.

연결 해제

어시스턴트의 커넥터 설정에서 Koko 연결을 해제하세요. 그러면 액세스 토큰이 즉시 폐기되고, Koko는 사용자를 대신해 들어오는 요청을 더 이상 받지 않습니다. 목록과 계획은 Koko 계정에 그대로 남습니다. 이것까지 삭제하려면 FAQ의 계정 삭제 섹션에서 계정을 삭제하세요.

지원

모든 메시지는 사람이 읽습니다. 어시스턴트에게 무엇을 요청했고 어떤 응답이 돌아왔는지와 함께 [email protected]으로 이메일을 보내세요. FAQ, 개인정보 처리방침, 이용약관도 참고하세요.