# 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](https://tumbuh.ai/kebijakan-privasi) untuk kebijakan layanan dan hak terkait data. Hubungi [dukungan](/troubleshooting/kontak-support) 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](/developer/api-key-dan-scope)). Beri hanya scope yang dibutuhkan agen. ## Endpoint ```text POST https:///api/v1/mcp Authorization: Bearer ``` 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: ```bash claude mcp add --transport http tumbuh https:///api/v1/mcp \ --header "Authorization: Bearer " ``` 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](/api). ## 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 `` 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](/developer/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](/developer/rate-limit-dan-error).