BookingKoala by Cotlet

BookingKoala API とセルフホスト型 MCP サーバー

自分の Google Chrome のセッション上で、自分のコンピューターに Python で実行する BookingKoala API と BookingKoala MCP サーバーです。Cotlet の本番環境で稼働している BookingKoala ツール 18 個のうち 17 個を利用できます。予約、下書きと見積もり、顧客、プロバイダーとチーム、請求、請求書、ストアのダッシュボードに対応しています。

BookingKoala には公開 API も公式 MCP サーバーもありません。API キーで接続できるのは Zapier と Make だけで、新しいイベントに反応し、リードを 1 件書き戻せます。このリポジトリでは、次の両方を利用できます。

• Claude Code、Claude Desktop、Cursor、Codex など、あらゆる MCP クライアントに stdio または HTTP 経由で接続できる MCP サーバー。セットアップ
• http://127.0.0.1:8787/api/v1/bookingkoala の REST API。OpenAPI ドキュメントは /docs にあります。セットアップ
• Python：call("list_bookings", status="unassigned") と、すぐに使える 12 個のスクリプトを examples/ に用意しています。

これは、自分で実行したい技術者向けです。非営利目的でのみ利用できます（ライセンス）。サーバー上で 24 時間 365 日稼働させ、BookingKoala のアプリが変更されても動作する状態を保ち、チームやビジネスで利用したい場合は、cotlet.dev のホステッド版をご利用ください。

git clone https://github.com/cotletdev/bookingkoala-api-mcp-server.git && cd bookingkoala-api-mcp-server
python3 -m venv .venv && . .venv/bin/activate && pip install -e .
bookingkoala-mcp connect                           # reads your BookingKoala session from Chrome
bookingkoala-mcp call list_bookings status=upcoming
claude mcp add bookingkoala -- "$PWD/.venv/bin/bookingkoala-mcp" mcp

目次

• 仕組み
• 要件
• インストール
• Chrome の接続
• MCP サーバー
• REST API
• Python とサンプルスクリプト
• 17 個のツールすべて
• 設定
• セキュリティと BookingKoala アカウント
• エラー
• セルフホスト版とホステッド版
• よくある質問
• ライセンス

仕組み

AI agent (MCP) / script (REST, Python) ──▶ bookingkoala-mcp on your computer ──your session──▶ yourstore.bookingkoala.com
                                                  ▲
                    bookingkoala-mcp connect ─────┘ reads it once from your Chrome (DevTools Protocol)

1. いつもどおり、自分の Chrome で BookingKoala ストアの管理画面にサインインします。
2. bookingkoala-mcp connect を実行すると、Chrome DevTools Protocol を通じて Chrome に接続し、bookingkoala.com の Cookie とタイムゾーンを読み取り、~/.config/bookingkoala-api-mcp/session.json に保存します。このファイルを読み取れるのは自分のユーザーだけです。パスワードを確認したり保存したりすることはありません。
3. 各ツールの呼び出しは、ストアのウェブアプリ自体が yourstore.bookingkoala.com 上で呼び出す管理 API へのリクエストです。curl_cffi を使って、Chrome の TLS フィンガープリントを複製します。サーバーは、セッションのベアラートークンとリクエストごとに新しく生成するヘッダーを使い、アプリと同じ方法で各リクエストに署名します。ヘッドレスブラウザーは実行されません。

BookingKoala は、ストアのホストの IRON_GATEWAY_CTX Cookie にセッションを 30 日間保持します。サインアウトされた場合は、リモートデバッグを有効にした Chrome が開いていれば、サーバーは Chrome からセッションを再度読み取ります。

要件

• Python 3.11 以降。
• BookingKoala ストアの管理画面にサインインした Google Chrome 144 以降。Chrome または Chromium なら、デバッグポートを使って動作します。
• macOS、Linux、Windows。
• ストアの管理者アカウント。各ツールでできる操作は、BookingKoala のロールが管理画面で許可する範囲に限られます。権限の少ないスタッフロールでは、管理画面で拒否される操作と同じように拒否されます。

インストール

git clone https://github.com/cotletdev/bookingkoala-api-mcp-server.git
cd bookingkoala-api-mcp-server
python3 -m venv .venv
. .venv/bin/activate              # Windows: .venv\Scripts\activate
pip install -e .
bookingkoala-mcp --version

uv を使う場合：uv venv && uv pip install -e . を実行し、その後 uv run bookingkoala-mcp ... を実行します。

