tumbuh.ai
Integrasi

MCP

Server MCP memungkinkan agen AI membaca dan bertindak di workspace Anda sebagai tool. Server memakai API key, scope, rate limit, dan audit yang sama dengan Public API. MCP tidak menambah kemampuan baru.

CRM tumbuh.ai melalui OAuth

Jika administrator telah mengaktifkan OAuth, owner dan anggota tim dapat menghubungkan akun masing-masing tanpa menyalin API key.

  1. Tambahkan connector CRM tumbuh.ai atau koneksi MCP kustom yang disediakan administrator.
  2. Untuk gateway bersama, gunakan https://crm-connect.tumbuh.ai/mcp. Pilih alamat server CRM yang biasa Anda gunakan, lalu lanjutkan masuk. Jika server Anda belum tercantum, hubungi administrator.
  3. Masuk di server CRM yang dipilih. Tinjau aplikasi peminta, identitas akun, workspace, dan izin. Izin tambahan untuk mengubah data atau mengirim pesan harus dipilih secara eksplisit.
  4. Pilih Izinkan akses untuk kembali ke aplikasi AI. Setiap server/workspace membutuhkan koneksi terpisah, termasuk jika alamat emailnya sama.
  5. Buka menu CRM tumbuh.ai di CRM untuk melihat atau mencabut koneksi. Anggota tim mengelola koneksinya sendiri; owner dapat mencabut koneksi workspace.

Izin akun, batas cabang, batas paket API, kuota, dan audit tetap berlaku. Pilihan Tetap terhubung mengizinkan refresh sampai batas maksimum 30 hari. Pengurangan scope mempersempit koneksi; untuk menambah izin, hubungkan ulang dan berikan persetujuan baru. Koneksi yang dicabut tidak dapat digunakan kembali tanpa login dan persetujuan baru.

Ketersediaan di directory ChatGPT/Codex atau Claude mengikuti aktivasi server dan review platform. Nama CRM tumbuh.ai membedakannya dari integrasi ERP tumbuh.ai.

Data yang dibagikan saat menggunakan konektor

Saat Anda meminta tool, server CRM yang dipilih mengembalikan hasil sesuai izin koneksi ke aplikasi AI yang Anda gunakan: ChatGPT/Codex dari OpenAI atau Claude dari Anthropic. Hasil dapat mencakup identitas dan kontak pelanggan, isi percakapan, catatan, pipeline, serta data CRM lain yang diminta dan diizinkan. Pilih hanya izin yang diperlukan dan pastikan Anda berwenang membagikan data tersebut. Koneksi tidak memperluas akses akun, workspace, atau cabang Anda.

Gateway bersama menyimpan identitas koneksi, server CRM yang dipilih, izin, status OAuth, dan kredensial koneksi yang dienkripsi. Data ini digunakan untuk menjalankan autentikasi, refresh, pemeriksaan akses, dan pencabutan koneksi. Basis data gateway bukan salinan terpusat seluruh tabel bisnis CRM. Data bisnis tetap berada di server CRM asal dan hasil tool dikirim ke aplikasi AI ketika diminta.

Token akses berlaku paling lama 15 menit; koneksi dengan refresh memiliki batas absolut maksimum 30 hari. Permintaan otorisasi yang belum selesai berlaku lima menit. Registrasi klien OAuth dapat berlaku sampai 365 hari. Batas berlaku ini menentukan apakah kredensial masih bisa digunakan, bukan janji bahwa semua rekaman fisik dihapus tepat saat kedaluwarsa. Penyimpanan data CRM asal dan log mengikuti kebijakan privasi serta perjanjian layanan bisnis Anda.

Untuk menghentikan akses, cabut koneksi melalui menu CRM tumbuh.ai. Keluar dari akun saja tidak mencabut akses offline. Pencabutan di gateway langsung memblokir token gateway; jika server CRM asal sedang tidak tersedia, pencabutan pada server tersebut dicoba ulang dan statusnya dapat tertunda. Data yang sudah diterima aplikasi AI mengikuti kebijakan dan pengaturan penyedia AI tersebut; pencabutan koneksi tidak menarik kembali hasil yang sudah diterima.

Lihat Kebijakan Privasi tumbuh.ai untuk kebijakan layanan dan hak terkait data. Hubungi dukungan untuk pertanyaan akses, pencabutan, atau permintaan terkait data. Konektor tidak menetapkan masa simpan atau penggunaan pelatihan model milik penyedia AI; tinjau ketentuan dan pengaturan akun penyedia yang Anda pilih.

