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.

https://api.termilo.id/mcp

Langkah sambung#

  1. Di Claude, buka Settings, lalu Connectors.
  2. Pilih Add custom connector.
  3. Tempel https://api.termilo.id/mcp.
  4. Pilih Connect.
  5. Masuk ke Termilo.
  6. Pilih bisnis yang ingin Anda hubungkan.
  7. Pilih Izinkan (Allow).

Satu koneksi berlaku untuk satu bisnis. Untuk bisnis lain, tambahkan connector lagi dan pilih bisnis itu.

Tingkat akses#

Bacaread

Claude melihat booking, ketersediaan, layanan, pelanggan, dan pengaturan. Claude tidak mengubah apa pun. Semua anggota tim bisa memberi akses ini.

Ubahwrite

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 linksget_booking_linksbaca
  • Preview availabilitypreview_availabilitybaca
  • List bookingslist_bookingsbaca
  • Get bookingget_bookingbaca
  • Create bookingcreate_bookingubah
  • Reschedule bookingreschedule_bookingubahmengubah data yang ada
  • Cancel bookingcancel_bookingubahmengubah data yang ada
  • Get dashboard summaryget_dashboard_summarybaca
  • Search bookingssearch_bookingsbaca
  • Confirm bookingconfirm_bookingubahmengubah data yang ada
  • Complete bookingcomplete_bookingubahmengubah data yang ada
  • Mark booking no-showmark_booking_no_showubahmengubah data yang ada
  • Cancel bookings in bulkbulk_cancel_bookingsubahmengubah data yang ada
  • Update booking status in bulkbulk_update_booking_statusubahmengubah data yang ada
  • Reschedule bookings in bulkbulk_reschedule_bookingsubahmengubah data yang ada
  • Get availability calendarget_availability_calendarbaca

Layanan

  • Get serviceget_servicebaca
  • Create servicecreate_serviceubah
  • Update serviceupdate_serviceubahmengubah data yang ada
  • Archive servicearchive_serviceubahmengubah data yang ada
  • List serviceslist_servicesbaca
  • Get service deposit policyget_service_deposit_policybaca
  • Update service deposit policyupdate_service_deposit_policyubahmengubah data yang ada
  • Get service location policyget_service_location_policybaca
  • Update service location policyupdate_service_location_policyubahmengubah data yang ada
  • List service categorieslist_service_categoriesbaca
  • Update service status in bulkbulk_update_service_statusubahmengubah data yang ada

Tampilan halaman booking

  • Get brandingget_brandingbaca
  • Update brandingupdate_brandingubahmengubah data yang ada

Pembayaran

  • Get payment accountget_payment_accountbaca

Webhook

  • List webhookslist_webhooksbaca
  • Create webhookcreate_webhookubah
  • Rotate webhook secretrotate_webhook_secretubahmengubah data yang ada
  • Disable webhookdisable_webhookubahmengubah data yang ada
  • Send test webhooksend_test_webhookubah
  • List webhook deliverieslist_webhook_deliveriesbaca

Tenant

  • Get accountget_accountbaca
  • List stafflist_staffbaca
  • Create staffcreate_staffubah
  • Update staffupdate_staffubahmengubah data yang ada
  • List resourceslist_resourcesbaca
  • Create resourcecreate_resourceubah
  • Update resourceupdate_resourceubahmengubah data yang ada
  • List availability ruleslist_availability_rulesbaca
  • Create availability rulecreate_availability_ruleubah
  • Update availability ruleupdate_availability_ruleubahmengubah data yang ada
  • List blocked timeslist_blocked_timesbaca
  • Create blocked timecreate_blocked_timeubah
  • Update blocked timeupdate_blocked_timeubahmengubah data yang ada
  • List holidayslist_holidaysbaca
  • Create holidaycreate_holidayubah
  • Update holidayupdate_holidayubahmengubah data yang ada
  • Get holiday settingsget_holiday_settingsbaca
  • Update holiday settingsupdate_holiday_settingsubahmengubah data yang ada
  • Get business profileget_business_profilebaca
  • Update business profileupdate_business_profileubahmengubah data yang ada
  • Get booking policyget_booking_policybaca
  • Update booking policyupdate_booking_policyubahmengubah data yang ada
  • Get embed codeget_embed_codebaca
  • List message templateslist_message_templatesbaca
  • Get message templateget_message_templatebaca
  • Create message templatecreate_message_templateubah
  • Update message templateupdate_message_templateubahmengubah data yang ada
  • Delete message templatedelete_message_templateubahmengubah data yang ada
  • Get notification settingsget_notification_settingsbaca
  • Update notification settingsupdate_notification_settingsubahmengubah data yang ada
  • List notification loglist_notification_logbaca
  • List team memberslist_team_membersbaca
  • Invite team memberinvite_team_memberubah
  • Resend team invitationresend_team_invitationubahmengubah data yang ada
  • Revoke team invitationrevoke_team_invitationubahmengubah data yang ada
  • Update team memberupdate_team_memberubahmengubah data yang ada
  • Get billing statusget_billing_statusbaca
  • List integrationslist_integrationsbaca