AI エージェント（Claude Code、Codex、Cursor）でセットアップしますか？このフォルダーを開き、リポジトリをセットアップするよう依頼してください。AGENTS.md にすべての手順が記載されています。Chrome で行う必要がある手順だけを案内します。

更新するには、git pull && pip install -e . を実行します。ホステッド版の BookingKoala ツールに加えられた変更はすべて、このリポジトリにも反映しています。

Chrome を接続する

オプション A：普段使っている Chrome（推奨）

1. Chrome で chrome://inspect/#remote-debugging を開き、リモートデバッグをオンにします。Chrome はこのコンピューター上のプログラムからの DevTools 接続を受け入れるようになり、接続ごとに確認を求めます。

2. https://yourstore.bookingkoala.com/admin でストア管理画面にサインインしていることを確認します。

3. 次を実行します。

   bookingkoala-mcp connect
   

4. Chrome が接続を許可するか尋ねます。許可をクリックします。

Saved 15 BookingKoala cookies to /Users/you/.config/bookingkoala-api-mcp/session.json
Signed in to BookingKoala as Dana Whitfield ([email protected]), sparkleclean

その後、リモートデバッグをオフに戻してもかまいません。BookingKoala からサインアウトされた後にサーバーが新しいセッションを自動的に取得するようにする場合は、オンのままにしてください。

connect は、既定のプロファイルフォルダー内にある Chrome の DevToolsActivePort ファイルを探します。Chrome Beta、Canary、またはカスタムのプロファイルフォルダーを使用する場合は、--profile-dir "<folder>" を渡してください。

オプション B：デバッグポートを使用する Chrome

Chrome は既定のプロファイルではデバッグポートを開かないため、別のプロファイルを起動して、そこで一度 BookingKoala にサインインしてから接続します。

# macOS
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-bookingkoala"
# Linux
google-chrome --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-bookingkoala"
# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%USERPROFILE%\.chrome-bookingkoala"

bookingkoala-mcp connect --cdp http://127.0.0.1:9222

--cdp には ws:// DevTools URL も指定できます。たとえば、SSH トンネル経由で接続した別のマシン上の Chrome の URL を指定できます。

オプション C：Cookie を手動で貼り付ける

Chrome がないサーバーの場合：Chrome でストア管理画面の DevTools を開き、Application > Cookies > https://yourstore.bookingkoala.com に移動して、IRON_GATEWAY_CTX の値をコピーし、次を実行します。

bookingkoala-mcp connect --token          # asks for your store name, then the value (hidden)
# or, without a session file:
export BOOKINGKOALA_STORE=yourstore BOOKINGKOALA_AUTH_TOKEN=...

貼り付けた Cookie は自動更新されません。BookingKoala からサインアウトされたとき、遅くとも 30 日後には新しい Cookie を貼り付けてください。この場合、「今日」と表示するツールでは、このコンピューターのタイムゾーンが使用されます。

セッションはいつでも確認できます。

bookingkoala-mcp status

MCP サーバー

MCP サーバーには、各ツールとその入力スキーマ、エージェント向けの説明、ヒントが一覧表示されます。読み取りツールには読み取り専用のマークが付いています。顧客へのメール送信、プロバイダーへの通知、キャンセルを行うツールにはその旨のマークが付いており、実行前にクライアントが確認を求めます。

Claude Code

