Koko コネクタ

最終更新：2026年8月13日

Koko は Claude と ChatGPT にアプリとして接続します。会話の中で立てた旅程をそのまま Koko アカウントに保存し、地図で開き、同行する人と共有し、あとから同じ会話で編集できます。このページでは、設定方法、各ツールの動作、アシスタントがアクセスできる範囲、そして制限について説明します。

設定する

無料の Koko アカウントが必要です。先に kokotravel.ai で登録するか、接続の流れの中で作成してください。

サーバー情報

MCP エンドポイント： https://kokotravel.ai/mcp
トランスポート： streamable HTTP（ステートレス JSON-RPC）
認証： OAuth 2.1（PKCE および動的クライアント登録）。貼り付けるクライアント ID や API キーはありません。

Claude での手順

設定 → コネクタ を開き、ディレクトリから、または上記エンドポイントを使ったカスタムコネクタとして Koko を追加します。
接続をクリックします。Koko のサインインページが開きます。
Google、メールアドレスと6桁のコード、または Koko のユーザー名とパスワードでサインインし、アクセスを許可します。

ChatGPT での手順

アプリディレクトリから Koko を追加するか、上記エンドポイントでコネクタとして追加します。
接続をクリックし、同じ方法で Koko にサインインします。

Claude Code など他の MCP クライアントでの手順

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

そのあと /mcp を実行し、ブラウザでサインインを完了します。

コネクタでできること

ツールは6つ。すべてサインインしたアカウントの範囲内で動作します。読み取り系は毎回の確認なしで実行できます。書き込み系は保存済みの内容を変更し、update_koko はリストを丸ごと置き換えるため、Claude は実行前に確認します。

send_to_koko リストやプランを Koko に保存 書き込み

会話で挙がった場所から、アカウント内に新しいリストまたはプランを作成します。時間のない場所の集まりはリストに、日ごとにまとめられ時間の付いた場所はプランになります。Koko は各スポットをジオコーディングし、評価・営業時間・写真をバックグラウンドで補完します。閲覧リンクはすぐに返されます。

my_koko 自分のリストとプラン 読み取り専用

アカウントにあるものを一覧します：タイトル、種別、スポット数、id。それ以外の情報は公開されません。

get_koko リストやプランを編集用に開く 読み取り専用

1件のリストまたはプランを編集可能な構造で返します。アシスタントはそれを変更し、新しいバージョンを書き戻せます。

check_koko_status 作成の進行状況を確認 読み取り専用

作成の進み具合を返します：受付、位置特定、情報補完、完了。ピンが先に表示され写真は後から届くため、保存直後の確認に便利です。

update_koko リストやプランを更新 全置換

既存のリストまたはプランの内容を新しいバージョンで置き換えます。置換内容に含まれなかったものは削除されるため、破壊的な操作として扱われ、事前に確認が入ります。id と共有リンクは変わらないので、すでに共有した相手にも更新が反映されます。

refresh_details 評価と写真を更新 書き込み

既存リストの評価、レビュー、営業時間、写真を再取得します。これはスポットごとに Koko の費用が発生するため、まず見積もりを出し、確認後にのみ実行します。

パートナー向けツール（認定クリエイター）

Discover に公開しているパートナープログラムの認定クリエイターには、さらに 8 つのツールが有効になります。それ以外のアカウントでは「認定クリエイターではありません」と返答し、何も変更しません。すべて自分のストアフロントの範囲内で動作します。

creator_profile クリエイタープロフィールを見る 読み取り専用

ストアフロントのプロフィールを読み取ります。名前、ピル、タグライン、自己紹介、拠点、リンク、SNS、デフォルト価格、Discover に表示するかどうか。

update_creator_profile クリエイタープロフィールを更新 書き込み

同じ項目を変更します。変更したい項目だけを送ってください。ピルはセットごと置き換わります。ハンドルは公開 URL そのものなので変更できません。

my_listings 自分のリスティング 読み取り専用

所有するすべてのリストとプランについて、Discover 掲載の有無、価格ティア、共有リンク、直近 30 日の閲覧数、累計の購入数と売上を返します。

