Konektor MCP

Konektor Model Context Protocol (MCP) memungkinkan Anda membuat dan mengonfigurasi koneksi MCP di Integration Connectors. Anda dapat menggunakan koneksi ini di aplikasi bisnis untuk bertukar data dan melakukan operasi dengan MCP secara aman.

Untuk mengetahui daftar entitas dan operasi yang didukung, lihat Contoh operasi entitas. Untuk mengetahui informasi tentang tindakan khusus konektor yang didukung, lihat Tindakan.

Versi konektor MCP

Konektor MCP mendukung dua versi:

MCP v1: Gunakan versi konektor ini untuk mengakses MCP v1 API.
MCP v2: Gunakan versi konektor ini untuk mengakses MCP v2 API.

Untuk mengetahui informasi tentang cara membuat koneksi MCP, lihat Membuat dan mengonfigurasi konektor MCP.

Entity, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.
Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.
Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
- Daftar
- Dapatkan
- Buat
- Update
- Hapus
Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.
Tindakan: Tindakan adalah fungsi kelas satu yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Entitas dan operasi yang didukung

Konektor MCP mendukung entitas dan operasi, dengan entitas dan operasi tertentu yang tersedia bergantung pada alat yang terhubung melalui MCP.

Contoh operasi entity

Bagian ini memberikan contoh operasi entitas untuk berbagai alat.

Entitas List Jira Issues

Contoh ini mencantumkan semua Masalah dalam entitas Masalah menggunakan koneksi MCP Jira.

Di jendela Configure Connector Task, klik Entities.
Pilih Masalah dari daftar Entitas.
Pilih operasi List, lalu klik Done.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{
      "operation": "LIST_ENTITIES",
      "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
      "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
      "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
      "entity": "Issues",
      "entity_id": "Issues",
      "page_token": ""
    }

Mencantumkan semua permintaan

Contoh ini mencantumkan semua Requests dalam entity Requests.

Di jendela Configure Connector Task, klik Entities.
Pilih Permintaan dari daftar Entitas.
Pilih operasi List, lalu klik Done.

Mendapatkan pengguna menurut ID

Contoh ini mendapatkan pengguna dengan AccountId sebagai `6035864ce2020c0070b5285b` dari entitas Users. `AccountId` adalah kunci utama untuk entitas Users. Untuk mendapatkan entity tertentu, gunakan operasi List dengan filterClause pada kunci utama, karena operasi Get tidak didukung untuk entity ini.

Di jendela Configure Connector Task, klik Entities.
Pilih Pengguna dari daftar Entitas.
Pilih operasi List, lalu klik Done.
Di bagian Task Input pada tugas Connectors, klik filterClause, lalu masukkan `AccountId`=6035864ce2020c0070b5285b di kolom Default Value.

Tindakan

Konektor MCP menyediakan berbagai tindakan, dengan tindakan spesifik yang tersedia bergantung pada alat yang terhubung melalui MCP.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan yang tersedia melalui konektor MCP untuk berbagai alat.

Tindakan Jira: Mendapatkan masalah

Contoh ini menunjukkan cara mencantumkan masalah Jira menggunakan koneksi MCP yang dikonfigurasi untuk Jira.

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan get_issues, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
  {
    "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
  }
```

Tindakan linear: Masalah daftar

Contoh ini menunjukkan cara mencantumkan masalah di Linear menggunakan koneksi MCP yang dikonfigurasi untuk Linear.

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan list_issues, lalu klik Done.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
  {
    "limit": 50
  }
```

Tindakan Sentry: Whoami

Contoh ini menunjukkan cara mendapatkan info pengguna dari Sentry menggunakan koneksi MCP yang dikonfigurasi untuk Sentry.

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan whoami, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
  {
    "name": "example-org"
  }
```

Menemukan organisasi

Contoh ini menunjukkan cara menemukan organisasi di Sentry menggunakan koneksi MCP yang dikonfigurasi untuk Sentry.

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan find_organizations, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
  {}
```

Tindakan Interkom: Menelusuri percakapan

Contoh ini menunjukkan cara menelusuri detail percakapan di Intercom menggunakan koneksi MCP yang dikonfigurasi untuk Intercom.

Dalam dialog Konfigurasi tugas konektor, klik Tindakan.
Pilih tindakan penelusuran, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
  {
    "query": "object_type:conversations state:open created_at:gt:2024-01-01"
  }
```

Batasan sistem

Konektor MCP memiliki batasan sistem yang dapat bervariasi berdasarkan alat tertentu yang terhubung. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Catatan: Jumlah node Integration Connectors akan diskalakan otomatis secara dinamis berdasarkan penggunaan Anda. Namun, jika ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Jumlah node yang diperlukan meningkat saat jumlah transaksi yang diproses untuk koneksi bertambah. Sebaliknya, jumlah node yang diperlukan lebih sedikit jika koneksi memproses lebih sedikit transaksi. Untuk mengonfigurasi nilai node, lakukan hal berikut:

Jika Anda adalah pelanggan prabayar, konfigurasikan nilai node minimum dan maksimum di halaman edit koneksi.
Jika Anda adalah pelanggan berbasis langganan, hubungi dukungan.

Jumlah transaksi maksimum yang dapat ditangani oleh sebuah node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk mendapatkan throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda telah disiapkan secara optimal untuk menangani traffic yang diperlukan.