Hubungkan MCP Termilo
Hubungkan Claude ke bisnis Anda lewat connector, atau hubungkan agen AI lain dengan API key. Keduanya memakai MCP Streamable HTTP.
Hubungkan Termilo ke Claude#
Connector Termilo membiarkan Claude membaca dan, bila Anda izinkan, mengubah booking, layanan, pelanggan, dan pengaturan bisnis Anda. Anda masuk dengan akun Termilo. Tidak perlu API key.
Langkah sambung#
- Di Claude, buka Settings, lalu Connectors.
- Pilih Add custom connector.
- Tempel
https://api.termilo.id/mcp. - Pilih Connect.
- Masuk ke Termilo.
- Pilih bisnis yang ingin Anda hubungkan.
- Pilih Izinkan (Allow).
Satu koneksi berlaku untuk satu bisnis. Untuk bisnis lain, tambahkan connector lagi dan pilih bisnis itu.
Tingkat akses#
Claude melihat booking, ketersediaan, layanan, pelanggan, dan pengaturan. Claude tidak mengubah apa pun. Semua anggota tim bisa memberi akses ini.
Claude juga membuat, mengubah, dan membatalkan booking serta mengubah pengaturan. Hanya owner dan admin yang bisa memberi akses ini. Staf selalu mendapat akses baca saja. Anda bisa mencentang atau tidak mencentang akses ubah di layar izin.
Daftar tool#
Claude hanya memakai tool saat Anda memintanya. Tanda mengubah data yang ada berarti tool itu dapat menimpa atau membatalkan data. Claude meminta konfirmasi Anda sebelum menjalankannya.
Booking
- Get booking links
get_booking_linksbaca - Preview availability
preview_availabilitybaca - List bookings
list_bookingsbaca - Get booking
get_bookingbaca - Create booking
create_bookingubah - Reschedule booking
reschedule_bookingubahmengubah data yang ada - Cancel booking
cancel_bookingubahmengubah data yang ada - Get dashboard summary
get_dashboard_summarybaca - Search bookings
search_bookingsbaca - Confirm booking
confirm_bookingubahmengubah data yang ada - Complete booking
complete_bookingubahmengubah data yang ada - Mark booking no-show
mark_booking_no_showubahmengubah data yang ada - Cancel bookings in bulk
bulk_cancel_bookingsubahmengubah data yang ada - Update booking status in bulk
bulk_update_booking_statusubahmengubah data yang ada - Reschedule bookings in bulk
bulk_reschedule_bookingsubahmengubah data yang ada - Get availability calendar
get_availability_calendarbaca
Layanan
- Get service
get_servicebaca - Create service
create_serviceubah - Update service
update_serviceubahmengubah data yang ada - Archive service
archive_serviceubahmengubah data yang ada - List services
list_servicesbaca - Get service deposit policy
get_service_deposit_policybaca - Update service deposit policy
update_service_deposit_policyubahmengubah data yang ada - Get service location policy
get_service_location_policybaca - Update service location policy
update_service_location_policyubahmengubah data yang ada - List service categories
list_service_categoriesbaca - Update service status in bulk
bulk_update_service_statusubahmengubah data yang ada
Tampilan halaman booking
- Get branding
get_brandingbaca - Update branding
update_brandingubahmengubah data yang ada
Pembayaran
- Get payment account
get_payment_accountbaca
Webhook
- List webhooks
list_webhooksbaca - Create webhook
create_webhookubah - Rotate webhook secret
rotate_webhook_secretubahmengubah data yang ada - Disable webhook
disable_webhookubahmengubah data yang ada - Send test webhook
send_test_webhookubah - List webhook deliveries
list_webhook_deliveriesbaca
Tenant
- Get account
get_accountbaca - List staff
list_staffbaca - Create staff
create_staffubah - Update staff
update_staffubahmengubah data yang ada - List resources
list_resourcesbaca - Create resource
create_resourceubah - Update resource
update_resourceubahmengubah data yang ada - List availability rules
list_availability_rulesbaca - Create availability rule
create_availability_ruleubah - Update availability rule
update_availability_ruleubahmengubah data yang ada - List blocked times
list_blocked_timesbaca - Create blocked time
create_blocked_timeubah - Update blocked time
update_blocked_timeubahmengubah data yang ada - List holidays
list_holidaysbaca - Create holiday
create_holidayubah - Update holiday
update_holidayubahmengubah data yang ada - Get holiday settings
get_holiday_settingsbaca - Update holiday settings
update_holiday_settingsubahmengubah data yang ada - Get business profile
get_business_profilebaca - Update business profile
update_business_profileubahmengubah data yang ada - Get booking policy
get_booking_policybaca - Update booking policy
update_booking_policyubahmengubah data yang ada - Get embed code
get_embed_codebaca - List message templates
list_message_templatesbaca - Get message template
get_message_templatebaca - Create message template
create_message_templateubah - Update message template
update_message_templateubahmengubah data yang ada - Delete message template
delete_message_templateubahmengubah data yang ada - Get notification settings
get_notification_settingsbaca - Update notification settings
update_notification_settingsubahmengubah data yang ada - List notification log
list_notification_logbaca - List team members
list_team_membersbaca - Invite team member
invite_team_memberubah - Resend team invitation
resend_team_invitationubahmengubah data yang ada - Revoke team invitation
revoke_team_invitationubahmengubah data yang ada - Update team member
update_team_memberubahmengubah data yang ada - Get billing status
get_billing_statusbaca - List integrations
list_integrationsbaca
Pelanggan
- List customers
list_customersbaca - Get customer
get_customerbaca - Create customer
create_customerubah - Update customer
update_customerubahmengubah data yang ada
Contoh perintah#
Bahasa Indonesia
- Tampilkan booking minggu ini.
- Batalkan semua booking hari Sabtu karena libur.
- Ubah warna utama halaman booking jadi hijau.
English
- Show this week's bookings.
- Cancel all bookings on Saturday because we are closed.
- Change the main color of my booking page to green.
Variabel template pesan#
Tulis variabel dalam kurung ganda, misalnya {{customer.name}}, di isi template WhatsApp atau email. Termilo mengganti variabel dengan data booking saat pesan dikirim. Variabel yang kosong tidak tampil.
{{customer.name}}: Nama pelanggan.{{customer.email}}: Email pelanggan.{{customer.phone}}: Nomor telepon pelanggan.{{customer.contact}}: Telepon dan email pelanggan dalam satu baris.{{service.name}}: Nama layanan.{{staff.name}}: Nama staf yang menangani booking.{{booking.date}}: Tanggal mulai, dalam zona waktu booking.{{booking.time}}: Jam mulai, dalam zona waktu booking.{{booking.startsAt}}: Tanggal dan jam mulai.{{booking.endsAt}}: Tanggal dan jam selesai.{{booking.durationMin}}: Durasi dalam menit.{{booking.timezone}}: Zona waktu booking.{{booking.status}}: Status booking.{{booking.answers}}: Jawaban pelanggan pada formulir booking, satu baris per jawaban.{{dashboard.url}}: Tautan ke daftar booking di dashboard. Hanya terisi pada pesan untuk pemilik bisnis.
Cabut akses#
- Buka Dashboard → API keys, lalu bagian Aplikasi terhubung. Pilih Cabut akses. Owner dan admin dapat melakukannya.
- Atau hapus connector Termilo di Claude (Settings → Connectors).
Setelah dicabut, Claude langsung berhenti bisa membaca atau mengubah data bisnis Anda.
Keamanan connector#
- Anda masuk lewat halaman Termilo. Claude tidak pernah melihat kata sandi Anda.
- Access token berlaku 1 jam. Refresh token berlaku 30 hari dan diganti setiap dipakai.
- Token disimpan di Termilo hanya dalam bentuk hash.
- Termilo tidak membaca percakapan Claude. Termilo hanya menerima panggilan tool dan isinya.
- Satu koneksi hanya menjangkau satu bisnis.
- Pertanyaan keamanan: privasi@termilo.id. Lihat juga Kebijakan Privasi.
Untuk partner: API key#
Bagian berikut untuk partner dan developer yang menghubungkan agen AI sendiri dengan API key. Pengguna Claude.ai cukup memakai connector di atas.
https://api.termilo.id/mcp/<TENANT_ID> dengan header Authorization: Bearer <TERMILO_API_KEY>. Jangan tambahkan /v1 atau memakai slug tenant sebagai pengganti tenant ID.Prasyarat#
- Buka Dashboard → API keys, buat key dengan scope Booking · baca untuk link booking atau Branding MCP untuk tampilan, lalu salin secret yang hanya ditampilkan sekali.
- Ambil tenant ID dari config booking publik. Ganti tenant slug dengan bagian terakhir URL booking Anda.
- Simpan key di secret manager atau environment variable client.
Dukungan client#
Client yang menerima static HTTP header dapat dipakai sekarang. UI yang hanya menerima OAuth connector harus menunggu OAuth MCP Termilo.
| Client | Jalur koneksi | Status |
|---|---|---|
| OpenClaw | Remote MCP + static header | Didukung |
| Hermes Agent | mcp_servers + environment header | Didukung |
| Claude Code | HTTP MCP + static header | Didukung |
| OpenAI Responses API | Remote MCP + authorization | Didukung |
| ChatGPT UI | Membutuhkan OAuth discovery | Menunggu OAuth |
| Claude.ai / Desktop connector | OAuth, tanpa API key (lihat bagian Hubungkan ke Claude) | Didukung |
Tool tenant#
get_booking_linksbookings:readread · risiko lowList active services and their direct public booking links.
- Input:
- No input.
- Output:
- Active service slug, name, duration, public-safe location, and direct booking URL.
- Contoh:
- {}
get_serviceservices:readread · risiko lowRead one service configuration by id or slug, including location policy and booking link.
- Input:
- serviceId or serviceSlug (exactly one).
- Output:
- Slug, name, duration, buffers, status, staff ids, location policy, and direct booking URL.
- Contoh:
- {"serviceSlug":"onboarding-konektor"}
preview_availabilitybookings:readread · risiko lowPreview bookable slots for one service before sharing its booking link.
- Input:
- serviceSlug plus days (1-60, default 14), fromMs alone, fromMs with days, or fromMs with toMs. The window starts at fromMs, or now.
- Output:
- Service timezone, resolved window, slot count, and the first slots with start and end instants.
- Contoh:
- {"serviceSlug":"onboarding-konektor","days":14}
create_serviceservices:writewrite · risiko mediumCreate one bookable service with its location policy. Requires an idempotency key.
- Input:
- idempotencyKey, slug, name, durationMin, optional buffers/description/status, optional priceAmount (whole currency units, for example 250000 for Rp250,000), priceCurrency (default IDR), minNoticeMin, location, and optional dryRun.
- Output:
- serviceId, slug, status, price, booking URL, public-safe location, and idempotentReplay.
- Contoh:
- {"idempotencyKey":"konektor-onboarding-v1","slug":"onboarding-konektor","name":"Onboarding Konektor","durationMin":45,"location":{"locationType":"online_meeting","provider":"google_calendar"}}
update_serviceservices:writewrite · risiko mediumUpdate one existing service and optionally replace its location policy.
- Input:
- serviceId plus at least one changed field (including priceAmount, priceCurrency, minNoticeMin), optional location, and optional dryRun. Fields you leave out keep their stored value.
- Output:
- Updated serviceId, slug, status, price, booking URL, and public-safe location.
- Contoh:
- {"serviceId":"svc_01H","durationMin":60,"dryRun":true}
archive_serviceservices:writewrite · risiko highArchive one service by setting status to disabled. Recoverable through update_service.
- Input:
- serviceId and optional dryRun.
- Output:
- serviceId, status disabled, and the previous status for recovery.
- Contoh:
- {"serviceId":"svc_01H"}
list_bookingsbookings:readread · risiko lowList bookings for this tenant, optionally filtered by status and time window.
- Input:
- Optional status, fromMs, toMs, and limit up to 100.
- Output:
- Booking id, status, service, window, timezone, and contact-light customer summary.
- Contoh:
- {"status":"confirmed","limit":20}
get_bookingbookings:readread · risiko lowRead one booking including its meeting or offline location status.
- Input:
- bookingId.
- Output:
- Booking lifecycle fields plus meeting state: pending, ready with join URL, or not applicable.
- Contoh:
- {"bookingId":"bkg_01H"}
create_bookingbookings:writewrite · risiko mediumCreate one booking on behalf of a customer. Reuses a stored customer with the same email or phone. Requires an idempotency key.
- Input:
- idempotencyKey, serviceSlug, startsAtMs, either customerId or customer (name plus email or phone), and optional dryRun.
- Output:
- bookingId, status, window, manage URL when issued, and idempotentReplay.
- Contoh:
- {"idempotencyKey":"support-case-4821","serviceSlug":"support-konektor","startsAtMs":1800000000000,"customer":{"name":"Rani","primaryEmail":"rani@example.com"}}
reschedule_bookingbookings:writewrite · risiko mediumMove one booking to a new start instant, re-checking availability and locks.
- Input:
- bookingId, startsAtMs, and optional dryRun.
- Output:
- Updated booking status and window.
- Contoh:
- {"bookingId":"bkg_01H","startsAtMs":1800003600000}
cancel_bookingbookings:writewrite · risiko highCancel one booking with an optional reason.
- Input:
- bookingId, optional reason, and optional dryRun.
- Output:
- Cancelled booking status and cancellation instant.
- Contoh:
- {"bookingId":"bkg_01H","reason":"Customer requested"}
get_brandingbranding:readread · risiko lowRead the effective Termilo branding for this tenant.
- Input:
- No input.
- Output:
- Effective validated branding tokens and the tenant booking URL.
- Contoh:
- {}
update_brandingbranding:writewrite · risiko mediumUpdate validated Termilo branding tokens for this tenant.
- Input:
- One or more validated branding fields such as brandName, logoUrl, or primaryHex.
- Output:
- Updated effective branding tokens; arbitrary CSS, HTML, and JavaScript are rejected.
- Contoh:
- {"primaryHex":"#0E766E"}
get_payment_accountpayments:readread · risiko lowRead the booking-payment account status for this tenant without any KYC values.
- Input:
- No input.
- Output:
- Account status, business name, account type, review note, and readiness flags only; KYC values and documents are never returned.
- Contoh:
- {}
list_webhookswebhooks:readread · risiko lowList outbound webhook subscriptions without their signing secrets.
- Input:
- No input.
- Output:
- Subscription id, URL, event filter, status, and timestamps. Secrets are never returned.
- Contoh:
- {}
create_webhookwebhooks:writewrite · risiko highCreate one outbound webhook subscription. The signing secret is returned once and never again. Payload format and signature check: https://termilo.id/docs/webhooks.
- Input:
- HTTPS url, optional eventFilter and description, optional status, and optional dryRun.
- Output:
- Subscription metadata plus the write-only signing secret shown exactly once on create.
- Contoh:
- {"url":"https://hooks.konektor.id/termilo","eventFilter":["booking.created","booking.cancelled"]}
rotate_webhook_secretwebhooks:writewrite · risiko highIssue a new signing secret for one webhook subscription and invalidate the old one.
- Input:
- webhookId and optional dryRun.
- Output:
- Subscription metadata plus the new write-only signing secret shown exactly once.
- Contoh:
- {"webhookId":"whsub_01H"}
disable_webhookwebhooks:writewrite · risiko highDisable one webhook subscription so it stops receiving deliveries. Recoverable.
- Input:
- webhookId and optional dryRun.
- Output:
- Subscription metadata with status disabled and the previous status for recovery.
- Contoh:
- {"webhookId":"whsub_01H"}
send_test_webhookwebhooks:writewrite · risiko mediumEnqueue one signed test delivery to a webhook subscription without touching booking data.
- Input:
- webhookId and optional dryRun.
- Output:
- Queued delivery id and event id to correlate with list_webhook_deliveries.
- Contoh:
- {"webhookId":"whsub_01H"}
list_webhook_deliverieswebhooks:readread · risiko lowRead webhook delivery diagnostics: status, attempts, retry reason, and next retry instant.
- Input:
- Optional webhookId, status, limit up to 100, and offset.
- Output:
- Delivery id, event id, event type, status, attemptCount, errorClass, nextRetryAtMs, and target URL. No secrets or request bodies.
- Contoh:
- {"status":"failed","limit":20}
Field yang dapat diubah: brandName, logoUrl, primaryHex, accentHex, backgroundHex, surfaceHex, textHex, shape, font, template, dan poweredBy.
OpenClaw#
OpenClaw 2026.7.1-2 menerima header CLI dalam formatKEY=VALUE. Simpan key di~/.openclaw/.env; server definition dan template header tetap disimpan di config lokal. Kedua file wajib mode0600 dan hanya boleh ada di perangkat tepercaya.
Rujukan: OpenClaw MCP CLI dan environment loading.
Hermes Agent#
Hermes dapat membaca header dari environment variable saat runtime. Simpan key di ~/.hermes/.env, lalu tambahkan server HTTP di config.
Jalankan /reload-mcp di Hermes atau restart agent. Tool tampil dengan prefix mcp_termilo_.
Rujukan: Hermes Agent MCP.
ChatGPT dan OpenAI#
Set TERMILO_MCP_URL ke endpoint tenant danTERMILO_MCP_API_KEY ke secret. Ganti placeholder model dengan model yang mendukung remote MCP. Approval selalu diaktifkan agar update branding tidak berjalan diam-diam.
Rujukan: OpenAI remote MCP tools dan koneksi MCP ke ChatGPT.
Claude#
Claude Code mendukung HTTP MCP dengan custom header dan ekspansi environment variable. Simpan contoh berikut sebagai .mcp.json, export kedua variable sebelum membuka Claude Code, lalu jalankan /mcp untuk memeriksa status.
Rujukan: Claude Code MCP dan Claude custom connectors.
Uji koneksi#
Mulai dengan read-only prompt:
Lalu uji update dengan review eksplisit:
Setelah update, buka halaman booking Anda pada browser baru untuk memastikan profil efektif yang sama dipakai hosted page dan embed.
Troubleshooting#
- 401 AUTH_REQUIRED
- Key hilang, invalid, expired, revoked, atau tidak cocok dengan tenant ID pada URL.
- 403
- Key tidak memiliki scope tool yang dipanggil, atau request browser membawa Origin yang tidak dipercaya.
- 429
- Terlalu banyak request. Tunggu lalu ulangi; jangan membuat retry loop rapat.
- Tool tidak muncul
- Pastikan URL memuat tenant ID, reload/restart client, lalu jalankan doctor, probe, atau /mcp sesuai client.
- ChatGPT connector gagal auth
- Gunakan OpenAI Responses API. ChatGPT UI belum memakai API key Termilo.
- Claude connector gagal masuk
- Pastikan Anda masuk ke akun Termilo yang benar dan memilih bisnis. Hapus connector lalu tambahkan lagi.
Keamanan#
- Pilih preset Branding MCP, bukan akses penuh.
- Gunakan environment variable jika client mendukungnya.
- Jangan bagikan satu key ke banyak perangkat atau anggota tim.
- Jika key bocor atau hilang, rotate atau revoke segera dari halaman API keys.