Dokumentacja API: MCP

Serwer MCP umożliwia asystentom AI komunikację z ProcessMind za pośrednictwem Model Context Protocol. Obsługuje JSON-RPC 2.0 przez Streamable HTTP: wyślij initialize, a następnie tools/list, aby pobrać katalog narzędzi. Narzędzia do odczytu, takie jak list_processes, są widoczne tylko wtedy, gdy klucz API ma zakres read. Narzędzia do zapisu wymagają zakresu write. Użyj tools/call, aby wywołać narzędzie z argumentami. Informacje zachowywane między sesjami można zapisywać za pomocą narzędzi pamięci (remember, recall, forget). Długotrwałe generowanie przez AI jest śledzone dla każdego wywołania narzędzia: dołącz odwołanie do zadania w _meta["io.modelcontextprotocol/related-task"], a ProcessMind zwróci jego status w odpowiedzi na wywołanie. Metody rozszerzeń tasks/list, tasks/get i tasks/cancel nie są obsługiwane.

Punkt końcowy serwera Model Context Protocol (JSON-RPC przez Streamable HTTP)

JSON-RPC 2.0 przez Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Narzędzia do odczytu wymagają zakresu read klucza, a narzędzia do zapisu zakresu write. Katalog narzędzi opisano w przewodniku MCP. Uwierzytelnij się za pomocą x-api-key lub Authorization: Bearer <token> (tokenu z punktu końcowego OAuth).

Punkt końcowy: POST /v1/mcp/{tenantId}

Uwierzytelnianie: Klucz API przypisany do tenanta · zakres read · limit 20 żądań/s (seria do 40)

Parametry:

Nazwa	Typ	Lokalizacja	Wymagane	Opis
tenantId	string	ścieżka	Tak	Format: uuid

Treść żądania:

Żądanie MCP JSON-RPC

{}

Odpowiedź (200):

Odpowiedź MCP JSON-RPC

{
	"message": "string"
}

Pole	Typ	Wymagane	Opis
message	string	Tak

Błędy:

• 401 Brakujący, nieprawidłowy, wyłączony lub wygasły klucz API
• 403 Klucz API nie ma wymaganego zakresu lub dostępu do organizacji, tenant jest nieaktywny albo plan nie obsługuje tego typu pliku

Punkt końcowy autoryzacji OAuth 2.1 (PKCE), przekierowuje kodem 302 z powrotem do redirect_uri z parametrem ?code=…

Punkt końcowy: GET /v1/mcp/{tenantId}/oauth/authorize

Uwierzytelnianie: Publiczny, bez klucza API · limit 10 żądań/s (seria do 20)

Parametry:

Nazwa	Typ	Lokalizacja	Wymagane	Opis
tenantId	string	ścieżka	Tak	Format: uuid
client_id	string	zapytanie	Tak
redirect_uri	string	zapytanie	Tak	Format: uri
code_challenge	string	zapytanie	Tak
code_challenge_method	S256	zapytanie	Nie	Dozwolone wartości: S256
state	string	zapytanie	Nie

Błędy:

• 302 Przekierowanie do redirect_uri z parametrami code i state
• 400 Nieprawidłowe żądanie, np. błędne wyrażenie filtra, proces bez modelu, nieobsługiwany typ przesyłanego pliku lub brak wymaganego pola
• 401 Brakujący, nieprawidłowy, wyłączony lub wygasły klucz API

Punkt końcowy tokenu OAuth 2.0 (client_credentials lub authorization_code + PKCE)

Punkt końcowy: POST /v1/mcp/{tenantId}/oauth/token

Uwierzytelnianie: Publiczny, bez klucza API · limit 5 żądań/s (seria do 10)

Parametry:

Nazwa	Typ	Lokalizacja	Wymagane	Opis
tenantId	string	ścieżka	Tak	Format: uuid

Odpowiedź (200):

Token dostępu

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

Pole	Typ	Wymagane	Opis
access_token	string	Tak	Krótkotrwały token Bearer JWT dla POST /v1/mcp/{tenantId}
token_type	Bearer	Tak	Dozwolone wartości: Bearer
expires_in	number	Tak

Błędy:

• 400 Nieprawidłowe żądanie, np. błędne wyrażenie filtra, proces bez modelu, nieobsługiwany typ przesyłanego pliku lub brak wymaganego pola
• 401 Brakujący, nieprawidłowy, wyłączony lub wygasły klucz API
• 403 Klucz API nie ma wymaganego zakresu lub dostępu do organizacji, tenant jest nieaktywny albo plan nie obsługuje tego typu pliku