> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Hubungkan Claude Desktop atau klien MCP lain ke Flowglad, temukan URL organisasi, terapkan template, dan pahami penanganan data serta pemecahan masalah.

Hubungkan agent yang kompatibel dengan MCP ke Flowglad untuk bekerja dengan pengetahuan bisnis dan konteks operasional organisasi Anda.

Konektor ini dapat menemukan dan mengedit Pages, membaca file dan catatan yang terhubung, membuat Tasks, mengelola Skills yang dapat digunakan ulang, serta membuat atau menjalankan Automations. Tool yang tersedia bergantung pada identitas yang terhubung, izin yang diberikan, dan fitur produk yang diaktifkan.

## Menerapkan template

Saat `templates.apply` tersedia di `tools/list`, berikan `templateId` yang telah dipublikasikan dan `spaceId` yang sudah ada untuk membuat semua resource template tersebut. Applications, Automations, dan salinan File biasa dimiliki oleh Space tersebut; Skills dimiliki oleh organisasi. File menggunakan nama file yang dikonfigurasi di root Space dan tidak pernah menimpa file yang sudah ada. Konflik nama yang sama membuat komponen tersebut gagal, sementara komponen independen dapat terus berjalan. File dianggap selesai ketika byte dan metadata-nya telah disimpan secara permanen; proses ini tidak menunggu pengindeksan.

Secara opsional, berikan `connections` sebagai array objek `{ connector, connectionId }`, dengan maksimal satu connection per provider. Connection yang diberikan harus dapat diakses, kompatibel, dan sudah ditetapkan ke Space jika diperlukan. Connection yang tidak diberikan membuat resource menunggu konfigurasi. Respons akan merekomendasikan connection yang memenuhi syarat, atau merekomendasikan pembuatan connection jika tidak ada yang tersedia.

Pembuatan berjalan dalam satu task Trigger.dev sesuai urutan dependensi, dengan hasil setiap komponen dicatat di metadata dan output task. Percobaan ulang otomatis untuk seluruh task dinonaktifkan; task yang gagal atau terhenti dapat meninggalkan resource parsial. Respons mengonfirmasi bahwa pembuatan telah dimasukkan ke antrean serta menyertakan komponen yang direncanakan dan rekomendasi connection; respons tidak mengonfirmasi bahwa resource telah selesai dibuat. Gunakan tool list/get untuk resource tersebut guna menemukan dan memeriksanya. Resource yang berhasil dibuat tetap ada meskipun komponen lain gagal.

Menerapkan template menunda verifikasi yang dapat dieksekusi dan tidak mengaktifkan atau menjalankan resource-nya. Setiap panggilan apply membuat salinan baru, termasuk saat percobaan ulang. Gunakan tool resource untuk memeriksa apa yang telah dibuat.

## Sebelum Anda menghubungkan

Anda memerlukan:

* Akun Flowglad dengan akses ke organisasi yang ingin Anda gunakan.
* URL MCP produksi organisasi Anda.
* Agent atau klien yang mendukung server MCP jarak jauh melalui Streamable HTTP dan OAuth.
* Izin organisasi dan Space yang diperlukan untuk pekerjaan yang Anda maksud.
* Connection sumber atau file apa pun yang sudah tersedia untuk Space yang relevan.