Batas penggunaan data medis

Workspace CRM dapat berisi data pasien atau medis. Kemampuan membaca data tersebut bukan sertifikasi kepatuhan atau persetujuan penyedia AI untuk memprosesnya. Jangan mengirim data pasien/medis melalui koneksi OpenAI yang belum disetujui untuk penggunaan tersebut. Ketersediaan konektor privat atau video dengan data contoh tidak berarti konektor telah disetujui dalam marketplace. Penggunaan data kesehatan harus mengikuti persyaratan penyedia AI dan perjanjian yang berlaku untuk bisnis Anda.

Sebelum mulai dengan API key

  • Paket Anda menyertakan akses API.
  • Anda sudah punya API key (lihat API Key dan Scope). Beri hanya scope yang dibutuhkan agen.

Endpoint

Code
POST https://<domain-anda>/api/v1/mcp
Authorization: Bearer <api-key>

Transport-nya Streamable HTTP dan stateless: tidak ada sesi yang perlu dibuka atau dijaga. Permintaan GET terautentikasi dijawab 405. Jika OAuth aktif, permintaan tanpa kredensial mendapat 401 beserta metadata untuk memulai login.

Menghubungkan klien

Halaman Pengembang > MCP dan kartu koneksi di Pengembang > API Keys menampilkan konfigurasi siap salin. Dialog pembuatan key bahkan sudah mengisi key-nya, satu-satunya saat key tampil utuh.

Contoh untuk Claude Code:

TerminalCode
claude mcp add --transport http tumbuh https://<domain-anda>/api/v1/mcp \
  --header "Authorization: Bearer <api-key>"

Klien lain (misalnya Claude Desktop, ChatGPT, atau node MCP Client di n8n) ditambahkan sebagai konektor kustom Streamable HTTP dengan URL dan header yang sama. Antarmuka konektor tiap klien bisa berubah; bila klien tidak menerima header Bearer, jangan menaruh key di query string.

Tool yang terlihat

Daftar tool (tools/list) hanya memuat tool yang diizinkan oleh scope key. Tool yang tidak terlihat tidak bisa dipakai key itu. Halaman Pengembang > MCP menampilkan tool yang bisa dipanggil tiap key, lengkap dengan efeknya. Daftar lengkap ada di API Reference.

Halaman Pengembang > MCP

Halaman ini membantu Anda memeriksa apa yang bisa dilakukan agen dengan sebuah API key.

  • API key: pilih key dari daftar. Tool yang tampil mengikuti key yang dipilih.
  • Filter tool: Tool untuk key ini hanya menampilkan tool yang diizinkan oleh scope key. Semua tool menampilkan daftar tool tanpa membatasi pada scope key.
  • Tabel tool: kolom Tool (judul, nama, dan deskripsi), Scope (scope yang dibutuhkan), dan Efek. Kolom Efek memakai anotasi MCP: Hanya baca, Menulis, Merusak, atau Menjangkau pelanggan (tool yang mengirim ke pelanggan atau memindahkan uang).
  • Konfigurasi klien: cuplikan JSON siap salin dengan tombol Salin. Ganti <your_api_key> dengan key yang Anda buat.
  • Unduh panduan agen: tombol Unduh panduan agen menyimpan berkas tumbuh-agent-guide.md untuk key dan filter yang dipilih. Berikan berkas itu ke agen Anda sebagai petunjuk memakai tool.

Wajibkan konfirmasi untuk tool pengirim

Tool yang menjangkau pelanggan atau memindahkan uang diberi anotasi agar klien meminta konfirmasi manusia. Bila klien Anda mengabaikan anotasi, jangan beri key itu scope pengiriman seperti messages:write, broadcast:send, atau payments:write.

Hasil yang diharapkan

Klien menampilkan server tumbuh.ai sebagai terhubung dan agen dapat memanggil tool sesuai scope.

Masalah umum

  • 401: key salah atau kedaluwarsa. Lihat Autentikasi.
  • Tool tidak muncul: key tidak punya scope-nya. Buat key baru.
  • 503 ServerBusy dengan Retry-After 1: server sedang penuh. Permintaan belum diproses, aman diulang. Lihat Rate Limit dan Error.
Last modified on
n8nGoogle Calendar