Pelanggan

  • List customerslist_customersbaca
  • Get customerget_customerbaca
  • Create customercreate_customerubah
  • Update customerupdate_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.

Kontrak live
Endpoint production adalah 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#

  1. 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.
  2. Ambil tenant ID dari config booking publik. Ganti tenant slug dengan bagian terakhir URL booking Anda.
  3. Simpan key di secret manager atau environment variable client.
curl -s "https://book.termilo.id/book/<TENANT_SLUG>/config" \ | jq -r '.data.tenant.tenantId'

Dukungan client#

Client yang menerima static HTTP header dapat dipakai sekarang. UI yang hanya menerima OAuth connector harus menunggu OAuth MCP Termilo.

ClientJalur koneksiStatus
OpenClawRemote MCP + static headerDidukung
Hermes Agentmcp_servers + environment headerDidukung
Claude CodeHTTP MCP + static headerDidukung
OpenAI Responses APIRemote MCP + authorizationDidukung
ChatGPT UIMembutuhkan OAuth discoveryMenunggu OAuth
Claude.ai / Desktop connectorOAuth, tanpa API key (lihat bagian Hubungkan ke Claude)Didukung

Tool tenant#

get_booking_linksbookings:readread · risiko low

List 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 low

Read 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 low

Preview 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 medium

Create 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 medium

Update 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 high

Archive 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 low

List 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 low

Read 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 medium

Create 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 medium

Move 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 high

Cancel 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 low

Read 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 medium

Update 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 low

Read 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 low

List 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 high

Create 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 high

Issue 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 high

Disable 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 medium

Enqueue 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 low

Read 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.

Bukan editor CSS bebas
Tool update tidak menerima CSS, HTML, JavaScript, font URL, atau file base64. Logo harus berupa URL HTTPS dan kombinasi warna harus lulus contrast ratio minimum 4.5:1.

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.

export TERMILO_TENANT_ID="<TENANT_ID>" export TERMILO_MCP_API_KEY="<TERMILO_API_KEY>" umask 077 touch ~/.openclaw/.env printf 'TERMILO_MCP_API_KEY=%s\n' "$TERMILO_MCP_API_KEY" >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env openclaw mcp add termilo \ --url "https://api.termilo.id/mcp/${TERMILO_TENANT_ID}" \ --transport streamable-http \ --header 'Authorization=Bearer ${TERMILO_MCP_API_KEY}' \ --include 'get_booking_links,get_branding' chmod 600 ~/.openclaw/openclaw.json openclaw mcp doctor termilo --probe openclaw mcp probe termilo --json openclaw mcp reload

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.

# ~/.hermes/.env TERMILO_MCP_API_KEY=<TERMILO_API_KEY>

Jalankan /reload-mcp di Hermes atau restart agent. Tool tampil dengan prefix mcp_termilo_.

Rujukan: Hermes Agent MCP.

ChatGPT dan OpenAI#

ChatGPT UI belum bisa memakai API key Termilo
UI connector ChatGPT mengandalkan OAuth discovery dan tidak menyediakan field custom Authorization header. Sampai OAuth MCP Termilo tersedia, gunakan OpenAI Responses API untuk koneksi programatik.

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.

import OpenAI from "openai"; const openai = new OpenAI(); const response = await openai.responses.create({ model: "<MCP_CAPABLE_MODEL>", input: "Tampilkan branding Termilo saya.", tools: [{ type: "mcp", server_label: "termilo", server_url: process.env.TERMILO_MCP_URL, authorization: process.env.TERMILO_MCP_API_KEY, allowed_tools: ["get_branding", "update_branding"], require_approval: "always", }], }); console.log(response.output_text);

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.

{ "mcpServers": { "termilo": { "type": "http", "url": "https://api.termilo.id/mcp/${TERMILO_TENANT_ID}", "headers": { "Authorization": "Bearer ${TERMILO_MCP_API_KEY}" } } } }
Claude.ai dan connector akun berbeda
Form connector akun Claude.ai/Desktop memakai OAuth, bukan static bearer. Ikuti bagian Hubungkan ke Claude di atas. Static bearer Termilo dipakai di Claude Code.

Rujukan: Claude Code MCP dan Claude custom connectors.

Uji koneksi#

Mulai dengan read-only prompt:

Tampilkan branding Termilo saya. Jangan ubah apa pun.

Lalu uji update dengan review eksplisit:

Siapkan perubahan primaryHex menjadi #0E766E. Tampilkan perubahan yang akan dibuat dan minta persetujuan saya sebelum memanggil update_branding.

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#

Jangan tempel API key ke prompt, chat, screenshot, issue, atau repository Git. Siapa pun yang memegang key dapat memakai scope yang diberikan.
  • 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.