Bagian harga yang dipublikasikan di [beranda Flowglad](https://www.flowglad.com/) menyertakan MCP di paket Free, Plus, dan Max. Izin organisasi dan Space, grant OAuth, dan akses sumber yang terhubung tetap berlaku.

Connection ke sistem bisnis eksternal harus dikonfigurasi di Flowglad dan diekspos ke Space yang dimaksud sebelum agent dapat menggunakannya. Lihat [Konektor](/docs/id/connectors.md) dan [Spaces](/docs/id/spaces.md).

## Temukan URL organisasi Anda

Konektor produksi menggunakan URL khusus organisasi:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

Ganti `{orgId}` dengan ID organisasi Flowglad Anda yang sebenarnya. Pertahankan ID lengkapnya, termasuk prefix `org_`. Jangan memasukkan tanda kurung kurawal atau ID organisasi karangan.

Di Flowglad, buka **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**. Salin URL MCP organisasi yang ditampilkan di sana. Gunakan instruksi **Website** untuk URL jarak jauh; tab **Desktop app** yang terpisah berisi instruksi penyiapan melalui command line.

Jika Anda tidak dapat mengakses pengaturan ini, tanyakan kepada administrator Flowglad Anda atau [dukungan](mailto:support@flowglad.com).

Gunakan URL organisasi untuk konektor ini. URL khusus connection dapat mengekspos kumpulan tool yang lebih sempit dan tidak dapat dipertukarkan dengan URL organisasi yang dijelaskan di sini.

## Hubungkan dari Claude Desktop

Tonton [video penyiapan Claude Desktop](https://youtu.be/6qqSnrqDJ2o), atau ikuti langkah-langkah di bawah ini.

[Cara menghubungkan Flowglad ke Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o)

Gunakan alur custom connector Claude Desktop untuk menambahkan Flowglad dan mengotorisasi akses ke akun Anda.

**1. Buka formulir custom connector.**

Di Claude Desktop, navigasikan ke **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**.

**2. Tambahkan konektor Flowglad.**

Masukkan **Flowglad** sebagai nama konektor, atau pilih nama lain.

Tempelkan URL MCP organisasi lengkap Anda ke field URL. Anda dapat menyalinnya dari [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). URL tersebut akan terlihat seperti ini: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

Jangan mengubah pengaturan konektor lainnya. Pilih **Add** untuk melanjutkan. Claude Desktop mungkin memberi label tombol ini **Continue** di beberapa versi.

**3. Berikan Claude akses ke Flowglad.**

Lanjutkan alur koneksi untuk mengotorisasi Claude mengakses akun Flowglad Anda. Saat diminta, masuk, konfirmasi organisasi Flowglad yang dimaksud, dan tinjau akses yang diminta sebelum mengotorisasinya.

Setelah alur selesai, kembali ke Claude Desktop dan pastikan connection Flowglad tersedia. Minta Claude untuk memeriksa connection Flowglad dan menampilkan daftar Spaces yang dapat Anda akses.

OAuth Dynamic Client Registration adalah metode koneksi yang dimaksudkan. Jangan menambahkan kata sandi, access token, API key, atau client secret ke URL server.

Instruksi ini menjelaskan cara menghubungkan Flowglad secara langsung sebagai custom connector; ketersediaan di direktori adalah hal yang terpisah.

## Hubungkan klien MCP lain

Tambahkan URL organisasi yang sama sebagai server MCP Streamable HTTP jarak jauh. Selesaikan alur OAuth klien dengan akun Flowglad Anda, lalu verifikasi organisasi dan tool yang tersedia.

Dukungan klien bervariasi. Koneksi server yang berhasil tidak berarti klien mengimpor Flowglad Skills secara otomatis. Ekstensi penemuan Skill dan tool `skills.list` adalah antarmuka yang berbeda. Lihat [Skills](/docs/id/skills.md) untuk perilaku penemuan dan manajemen paket yang didukung.

## Penanganan data

Penggunaan Flowglad MCP diatur oleh [Kebijakan Privasi Flowglad](https://www.flowglad.com/privacy-policy). Admin organisasi dapat melihat semua panggilan tool MCP yang dilakukan ke organisasi Anda di [Settings > Audit](https://dashboard.flowglad.com/settings/audit).

## Pemecahan masalah

| Gejala | Langkah selanjutnya |
| - | - |
| Koneksi gagal sebelum masuk | Periksa URL HTTPS lengkap dan ID organisasi. Pastikan klien mendukung MCP jarak jauh dengan OAuth. |
| Berhasil masuk tetapi pekerjaan tidak tersedia | Periksa organisasi yang dipilih, membership Space, grant MCP, dan Connections yang tersedia di Space tersebut. |
| Tool tulis tidak tersedia atau ditolak | Pastikan izin organisasi dan Space yang diperlukan. Hubungkan ulang jika diperlukan scope OAuth yang baru diberikan. |
| Provider yang terhubung tidak dapat dibaca | Pastikan otorisasinya aktif dan Connection diekspos ke Space yang dimaksud. |
| Page atau file tidak dapat ditemukan | Pastikan Space-nya benar, akses langsung dan tertautnya, serta sumbernya masih tersedia. |
| Operasi mengembalikan ID job atau run | Periksa siklus hidup akhir atau status run-nya sebelum melaporkan keberhasilan atau mencoba lagi. |
| Penulisan mengalami timeout | Periksa apakah penulisan telah selesai sebelum mencoba lagi. Beberapa operasi membuat catatan baru atau mengantrekan pekerjaan pada setiap panggilan. |
| Akses kedaluwarsa atau dicabut | Hubungkan ulang melalui OAuth dan verifikasi organisasi dan grant yang dimaksud. Jika koneksi ulang masih gagal, hubungi dukungan. |

Untuk informasi keamanan umum, lihat [Keamanan](/docs/id/security.md) dan [Trust Center](https://trust.flowglad.com) kami. Jika Anda mengalami masalah saat menghubungkan, [hubungi kami](mailto:support@flowglad.com).

Saat menghubungi dukungan, sertakan waktu, klien, tool yang terdampak, kode error yang aman, dan ID permintaan jika tersedia. Jangan pernah menyertakan kata sandi, bearer token, cookie, URL upload/download bertanda tangan, atau data pelanggan.


## Related topics

- [Skills](/docs/id/skills.md)
- [Selamat datang](/docs/id/agents/introduction.md)
- [Automations](/docs/id/automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.