Reference API: MCP

Server MCP umožňuje AI asistentům komunikovat s ProcessMind prostřednictvím Model Context Protocol. Používá JSON-RPC 2.0 přes Streamable HTTP: odešlete initialize a potom tools/list, abyste získali seznam dostupných nástrojů. Nástroje pro čtení, například list_processes, se zobrazí pouze tehdy, když má API key oprávnění read. Nástroje pro zápis vyžadují oprávnění write. Nástroj s argumenty zavoláte pomocí tools/call. Informace sdílené mezi relacemi lze ukládat pomocí paměťových nástrojů (remember, recall, forget). Dlouho běžící generování AI se sleduje pro každé volání nástroje: v _meta["io.modelcontextprotocol/related-task"] připojte odkaz na úlohu a ProcessMind spolu s odpovědí na volání vrátí její stav. Rozšiřující metody tasks/list, tasks/get a tasks/cancel nejsou dostupné.

Endpoint serveru Model Context Protocol (JSON-RPC přes Streamable HTTP)

JSON-RPC 2.0 přes Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Nástroje pro čtení vyžadují oprávnění read API key, nástroje pro zápis oprávnění write. Seznam nástrojů najdete v příručce MCP. Ověřte se pomocí x-api-key nebo Authorization: Bearer <token> (token z OAuth token endpointu).

Endpoint: POST /v1/mcp/{tenantId}

Ověření: API key s oprávněním pro tenant · oprávnění read · limit 20 požadavků/s (nárazově 40)

Parametry:

Název	Typ	Umístění	Povinné	Popis
tenantId	string	path	Ano	Formát: uuid

Tělo požadavku:

Požadavek MCP JSON-RPC

{}

Odpověď (200):

Odpověď MCP JSON-RPC

{
	"message": "string"
}

Pole	Typ	Povinné	Popis
message	string	Ano

Chyby:

• 401 Chybí API key, je neplatný, deaktivovaný nebo jeho platnost vypršela
• 403 API key nemá požadované oprávnění ani přístup k organizaci, tenant je neaktivní nebo tarif nepovoluje daný typ souboru

Autorizační endpoint OAuth 2.1 (PKCE), přesměruje zpět na redirect_uri pomocí 302 s parametrem ?code=…

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

Ověření: Veřejný, bez API key · limit 10 požadavků/s (nárazově 20)

Parametry:

Název	Typ	Umístění	Povinné	Popis
tenantId	string	path	Ano	Formát: uuid
client_id	string	query	Ano
redirect_uri	string	query	Ano	Formát: uri
code_challenge	string	query	Ano
code_challenge_method	S256	query	Ne	Povolené hodnoty: S256
state	string	query	Ne

Chyby:

• 302 Přesměrování na redirect_uri s parametry code + state
• 400 Chybný požadavek, například neplatný výraz filtru, proces bez modelu, nepodporovaný typ nahrávaného souboru nebo chybějící povinné pole
• 401 Chybí API key, je neplatný, deaktivovaný nebo jeho platnost vypršela

Token endpoint OAuth 2.0 (client_credentials nebo authorization_code + PKCE)

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

Ověření: Veřejný, bez API key · limit 5 požadavků/s (nárazově 10)

Parametry:

Název	Typ	Umístění	Povinné	Popis
tenantId	string	path	Ano	Formát: uuid

Odpověď (200):

Přístupový token

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

Pole	Typ	Povinné	Popis
access_token	string	Ano	Krátkodobý Bearer JWT pro POST /v1/mcp/{tenantId}
token_type	Bearer	Ano	Povolené hodnoty: Bearer
expires_in	number	Ano

Chyby:

• 400 Chybný požadavek, například neplatný výraz filtru, proces bez modelu, nepodporovaný typ nahrávaného souboru nebo chybějící povinné pole
• 401 Chybí API key, je neplatný, deaktivovaný nebo jeho platnost vypršela
• 403 API key nemá požadované oprávnění ani přístup k organizaci, tenant je neaktivní nebo tarif nepovoluje daný typ souboru