Referência da API: MCP

O servidor MCP permite que assistentes de IA interajam com o ProcessMind por meio do Model Context Protocol. Ele usa JSON-RPC 2.0 sobre Streamable HTTP: envie initialize e, em seguida, tools/list para consultar o catálogo de ferramentas. Ferramentas de leitura, como list_processes, só são listadas quando a chave de API tem escopo de leitura; as ferramentas de gravação exigem escopo de gravação. Use tools/call para chamar uma ferramenta com seus argumentos. As ferramentas de memória permitem armazenar informações entre sessões (remember, recall, forget), e as gerações de IA de longa duração são acompanhadas por chamada de ferramenta: inclua uma referência de tarefa em _meta["io.modelcontextprotocol/related-task"] para que o ProcessMind informe o status dessa tarefa junto com a chamada. Os métodos de extensão tasks/list, tasks/get e tasks/cancel não são disponibilizados.

Endpoint do servidor Model Context Protocol (JSON-RPC sobre Streamable HTTP)

JSON-RPC 2.0 sobre Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. As ferramentas de leitura exigem o escopo read da chave; as de gravação exigem o escopo write. O catálogo de ferramentas está documentado no guia do MCP. Autentique-se com x-api-key ou Authorization: Bearer <token> (token do endpoint de token OAuth).

Endpoint: POST /v1/mcp/{tenantId}

Autenticação: Chave de API vinculada ao ambiente · escopo read · limite de 20 solicitações/s (pico de 40)

Parâmetros:

Nome	Tipo	Localização	Obrigatório	Descrição
tenantId	string	caminho	Sim	Formato: uuid

Corpo da solicitação:

Solicitação JSON-RPC do MCP

{}

Resposta (200):

Resposta JSON-RPC do MCP

{
	"message": "string"
}

Campo	Tipo	Obrigatório	Descrição
message	string	Sim

Erros:

• 401 Chave de API ausente, inválida, desativada ou expirada
• 403 A chave de API não tem o escopo necessário ou acesso à organização, o ambiente está inativo ou o plano não permite esse tipo de arquivo

Endpoint de autorização OAuth 2.1 (PKCE), redireciona com código 302 de volta para redirect_uri com ?code=…

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

Autenticação: Público, sem chave de API · limite de 10 solicitações/s (pico de 20)

Parâmetros:

Nome	Tipo	Localização	Obrigatório	Descrição
tenantId	string	caminho	Sim	Formato: uuid
client_id	string	consulta	Sim
redirect_uri	string	consulta	Sim	Formato: uri
code_challenge	string	consulta	Sim
code_challenge_method	S256	consulta	Não	Valores permitidos: S256
state	string	consulta	Não

Erros:

• 302 Redirecionamento para redirect_uri com code + state
• 400 Solicitação inválida: por exemplo, expressão de filtro inválida, processo sem modelo, tipo de arquivo não compatível ou campo obrigatório ausente
• 401 Chave de API ausente, inválida, desativada ou expirada

Endpoint de token OAuth 2.0 (client_credentials ou authorization_code + PKCE)

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

Autenticação: Público, sem chave de API · limite de 5 solicitações/s (pico de 10)

Parâmetros:

Nome	Tipo	Localização	Obrigatório	Descrição
tenantId	string	caminho	Sim	Formato: uuid

Resposta (200):

Token de acesso

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

Campo	Tipo	Obrigatório	Descrição
access_token	string	Sim	JWT Bearer de curta duração para POST /v1/mcp/{tenantId}
token_type	Bearer	Sim	Valores permitidos: Bearer
expires_in	number	Sim

Erros:

• 400 Solicitação inválida: por exemplo, expressão de filtro inválida, processo sem modelo, tipo de arquivo não compatível ou campo obrigatório ausente
• 401 Chave de API ausente, inválida, desativada ou expirada
• 403 A chave de API não tem o escopo necessário ou acesso à organização, o ambiente está inativo ou o plano não permite esse tipo de arquivo