API-referencia: MCP

Az MCP-szerver lehetővé teszi, hogy az AI-asszisztensek a Model Context Protocolon keresztül kommunikáljanak a ProcessMinddel. A JSON-RPC 2.0 protokollt használja Streamable HTTP-n keresztül: küldje el a initialize üzenetet, majd a tools/list üzenetet az eszközkatalógus lekéréséhez. Az olyan olvasási eszközök, mint a list_processes, csak akkor jelennek meg, ha az API-kulcs olvasási jogosultsággal rendelkezik; az írási eszközökhöz írási jogosultság szükséges. Az eszköz meghívásához és argumentumainak megadásához használja a tools/call parancsot. A munkamenetek között megőrzendő adatok a memóriaeszközökkel tárolhatók (remember, recall, forget), a hosszabb ideig futó AI-generálások állapotát pedig a rendszer eszközhívásonként követi: adjon meg egy feladathivatkozást a _meta["io.modelcontextprotocol/related-task"] mezőben, és a ProcessMind a hívással együtt visszajelzi a feladat állapotát. A tasks/list, tasks/get és tasks/cancel kiterjesztési metódusok nem érhetők el.

Model Context Protocol szervervégpont (JSON-RPC Streamable HTTP-n keresztül)

JSON-RPC 2.0 Streamable HTTP-n keresztül: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Az olvasási eszközökhöz a kulcs read jogosultsága, az írási eszközökhöz pedig a write jogosultság szükséges. Az eszközkatalógus az MCP-útmutatóban található. Hitelesítéshez használja a x-api-key vagy a Authorization: Bearer <token> lehetőséget (a token az OAuth tokenvégponttól szerezhető be).

Végpont: POST /v1/mcp/{tenantId}

Hitelesítés: Bérlőhöz kötött API-kulcs · read jogosultság · sebességkorlát: 20 kérés/s (rövid ideig legfeljebb 40)

Paraméterek:

Név	Típus	Hely	Kötelező	Leírás
tenantId	string	útvonal	Igen	Formátum: uuid

Kérés törzse:

MCP JSON-RPC-kérés

{}

Válasz (200):

MCP JSON-RPC-válasz

{
	"message": "string"
}

Mező	Típus	Kötelező	Leírás
message	string	Igen

Hibák:

• 401 Hiányzó, érvénytelen, letiltott vagy lejárt API-kulcs
• 403 Az API-kulcs nem rendelkezik a szükséges jogosultsággal vagy szervezeti hozzáféréssel, a bérlő inaktív, vagy az előfizetési csomag nem engedélyezi a fájltípust

OAuth 2.1 engedélyezési végpont (PKCE), 302-es átirányítás vissza a redirect_uri címre ?code=… paraméterrel.

Végpont: GET /v1/mcp/{tenantId}/oauth/authorize

Hitelesítés: Nyilvános, API-kulcs nélkül · sebességkorlát: 10 kérés/s (rövid ideig legfeljebb 20)

Paraméterek:

Név	Típus	Hely	Kötelező	Leírás
tenantId	string	útvonal	Igen	Formátum: uuid
client_id	string	lekérdezés	Igen
redirect_uri	string	lekérdezés	Igen	Formátum: uri
code_challenge	string	lekérdezés	Igen
code_challenge_method	S256	lekérdezés	Nem	Engedélyezett értékek: S256
state	string	lekérdezés	Nem

Hibák:

• 302 Átirányítás a redirect_uri címre code és state paraméterrel
• 400 Hibás kérés: például érvénytelen szűrőkifejezés, modell nélküli folyamat, nem támogatott feltöltési típus vagy hiányzó kötelező mező
• 401 Hiányzó, érvénytelen, letiltott vagy lejárt API-kulcs

OAuth 2.0 tokenvégpont (client_credentials vagy authorization_code + PKCE)

Végpont: POST /v1/mcp/{tenantId}/oauth/token

Hitelesítés: Nyilvános, API-kulcs nélkül · sebességkorlát: 5 kérés/s (rövid ideig legfeljebb 10)

Paraméterek:

Név	Típus	Hely	Kötelező	Leírás
tenantId	string	útvonal	Igen	Formátum: uuid

Válasz (200):

Hozzáférési token

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

Mező	Típus	Kötelező	Leírás
access_token	string	Igen	Rövid élettartamú Bearer JWT a POST /v1/mcp/{tenantId} végponthoz
token_type	Bearer	Igen	Engedélyezett értékek: Bearer
expires_in	number	Igen

Hibák:

• 400 Hibás kérés: például érvénytelen szűrőkifejezés, modell nélküli folyamat, nem támogatott feltöltési típus vagy hiányzó kötelező mező
• 401 Hiányzó, érvénytelen, letiltott vagy lejárt API-kulcs
• 403 Az API-kulcs nem rendelkezik a szükséges jogosultsággal vagy szervezeti hozzáféréssel, a bérlő inaktív, vagy az előfizetési csomag nem engedélyezi a fájltípust