API referansı: MCP

MCP sunucusu, AI asistanlarının Model Context Protocol üzerinden ProcessMind ile etkileşim kurmasını sağlar. Streamable HTTP üzerinden JSON-RPC 2.0 kullanır: önce initialize gönderin, ardından araç kataloğunu görmek için tools/list gönderin. list_processes gibi okuma araçları yalnızca API anahtarında okuma kapsamı varsa listelenir; yazma araçları için yazma kapsamı gerekir. Bir aracı bağımsız değişkenleriyle çağırmak için tools/call kullanın. Oturumlar arasında kullanılacak bilgiler bellek araçlarıyla (remember, recall, forget) saklanabilir. Uzun süren AI oluşturma işlemleri her araç çağrısı için izlenir: _meta["io.modelcontextprotocol/related-task"] içine bir görev referansı ekleyin; ProcessMind çağrıyla birlikte görevin durumunu bildirir. tasks/list, tasks/get ve tasks/cancel uzantı yöntemleri sunulmaz.

Model Context Protocol sunucu uç noktası (Streamable HTTP üzerinden JSON-RPC)

Streamable HTTP üzerinden JSON-RPC 2.0: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Okuma araçları için anahtarda read kapsamı, yazma araçları için write kapsamı gerekir. Araç kataloğu MCP rehberinde açıklanmıştır. Kimlik doğrulaması için x-api-key veya Authorization: Bearer <token> kullanın (OAuth token uç noktasından alınan token).

Uç nokta: POST /v1/mcp/{tenantId}

Kimlik doğrulama: Kiracı kapsamlı API anahtarı · read kapsamı · hız sınırı: 20 istek/sn (ani artışta 40)

Parametreler:

Ad	Tür	Konum	Zorunlu	Açıklama
tenantId	string	yol	Evet	Biçim: uuid

İstek gövdesi:

MCP JSON-RPC isteği

{}

Yanıt (200):

MCP JSON-RPC yanıtı

{
	"message": "string"
}

Alan	Tür	Zorunlu	Açıklama
message	string	Evet

Hatalar:

• 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
• 403 API anahtarında gerekli kapsam veya kuruluş erişimi yok, kiracı etkin değil ya da plan dosya türünü engelliyor

OAuth 2.1 yetkilendirme uç noktası (PKCE), 302 yönlendirmesiyle redirect_uri adresine ?code=… ekleyerek geri döner.

Uç nokta: GET /v1/mcp/{tenantId}/oauth/authorize

Kimlik doğrulama: Herkese açık, API anahtarı gerekmez · hız sınırı: 10 istek/sn (ani artışta 20)

Parametreler:

Ad	Tür	Konum	Zorunlu	Açıklama
tenantId	string	yol	Evet	Biçim: uuid
client_id	string	sorgu	Evet
redirect_uri	string	sorgu	Evet	Biçim: uri
code_challenge	string	sorgu	Evet
code_challenge_method	S256	sorgu	Hayır	İzin verilen değerler: S256
state	string	sorgu	Hayır

Hatalar:

• 302 redirect_uri adresine code + state ile yönlendirme
• 400 Hatalı istek: örneğin geçersiz bir filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen bir yükleme türü veya eksik bir zorunlu alan
• 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş

OAuth 2.0 token uç noktası (client_credentials veya authorization_code + PKCE)

Uç nokta: POST /v1/mcp/{tenantId}/oauth/token

Kimlik doğrulama: Herkese açık, API anahtarı gerekmez · hız sınırı: 5 istek/sn (ani artışta 10)

Parametreler:

Ad	Tür	Konum	Zorunlu	Açıklama
tenantId	string	yol	Evet	Biçim: uuid

Yanıt (200):

Erişim token’ı

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

Alan	Tür	Zorunlu	Açıklama
access_token	string	Evet	POST /v1/mcp/{tenantId} için kısa ömürlü Bearer JWT
token_type	Bearer	Evet	İzin verilen değerler: Bearer
expires_in	number	Evet

Hatalar:

• 400 Hatalı istek: örneğin geçersiz bir filtre ifadesi, modeli olmayan bir süreç, desteklenmeyen bir yükleme türü veya eksik bir zorunlu alan
• 401 API anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş
• 403 API anahtarında gerekli kapsam veya kuruluş erişimi yok, kiracı etkin değil ya da plan dosya türünü engelliyor