接続

MCP · CLI

AI エージェントが回答を作る途中で、必要なときにユミの店舗データを呼び出して使います。確認済みの店舗情報で答えるので、存在しない店を作り出すことがありません。呼び出し回数も少なく済みます。

AIに1行貼るだけ

Claude、Cursor、Codex、GeminiなどのAIに貼り付けると、AIが接続を済ませてお店を探します。

https://heyyumi.ai/llms.txt を読んで HeyYumi を接続し、ソウル・乙支路の抹茶カフェを1軒探して。

  1. 1AIが案内文書を読み、ログインリンクを渡します。
  2. 2そのリンクからGoogleでログインするだけです。
  3. 3接続が終わると、AIがすぐにお店を探します。
ChatGPTChatGPTはプラグインから接続します

自分で設定するなら、使っているツールを選んでください

  1. 01

    プラグインを開く

    ChatGPT のウェブ版(chatgpt.com)かデスクトップアプリで、設定 → プラグインを開きます。アドレスバーに chatgpt.com/plugins と入力するか、サイドバーの「プラグイン」を押しても開けます。開発者モードは必要ありません。

  2. 02

    HeyYumi を検索

    プラグインの検索欄に heyyumi と入力します。「予約」や「グルメ」でも見つかりますが、heyyumi で探すのがいちばん早いです。一覧の HeyYumi を押して詳細画面を開きます。

  3. 03

    接続して Google でログイン

    「接続(Connect)」を押し、ログイン画面で Google にログインして承認すれば完了です。キーは自動で作成されます。「接続」が押せない場合は、料金プランや国、会社のワークスペース設定が原因かもしれません。

  4. 04

    呼び出して尋ねる

    新しい会話で「@HeyYumi」と呼び出すか、入力欄の + → その他から HeyYumi を選び、「HeyYumi で …」と尋ねるとユミが答えます。

CLI

Claude Code、Codex、Gemini CLI のようにターミナルで動くエージェントなら、CLI がいちばん手軽です。コマンドで店舗を探し、予約リクエストを送って、お店の返事を待てます。結果はすべて JSON で出力されます。

ログインして、探して、予約する

インストールは不要です。npx が最新版を取得して実行します。login を実行するとブラウザに Google のログイン画面が開き、承認すればログイン完了です。

terminal

# 最初に一度: Google でログイン
npx -y heyyumi login

# 店舗を探す
npx -y heyyumi search 抹茶 --business_category cafe --region Euljiro

# 予約リクエストを送ってお店の返事を待つ
npx -y heyyumi reserve <placeId> --time "YYYY-MM-DD 19:00" --party 2 --name Tanaka --phone 010-1234-5678
npx -y heyyumi wait <reservationId>

Node 18 以上が必要です。ログイン情報は ~/.config/heyyumi に保存され、自分のアカウントからしか読めません。

  1. 01

    ログイン

    npx -y heyyumi login を実行し、ブラウザで Google の承認を済ませればログイン完了です。

  2. 02

    検索

    search の後に料理名を書き、--region でエリアを指定します。エリアは韓国語(홍대)でも英語表記(Hongdae)でもかまいません。

  3. 03

    予約リクエスト

    reserve で送り、wait で待つと、たいてい 5 分以内に確定か辞退の返事が来ます。

GitHub で全コマンドを見る →

接続したらこう使います

エージェントは search_places か nearby_places で店舗を探し、get_place でメニューや営業時間を確認します。店主がアップロードした写真は show_place_photos で会話の中に表示します(画像を表示できる AI のみ)。予約は request_reservation で送り、wait_for_reservation で確定か辞退の返事を待ちます。「今どれくらい待ちますか?」のような質問は request_live_status で店主に尋ねると、5 分以内に返事が来ます。すべてのアカウントで毎月 50,000 トークンまで無料です。

大量利用はビジネスのお問い合わせへ →

REST の代わりに MCP を使う利点

01

エージェントがツールとして使える

AI は会話の中で短い呼び出しを何度も行います。MCP のツールとしてつないでおけば、間に挟むサーバーを別に作る必要がありません。

02

同じデータ、同じトークン

REST と同じトークンから消費されます。MCP の使用量は channel=mcp で分けて確認できます。

03

少ない呼び出しで答えられる

同じ店舗の重複を 1 つにまとめ、条件ごとに絞り込んであるので、エージェントは少ない呼び出しで答えを見つけられます。