Referensi API: MCP

Server MCP memungkinkan asisten AI berinteraksi dengan ProcessMind melalui Model Context Protocol. Server ini menggunakan JSON-RPC 2.0 melalui Streamable HTTP: kirim initialize, lalu tools/list untuk melihat katalog alat. Alat baca seperti list_processes hanya ditampilkan jika API key memiliki cakupan baca; alat tulis memerlukan cakupan tulis. Gunakan tools/call untuk menjalankan alat beserta argumennya. Fakta yang perlu digunakan lintas sesi dapat disimpan dengan alat memori (remember, recall, forget). Proses AI yang berjalan lama dilacak untuk setiap pemanggilan alat: sertakan referensi tugas di _meta["io.modelcontextprotocol/related-task"], lalu ProcessMind akan melaporkan status tugas tersebut bersama hasil pemanggilan. Metode ekstensi tasks/list, tasks/get, dan tasks/cancel tidak tersedia.

Endpoint server Model Context Protocol (JSON-RPC melalui Streamable HTTP)

JSON-RPC 2.0 melalui Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Alat baca memerlukan cakupan read pada API key, sedangkan alat tulis memerlukan cakupan write. Katalog alat dijelaskan dalam panduan MCP. Lakukan autentikasi dengan x-api-key atau Authorization: Bearer <token> (token dari endpoint token OAuth).

Endpoint: POST /v1/mcp/{tenantId}

Autentikasi: API key dengan cakupan tenant · cakupan read · batas laju 20 permintaan/detik (lonjakan 40)

Parameter:

Nama	Tipe	Lokasi	Wajib	Deskripsi
tenantId	string	path	Ya	Format: uuid

Isi permintaan:

Permintaan JSON-RPC MCP

{}

Respons (200):

Respons JSON-RPC MCP

{
	"message": "string"
}

Kolom	Tipe	Wajib	Deskripsi
message	string	Ya

Error:

• 401 API key tidak ada, tidak valid, dinonaktifkan, atau kedaluwarsa
• 403 API key tidak memiliki cakupan atau akses organisasi yang diperlukan, tenant tidak aktif, atau paket tidak mengizinkan jenis file tersebut

Endpoint otorisasi OAuth 2.1 (PKCE), mengalihkan kembali dengan kode 302 ke redirect_uri?code=…

Endpoint: GET /v1/mcp/{tenantId}/oauth/authorize

Autentikasi: Publik, tanpa API key · batas laju 10 permintaan/detik (lonjakan 20)

Parameter:

Nama	Tipe	Lokasi	Wajib	Deskripsi
tenantId	string	path	Ya	Format: uuid
client_id	string	query	Ya
redirect_uri	string	query	Ya	Format: uri
code_challenge	string	query	Ya
code_challenge_method	S256	query	Tidak	Nilai yang diizinkan: S256
state	string	query	Tidak

Error:

• 302 Mengalihkan ke redirect_uri dengan code + state
• 400 Permintaan tidak valid, misalnya ekspresi filter tidak valid, proses tanpa model, jenis unggahan tidak didukung, atau kolom wajib tidak diisi
• 401 API key tidak ada, tidak valid, dinonaktifkan, atau kedaluwarsa

Endpoint token OAuth 2.0 (client_credentials atau authorization_code + PKCE)

Endpoint: POST /v1/mcp/{tenantId}/oauth/token

Autentikasi: Publik, tanpa API key · batas laju 5 permintaan/detik (lonjakan 10)

Parameter:

Nama	Tipe	Lokasi	Wajib	Deskripsi
tenantId	string	path	Ya	Format: uuid

Respons (200):

Token akses

{
	"access_token": "string",
	"token_type": "Bearer",
	"expires_in": 0
}

Kolom	Tipe	Wajib	Deskripsi
access_token	string	Ya	Bearer JWT berumur pendek untuk POST /v1/mcp/{tenantId}
token_type	Bearer	Ya	Nilai yang diizinkan: Bearer
expires_in	number	Ya

Error:

• 400 Permintaan tidak valid, misalnya ekspresi filter tidak valid, proses tanpa model, jenis unggahan tidak didukung, atau kolom wajib tidak diisi
• 401 API key tidak ada, tidak valid, dinonaktifkan, atau kedaluwarsa
• 403 API key tidak memiliki cakupan atau akses organisasi yang diperlukan, tenant tidak aktif, atau paket tidak mengizinkan jenis file tersebut