set_listing Discover に掲載 / 掲載をやめる 書き込み

リストやプランを標準の価格ラダー（無料、$1、$2、$5、$10）のいずれかで Discover に公開するか、掲載を取り下げます。取り下げると価格は必ずクリアされます。

creator_stats クリエイター統計 読み取り専用

7 日・30 日・90 日の閲覧数、ユニーク閲覧者数、購入数、売上を、ストアフロント全体または 1 件のリスティングについて、合計と日次の推移で返します。

create_coupons クーポンコードを発行 書き込み

有料リスティングのコードを発行します。1 枚でも 50 枚でも、1 回限りでも、1 つのコードを多くの人が使える形でも。クーポンは購入者が支払う下位ティア（既定は無料）を指定するもので、割引率ではありません。

coupons リスティングのクーポン一覧 読み取り専用

そのリスティングのすべてのコードを、有効・無効を問わず、利用回数と利用者とともに返します。

disable_coupon クーポンを無効化 書き込み

コードの利用を止めます。履歴は残ります。

プロンプト例

「東京・渋谷の有名なラーメン店3軒のリストを作って：一蘭渋谷、凪ゴールデン街、博多一風堂渋谷。Koko に『渋谷ラーメン』として保存して」

send_to_koko を使います。閲覧リンクが返ってきます。

「東京・浅草の1日プランを立てて：9:00 に浅草寺、12:00 に大黒家天麩羅で昼食、14:00 に東京スカイツリー。Koko に『浅草日帰り』として保存して」

send_to_koko を使い、各スポットに時間があるためリストではなくプランとして保存します。

「Koko に何を保存してある？」

my_koko を使います。

「渋谷ラーメンのリストはもう出来た？」

check_koko_status を使います。

「渋谷ラーメンのリストから博多一風堂を外して、代わりに AFURI 恵比寿を追加して」

get_koko のあと update_koko を使います。リンクは同じで、内容だけ更新されます。

アシスタントがアクセスできる範囲

できること：サインインした Koko アカウント内のリストとプランの作成、閲覧、更新。
できないこと：他のユーザーのコンテンツの閲覧、アカウントの削除、サインイン情報の変更、コンテンツの公開。Koko の公開棚 Discover への掲載は Koko 運営アカウントに限られます。通常のアカウントではその依頼は非公開の保存に切り替わり、返答でその旨が伝えられます。
保存される内容のプライバシー：コネクタ経由で作成したリストとプランは非公開です。閲覧リンクは Koko ウェブアプリにサインインした本人にのみ表示されます。共有はアプリ内で自分が行う別の操作です。
Koko が受け取るもの：アシスタントがあなたに代わって送るリクエストのみ（例：保存するスポット名のリスト）。会話の内容はアシスタント提供元に留まります。詳細はプライバシーポリシーをご覧ください。

制限

ツール呼び出しは1ユーザーあたり毎分およそ30回に制限されています。超えると Retry-After ヘッダー付きの 429 が返ります。
保存はバックグラウンドで処理され、混雑時は順番待ちになります。大きなプランでは写真と評価が揃うまで1分ほどかかります。
コネクタは無料で、コネクタ経由でお金が使われることはありません。Kokoの基本機能も無料です。アプリ内の Discover では一部のクリエイターがリストを App Store 課金で販売していますが、いずれの場合も支払い情報が私たちに渡ることはありません。通常アカウントの上限は利用規約をご覧ください。
Koko は少人数のチームが作る早期アクセス版です。スポット情報は第三者提供のため古い場合があります。重要な情報は出かける前に必ず確認してください。

接続を解除する

接続の解除は、お使いのアシスタント側のコネクタ設定から行います。アクセストークンは即座に無効になり、Koko はあなたに代わって送られるリクエストの受付を停止します。リストとプランは Koko アカウントに残ります。それらも削除したい場合は、FAQ のアカウント削除の項目からアカウントを削除してください。

サポート

すべてのメッセージに人間が目を通します。アシスタントに何を頼み、何が返ってきたかを添えて [email protected] までメールしてください。FAQ、プライバシーポリシー、利用規約もあわせてご覧ください。