API referansı: MCP

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

Model Context Protocol sunucusu 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ı anahtarın read kapsamını, yazma araçları ise write kapsamını gerektirir. Araç kataloğu MCP rehberinde belgelenmiştir. x-api-key veya Authorization: Bearer <token> ile kimlik doğrulaması yapın (OAuth token uç noktasından alınan token).

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

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

Parametreler:

Ad	Tür	Konum	Gerekli	Açıklama
tenantId	string	path	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	Gerekli	Açıklama
message	string	Evet

Hatalar:

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

OAuth 2.1 yetkilendirme uç noktası (PKCE), redirect_uri adresine ?code=… ile 302 yönlendirmeleri yapar.

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ış 20)

Parametreler:

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

Hatalar:

• 302 Kod + state ile redirect_uri adresine 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 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı

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ış 10)

Parametreler:

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

Yanıt (200):

Erişim tokenı

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

Alan	Tür	Gerekli	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 Eksik, geçersiz, devre dışı veya süresi dolmuş API anahtarı
• 403 API anahtarında gerekli kapsam veya kuruluş erişimi yok, tenant etkin değil ya da plan dosya türünü engelliyor