claude mcp add bookingkoala -- /path/to/bookingkoala-api-mcp-server/.venv/bin/bookingkoala-mcp mcp
# read only:
claude mcp add bookingkoala -- /path/to/bookingkoala-api-mcp-server/.venv/bin/bookingkoala-mcp mcp --read-only

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "bookingkoala": {
      "command": "/path/to/bookingkoala-api-mcp-server/.venv/bin/bookingkoala-mcp",
      "args": ["mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json。Claude Desktop と同じブロックを使用します。すぐに使えるコピーは mcp.json にあります。

Codex

~/.codex/config.toml：

[mcp_servers.bookingkoala]
command = "/path/to/bookingkoala-api-mcp-server/.venv/bin/bookingkoala-mcp"
args = ["mcp"]

HTTP 経由

bookingkoala-mcp serve を実行すると、URL を受け取るクライアント向けに、ストリーミング可能な HTTP 経由でも http://127.0.0.1:8787/mcp で MCP を提供します。

bookingkoala-mcp serve
claude mcp add --transport http bookingkoala http://127.0.0.1:8787/mcp

その後、エージェントに次のようなことを依頼できます。

今週の未割り当てフォルダーを確認してください。各仕事を、その日に予約が最も少ない空きプロバイダーに割り当て、引き受けられる人がいない仕事を教えてください。

木曜日は嵐の日です。木曜日の予約をすべて次回の訪問日に変更して、顧客とプロバイダーにメールしてください。

支払期限を 7 日以上過ぎた請求書はどれですか？各顧客に請求書を再送してください。

11 月 1 日から 15 日までの売上とプロバイダーへの支払額はいくらでしたか？

REST API

bookingkoala-mcp serve             # http://127.0.0.1:8787, MCP at /mcp, docs at /docs

各ツールには /api/v1/bookingkoala 以下に個別のルートがあり、cotlet.dev のホスト型 API と同じパスを使用するため、一方を対象に書いたコードをもう一方でも使用できます。パスの各部分とクエリ文字列が引数になり、JSON ボディで残りの引数を指定します。

curl 'http://127.0.0.1:8787/api/v1/bookingkoala/bookings?status=unassigned&start_date=2026-11-16&end_date=2026-11-20'
curl 'http://127.0.0.1:8787/api/v1/bookingkoala/bookings/212'
curl -X POST http://127.0.0.1:8787/api/v1/bookingkoala/bookings/212/assign \
  -H 'Content-Type: application/json' \
  -d '{"provider_id": 3}'

名前で任意のツールを指定し、ボディをその引数として渡します。

curl -X POST http://127.0.0.1:8787/api/v1/bookingkoala/tools/list_customers -d '{"search": "whitfield"}'

• GET /api/v1/bookingkoala/tools：ルート、入力スキーマ、回答例を含むすべてのツール。
• GET /docs：操作可能な OpenAPI ドキュメント。GET /openapi.json：n8n、Postman、または生成したクライアント向けのスキーマ。
• 回答は JSON 形式です。リストには next_cursor が返されます。次のページを取得するには、これを cursor として渡してください。

サーバーは 127.0.0.1 のみでリッスンします。別のデバイスからアクセスするには、トークンを設定してください。設定後は、すべてのリクエストに Authorization: Bearer <token> が必要になります。

BOOKINGKOALA_MCP_TOKEN=$(openssl rand -hex 24) bookingkoala-mcp serve --host 0.0.0.0

Python とサンプルスクリプト

Python から直接実行でき、サーバーは不要です。

from bookingkoala_api_mcp import call
from bookingkoala_api_mcp.scripting import paginate, write_rows

totals = call("dashboard", start_date="2026-11-01", end_date="2026-11-15")
bookings = list(paginate("list_bookings", {"status": "completed", "start_date": "2026-11-01"}, "bookings"))
write_rows(bookings, "completed.csv")
call("assign_provider", booking_id=212, provider_id=3)

または、シェルから bookingkoala-mcp call list_customers search=whitfield のように単一のツールを実行するか、JSON オブジェクトを指定します。

すぐに使えるスクリプトは examples/ にあります。各スクリプトは JSON を出力し、用途に応じて --out file.csv または --out file.json を指定できます。また、--help も利用できます。

スクリプト	内容
list_bookings.py	ステータスと日付範囲で予約を一覧表示します。日付、到着時刻、顧客、住所、サービス提供者、合計金額が含まれます。
export_customers.py	顧客情報を CSV または JSON に出力します。氏名、メールアドレス、電話番号、タグ、メモが含まれます。
store_dashboard.py	日付範囲内の店舗合計を表示します。売上、サービス提供者への支払い、予約、評価、紹介が含まれます。
assign_unassigned.py	未割り当ての各依頼を、その日に担当件数が最も少ないサービス提供者に割り当てます。--assign を指定しない場合は、計画を表示します。
assign_provider.py	1件の予約、またはその繰り返しスケジュール全体を、サービス提供者またはチームに割り当てます。
reschedule_day.py	休業日の繰り返し訪問を、次回の訪問日に移動します。まず計画を確認し、実行するには --move を指定します。
cancel_booking.py	確認後、手数料なしで1件の予約、またはその後のスケジュール全体をキャンセルします。
rebook_customer.py	リピーターの前回の訪問内容を下書きにコピーします。--send-quote を指定すると、保存済みの見積もりをメールで送信します。
send_quote.py	保存済みの下書きと見積もりを一覧表示するか、予約用リンクを添えて見積もりをメールで送信します。
add_customer.py	メールアドレスがまだ店舗に登録されていないことを確認してから、顧客を追加します。
provider_pay_report.py	支払い期間のサービス提供者への支払い合計を表示し、その後、各サービス提供者の支払い履歴を表示します。
overdue_invoices.py	支払期限を過ぎた未払いの請求書を表示します。--remind を指定すると、各請求書を顧客に再送します。

python examples/assign_unassigned.py --from 2026-11-16 --to 2026-11-20
python examples/overdue_invoices.py --days 7 --out overdue.csv

スケジュール実行には、コンピューターの電源が入っている間は、ローカルの cron を使えます。例：0 7 * * 1-5 cd ~/bookingkoala-api-mcp-server && .venv/bin/python examples/list_bookings.py --status today。

17 個すべてのツール

ID はツール一覧から取得します。list_bookings の booking_id、list_customers の customer_id、list_providers の provider_id、list_drafts の draft_id、list_invoices の invoice_id です。bookingkoala-mcp tools を実行すると一覧が表示され、bookingkoala-mcp tools --json を実行すると入力スキーマも表示されます。

予約

ツール	アクセス	REST ルート	内容
list_bookings	読み取り	GET /bookings	店舗の予約を一覧表示します。今後の予約、未割り当て、完了済み、請求保留中、または拒否された予約が含まれます。
get_booking	読み取り	GET /bookings/{booking_id}	価格の内訳、サービス提供者への支払い、メモ、サービスを含む1件の予約を取得します。
create_booking	書き込み	POST /bookings	既存の予約をコピーして、新しい予約を作成します。顧客、サービス、価格は同じです。
assign_provider	書き込み	POST /bookings/{booking_id}/assign	サービス提供者またはチームを、予約またはその繰り返しスケジュール全体に割り当てます。
reschedule_booking	書き込み	POST /bookings/{booking_id}/reschedule	繰り返し予約の訪問を、スケジュール内の後続の訪問日まで延期します。
cancel_booking	書き込み	POST /bookings/{booking_id}/cancel	キャンセル料なしで、1件の予約または繰り返しスケジュール全体をキャンセルします。

下書きと見積もり

ツール	アクセス	REST ルート	内容
list_drafts	読み取り	GET /drafts	店舗に保存されていて、まだ予約されていない予約の下書きと見積もりを一覧表示します。
send_quote	書き込み	POST /quotes/{draft_id}/send	予約用リンクを添えて、保存済みの見積もりを顧客にメールで送信します。

顧客

ツール	アクセス	REST ルート	機能
list_customers	読み取り	GET /customers	ストアの顧客をメールアドレスと電話番号とともに一覧表示します。名前、メールアドレス、電話番号で検索できます。
get_customer	読み取り	GET /customers/{customer_id}	1 人の顧客の連絡先情報、住所、予約件数、未請求の予約を取得します。
create_customer	書き込み	POST /customers	ストアに新しい顧客を登録します。BookingKoala はパスワード設定用の招待メールを送信します。

プロバイダーとチーム

ツール	アクセス	REST ルート	機能
list_providers	読み取り	GET /providers	ストアのプロバイダー（清掃員、技術者）とチームを優先順位順に一覧表示します。
get_provider	読み取り	GET /providers/{provider_id}	1 人のプロバイダーまたはチームの連絡先、カテゴリー、チームメンバー、レビュー、支払いログを取得します。

請求、請求書、レポート

ツール	アクセス	REST ルート	機能
list_charges	読み取り	GET /charges	Charges ページに表示される内容に沿って、請求済みの予約とその支払いおよび返金を一覧表示します。
list_invoices	読み取り	GET /invoices	ストアまたは特定の顧客の請求書を、支払い状況、合計金額、未払い額とともに一覧表示します。
resend_invoice	書き込み	POST /invoices/{invoice_id}/resend	請求書をメール、テキスト、またはその両方で顧客に再送信します。
dashboard	読み取り	GET /dashboard	期間を指定して、ストアの売上、プロバイダーへの支払い、予約、評価、紹介の合計を取得します。

意図的に実装していない機能：BookingKoala へのサインイン、パスワードとプロフィール、ご自身の BookingKoala プランと請求、および資金を移動するその他すべての機能です。すべてのリクエストはガードを通過し、これらの BookingKoala パスへのアクセスは拒否されます。

このバージョンに含まれない機能

ツール	理由
refund_charge	顧客のカードに返金します。ホスト版では利用できますが、呼び出しごとに承認が必要です。このバージョンでは、Charges のパネルで返金してください。

設定

変数	デフォルト	機能
BOOKINGKOALA_MCP_HOME	~/.config/bookingkoala-api-mcp	session.json の保存フォルダーです。
BOOKINGKOALA_AUTH_TOKEN		bookingkoala-mcp connect の代わりに使用する、IRON_GATEWAY_CTX Cookie の値です。BOOKINGKOALA_STORE が必要です。
BOOKINGKOALA_STORE		ストア名です。yourstore.bookingkoala.com の場合は yourstore を指定します。
BOOKINGKOALA_PROXY		BookingKoala へのすべてのリクエストに使用するプロキシです。例：http://user:pass@host:port
BOOKINGKOALA_MCP_READ_ONLY		1 を指定すると、BookingKoala を変更するすべてのツールを非表示にし、実行を拒否します（--read-only と同じです）。
BOOKINGKOALA_MCP_TOKEN		serve で必要となるベアラートークンです。127.0.0.1 以外で待ち受ける場合に必要です。
BOOKINGKOALA_MCP_HOST、BOOKINGKOALA_MCP_PORT	127.0.0.1、8787	serve のアドレスです。

セキュリティと BookingKoala アカウント

• パスワードがこのコードに渡ることはありません。 読み取るのは Cookie のみで、対象は bookingkoala.com のものに限られます。
• セッションファイルはご自身で管理してください。 session.json はモード 0600 で作成されます。このファイルを持つ人は誰でも、ストアの管理者として操作できるため、git や共有フォルダーに置かないでください。
• デフォルトではローカルで動作します。 serve は 127.0.0.1 にバインドし、BOOKINGKOALA_MCP_TOKEN がない場合は別のアドレスを拒否します。
• bookingkoala.com のみが対象です。 bookingkoala.com 外へのリクエストやリダイレクトは拒否されます。
• 読み取り専用モード。 --read-only または BOOKINGKOALA_MCP_READ_ONLY=1 を指定すると、読み取りツール 10 個のみが公開されます。
• 操作は実際の人に影響します。 割り当てるとプロバイダーに通知されます。見積もりと請求書は顧客に送信され、新規顧客には招待メールが届きます。また、キャンセルや再スケジュール時に notify を指定すると、双方にメールが送信されます。MCP クライアントは実行前に確認を求めますが、スクリプトは確認しません。そのため、まずテスト用の予約で試してください。
• ストアで実行される操作の責任はご自身にあります。 BookingKoala の通常の利用範囲を守ってください。

エラー

REST API は {"error": "<code>", "message": "..."} を返します。MCP サーバーは、同じコードとメッセージをツールエラーとして返します。

ステータス	コード	対処方法
401	auth_required, auth_expired	セッションがないか、BookingKoala からサインアウトされています。Chrome でストアの管理画面にサインインし、bookingkoala-mcp connect を実行してください。
403	app_permission_denied	BookingKoala のロールではこの操作を実行できません。
403	scope_denied	サーバーが読み取り専用で実行されているか、リクエストがサインインまたは請求に関わる操作を行おうとしています。
403	target_blocked	BookingKoala がリクエストを拒否したか、ボットチェックを表示しました。Chrome でストアの管理画面を一度開いてから、再試行してください。
409	captcha_required	BookingKoala が CAPTCHA を要求しています。Chrome で解決してください。
422	invalid_input	引数が不足しているか、正しくありません。メッセージに該当する引数が示されます。
429	rate_limited	BookingKoala がアカウントの利用を制限しています。数分待ってください。
502	target_error	BookingKoala がエラーを返したか、アプリが変更されました。メッセージには BookingKoala 独自の理由が記載されます。最新のツールを取得するには git pull を実行するか、issue を作成してください。

セルフホスト版またはホスト版

	このリポジトリ	Cotlet、ホスト版
ツール	17	18（refund_charge を含む）
実行場所	コンピューターの電源が入っている間は、コンピューター上	クラウド上、24 時間 365 日
BookingKoala セッション	Chrome の Cookie をローカルファイルに保存	EU 内の専用 Cloud Browser。プロファイルは AES-256-GCM で暗号化
BookingKoala のアプリ変更時	修正後に git pull	こちらで修正し、すべてのツールを毎日テスト
承認	MCP クライアントが呼び出しごとに確認	割り当て、見積もり、請求書、返金は承認待ちになり、ツールごとに切り替え可能
対応サービス	お使いのマシン上の MCP クライアント、ローカルスクリプト	Claude.ai と ChatGPT のコネクター、n8n、Make、Zapier、任意の HTTP クライアント
利用対象	非営利目的での個人利用	チーム、企業、代理店
価格	無料	クレジット 2,000 件の 7 日間無料トライアル（カード不要）。その後は 5,000 クレジットで 29 ドルからの買い切りパック

ホスト版では、成功した呼び出しは 20～30 クレジット（ほとんどのツールでは 25 クレジット）を使用し、失敗した呼び出しは無料です。また、Cloud Browser でエージェント向けアプリを有効にしている間は、1 日あたり 50 クレジットを使用します。料金の詳細。

よくある質問

BookingKoala に公式 API はありますか？ 一般公開されているものはありません。BookingKoala は REST API のドキュメントを公開していません。「Settings > General > Apps & Integrations」にある API キーは、Zapier と Make への接続にのみ使われます。新規または更新された予約、顧客、プロバイダー、見積もり、評価、請求書に関するトリガーと、「Create Lead」という 1 つのアクションが利用できます。過去の予約の検索、プロバイダーの割り当て、スケジュール変更、キャンセル、請求書の再送信はできません。詳細はこちらをご覧ください：cotlet.dev/integrations/bookingkoala-api-mcp-server。

Claude、ChatGPT、Cursor 用の BookingKoala MCP サーバーはありますか？ はい。このサーバーはお使いのマシン上で動作します。Claude Code、Claude Desktop、Cursor、Codex では bookingkoala-mcp mcp を実行してください。ChatGPT と Claude.ai のコネクターには、公開 HTTPS URL が必要です。ホスト型 BookingKoala MCP サーバーを使えば、その URL を利用できます。

Zapier や BookingKoala API キーは必要ですか？ いいえ。ツールは、ブラウザーで使用しているものと同じ、サインイン済みの管理者セッションを使用します。

BookingKoala の予約や顧客を CSV にエクスポートできますか？ はい。すべてのページを対象に、python examples/list_bookings.py --status all --out bookings.csv と python examples/export_customers.py --out customers.csv を実行してください。

プロバイダーを自動的に割り当てられますか？ examples/assign_unassigned.py は、最初に割り当て計画を表示したうえで、その日の担当件数が最も少ないプロバイダーに未割り当てのジョブを割り当てます。BookingKoala は、その時間に対応可能でないプロバイダーへの割り当てを拒否します。そのようなジョブはスクリプトに一覧表示されます。

Chrome が必要なのはなぜですか？ パスワードを使わずに BookingKoala のセッションを読み取るためです。Chrome を使うのはサインイン時に一度だけで、呼び出しごとに使うわけではありません。

BookingKoala からサインアウトされた場合はどうなりますか？ 呼び出しは auth_expired で失敗します。Chrome のリモートデバッグが有効になっている場合、次回の呼び出し時にサーバーが新しいセッションを読み取ります（Chrome から確認されたら「Allow」をクリックしてください）。それ以外の場合は、再度 bookingkoala-mcp connect を実行してください。

VPS や Docker で実行できますか？ 技術的には可能です。その場合は BOOKINGKOALA_STORE と BOOKINGKOALA_AUTH_TOKEN を設定します。すると BookingKoala には、データセンターの IP アドレスからセッションにアクセスしているように見えます。常時稼働させる場合は、ホスト型バージョンを使うと、固定 IP のご自身の Cloud Browser 内でセッションを保持できます。

清掃業で使用できますか？ いいえ。このライセンスでは非商用利用のみが許可されており、店舗の運営は業務利用にあたります。会社で使用する場合は、Cotlet をご利用いただくか、[email protected] までお問い合わせください。

オープンソースですか？ ソースコードは公開されていますが、ライセンスはオープンソースライセンスではありません。非商用利用のみで、業務利用はできません。

ツールが動作しない場合や、別のツールが必要な場合はどうすればよいですか？ Issue を作成し、ツール名とエラーメッセージをお知らせください。

ライセンス

PolyForm Noncommercial License 1.0.0。概要は次のとおりです。

• 許可される利用： 非商用利用。ご自身の BookingKoala アカウントを使った個人的な目的での利用、または慈善団体、学校、公的研究機関、政府機関による利用。コードの変更、および同じライセンスでの共有。
• 許可されない利用： ご自身の事業を含むあらゆる商用利用、クライアント向けの業務、販売や提供、および本ソフトウェアを基にしたサービスの販売や提供。

---

Cotlet（@cotletdev）が保守しています。BookingKoala はその所有者の商標です。このプロジェクトは非公式であり、BookingKoala との提携、承認、支援を受けていません。