API-Referenz: MCP

Der MCP-Server ermöglicht KI-Assistenten die Interaktion mit ProcessMind über das Model Context Protocol. Er verwendet JSON-RPC 2.0 über Streamable HTTP: Senden Sie initialize und anschließend tools/list, um den Werkzeugkatalog abzurufen. Lese-Werkzeuge wie list_processes werden nur aufgeführt, wenn der API-Schlüssel den Lese-Geltungsbereich hat. Für Schreibwerkzeuge ist der Schreib-Geltungsbereich erforderlich. Verwenden Sie tools/call, um ein Werkzeug mit seinen Argumenten aufzurufen. Mit den Speicherwerkzeugen (remember, recall, forget) lassen sich Informationen sitzungsübergreifend speichern. Lang laufende KI-Generierungen werden pro Werkzeugaufruf nachverfolgt: Fügen Sie in _meta["io.modelcontextprotocol/related-task"] eine Aufgabenreferenz hinzu. ProcessMind gibt den Status dieser Aufgabe mit dem Aufruf zurück. Die Erweiterungsmethoden tasks/list, tasks/get und tasks/cancel werden nicht bereitgestellt.

Model Context Protocol-Serverendpunkt (JSON-RPC über Streamable HTTP)

JSON-RPC 2.0 über Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. Für Lese-Werkzeuge ist der Geltungsbereich read des Schlüssels erforderlich, für Schreibwerkzeuge der Geltungsbereich write. Der Werkzeugkatalog ist in der MCP-Anleitung dokumentiert. Authentifizieren Sie sich mit x-api-key oder Authorization: Bearer <token> (Token vom OAuth-Token-Endpunkt).

Endpunkt: POST /v1/mcp/{tenantId}

Authentifizierung: Mandantenbezogener API-Schlüssel · Geltungsbereich read · Ratenbegrenzung: 20 Anfragen/s (Spitze: 40)

Parameter:

Name	Typ	Speicherort	Erforderlich	Beschreibung
tenantId	string	Pfad	Ja	Format: uuid

Anfragetext:

MCP-JSON-RPC-Anfrage

{}

Antwort (200):

MCP-JSON-RPC-Antwort

{
	"message": "string"
}

Feld	Typ	Erforderlich	Beschreibung
message	string	Ja

Fehler:

• 401 API-Schlüssel fehlt, ist ungültig, deaktiviert oder abgelaufen
• 403 Dem API-Schlüssel fehlt der erforderliche Geltungsbereich oder der Zugriff auf die Organisation, der Mandant ist inaktiv oder der Tarif lässt diesen Dateityp nicht zu

OAuth-2.1-Autorisierungsendpunkt (PKCE), leitet mit 302 zurück zu redirect_uri?code=…

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

Authentifizierung: Öffentlich, kein API-Schlüssel · Ratenbegrenzung: 10 Anfragen/s (Spitze: 20)

Parameter:

Name	Typ	Speicherort	Erforderlich	Beschreibung
tenantId	string	Pfad	Ja	Format: uuid
client_id	string	Abfrage	Ja
redirect_uri	string	Abfrage	Ja	Format: uri
code_challenge	string	Abfrage	Ja
code_challenge_method	S256	Abfrage	Nein	Zulässige Werte: S256
state	string	Abfrage	Nein

Fehler:

• 302 Weiterleitung zu redirect_uri mit code + state
• 400 Ungültige Anfrage, z. B. wegen eines ungültigen Filterausdrucks, eines Prozesses ohne Modell, eines nicht unterstützten Upload-Typs oder eines fehlenden Pflichtfelds
• 401 API-Schlüssel fehlt, ist ungültig, deaktiviert oder abgelaufen

OAuth-2.0-Token-Endpunkt (client_credentials oder authorization_code + PKCE)

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

Authentifizierung: Öffentlich, kein API-Schlüssel · Ratenbegrenzung: 5 Anfragen/s (Spitze: 10)

Parameter:

Name	Typ	Speicherort	Erforderlich	Beschreibung
tenantId	string	Pfad	Ja	Format: uuid

Antwort (200):

Zugriffstoken

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

Feld	Typ	Erforderlich	Beschreibung
access_token	string	Ja	Kurzlebiges Bearer-JWT für POST /v1/mcp/{tenantId}
token_type	Bearer	Ja	Zulässige Werte: Bearer
expires_in	number	Ja

Fehler:

• 400 Ungültige Anfrage, z. B. wegen eines ungültigen Filterausdrucks, eines Prozesses ohne Modell, eines nicht unterstützten Upload-Typs oder eines fehlenden Pflichtfelds
• 401 API-Schlüssel fehlt, ist ungültig, deaktiviert oder abgelaufen
• 403 Dem API-Schlüssel fehlt der erforderliche Geltungsbereich oder der Zugriff auf die Organisation, der Mandant ist inaktiv oder der Tarif lässt diesen Dateityp nicht zu