Lewati ke isi

Layanan MCP / Fungsi MCP

Ditambahkan pada versi 7.5.0

"Fungsi MCP" adalah fitur DataFlux Func untuk mendukung AI Agent dalam memanggil fungsi di dalam Func.

Pengguna dapat menyediakan sebagian fungsi di DataFlux Func kepada AI Agent melalui Layanan MCP.

1. Langkah-langkah Integrasi

Anda dapat mengintegrasikan klien MCP / AI Agent ke Layanan MCP DataFlux Func dengan langkah-langkah berikut:

1.1 Membuat Access Token

Untuk mengakses Layanan MCP DataFlux Func, Anda perlu membuat Access Token dan mengaktifkan fitur "Fungsi MCP".

Anda juga dapat menentukan fungsi yang akan dibuka dalam aturan (misalnya: berdasarkan nilai kolom category).

add-access-token.png

add-access-token-2.png

1.2 Aturan Izin

Aturan izin dapat diedit secara manual, dicocokkan dari atas ke bawah, dan izin ditentukan berdasarkan aturan pertama yang cocok.

Contohnya sebagai berikut:

Aturan (ID yang Dicocokkan Persis) Panggilan yang Diizinkan
category:math Fungsi dengan category = math
scriptSet:mytest Fungsi yang termasuk dalam Kumpulan Skrip mytest
script:mytest__demo Fungsi yang termasuk dalam Skrip mytest__demo
func:mytest__demo.func Fungsi dengan ID mytest__demo.func
Aturan (Wildcard ID) Panggilan yang Diizinkan
scriptSet:myte* Fungsi yang cocok dengan wildcard ID Kumpulan Skrip myte*
script:mytest__de* Fungsi yang cocok dengan wildcard ID Skrip mytest__de*
func:mytest__demo.fu* Fungsi yang cocok dengan wildcard ID Fungsi mytest__demo.fu*
Aturan (Dilarang) Panggilan yang Dilarang
!category:math Fungsi dengan category = math

1.3 Mengonfigurasi Klien MCP

Layanan MCP DataFlux Func Mengikuti Spesifikasi MCP

Sebelum integrasi, disarankan menggunakan MCP Inspector untuk debugging.

Tambahkan konfigurasi berikut pada klien MCP / AI Agent:

Item Konfigurasi Nilai
Alamat URL {Alamat akses DataFlux Func}/mcp
atau /mcp2, /mcp3
Perbedaan spesifiknya lihat "Mode Layanan MCP" di bawah
Header Permintaan X-Dff-Access-Token: atk-xxxxx:xxxxx
Contoh: Konfigurasi OpenCode
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "mcp": {
    "dataflux-func-mcp": {
      "enabled": true,
      "type"   : "remote",
      "url"    : "{Alamat akses DataFlux Func}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}
Contoh: Konfigurasi Codex
1
2
3
4
[mcp_servers.dataflux-func-mcp]
enabled      = true
url          = "{Alamat akses DataFlux Func}/mcp"
http_headers = { "X-Dff-Access-Token" = "atk-xxxxx:xxxxx" }
Contoh: Konfigurasi Claude Code
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
  "mcpServers": {
    "dataflux-func-mcp": {
      "type": "http",
      "url": "{Alamat akses DataFlux Func}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}
Contoh: Konfigurasi JSON Umum
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "mcpServers": {
    "dataflux-func-mcp": {
      "url": "{Alamat akses DataFlux Func}/mcp",
      "headers": {
        "X-Dff-Access-Token": "atk-xxxxx:xxxxx"
      }
    }
  }
}

Mulai ulang AI Agent setelah mengubah konfigurasi

Banyak AI Agent hanya memuat konfigurasi Layanan MCP saat dimulai. Setelah mengubah konfigurasi Layanan MCP, jika konfigurasi baru belum berlaku, silakan mulai ulang AI Agent. Misalnya, saat menggunakan plugin AI Agent seperti Codex di VS Code, Anda dapat menekan Ctrl + P dan memasukkan >Reload Window untuk memuat ulang jendela.

2. Mode Layanan MCP

Layanan MCP DataFlux Func mendukung 3 mode berdasarkan jalur akses yang berbeda:

Jalur Mode
/mcp Mode Dasar
/mcp2 Mode List-Call
/mcp3 Mode Search-Call (Direkomendasikan)

Misalkan konfigurasi Access Token adalah sebagai berikut, dan terdapat fungsi-fungsi berikut di repositori kode:

Larang category:test, izinkan category:math
1
2
!category:test
category:math

code.png

2.1 Mode Dasar /mcp

Langsung mendaftarkan semua fungsi yang tersedia sebagai Tool

Catatan: Saat daftar fungsi berubah, klien perlu menyambung ulang untuk memperbarui daftar.

2.2 Mode List-Call /mcp2

Hanya menyediakan dua Tool:

  • list-func: Mendaftarkan fungsi
  • call-func: Memanggil fungsi

Dapat mengimplementasikan daftar fungsi dinamis, AI Agent / model perlu mampu mengikuti pola List-Call dengan benar untuk melakukan pemanggilan.

2.3 Mode Search-Call /mcp3

Hanya menyediakan dua Tool:

  • search-func: Mencari fungsi
  • call-func: Memanggil fungsi

Dapat mengimplementasikan pencarian fungsi yang diperlukan berdasarkan kata kunci, AI Agent / model perlu mampu mengikuti pola Search-Call dengan benar untuk melakukan pemanggilan.

Saat jumlah fungsi banyak, panjang konteks dapat dikurangi secara signifikan.