Nesta página
> recursos > documentação > api > Servidor MCP

Servidor MCP

Enterprise Enterprise Disponível no plano Empresarial. As licenças dos planos de autoatendimento não podem usar este recurso. Comparar planos Disponível no plano Enterprise

Servidor MCP

O servidor MCP (Model Context Protocol) permite que assistentes de IA e ferramentas com IA se conectem à sua organização no ProcessMind e trabalhem diretamente com seus dados de processo. Em vez de criar uma integração personalizada, você configura seu cliente MCP para usar o servidor do ProcessMind, e o assistente pode ler processos, modelos, conjuntos de dados e resultados de simulações por meio de ferramentas MCP padrão.

O que é MCP?

MCP é um padrão aberto que define como aplicativos de IA (o “cliente”, como um IDE ou assistente de IA) se conectam a fontes de dados e ferramentas externas (o “servidor”). Ele funciona como uma porta USB-C para IA: uma conexão padrão dá aos assistentes acesso a várias ferramentas e recursos. O ProcessMind implementa um servidor MCP para que você possa usar suas ferramentas de IA atuais com os dados da sua organização, sem escrever e manter código personalizado de integração.

O que o servidor MCP oferece

O servidor expõe os mesmos dados fornecidos pela API REST, disponibilizados como ferramentas e recursos MCP. Isso inclui acesso aos seguintes dados da sua organização:

  • Processos e modelos BPMN
  • Conjuntos de dados e tabelas de dados
  • Configurações e resultados de simulações
  • Metadados da organização e do ambiente

As ferramentas disponíveis dependem da configuração do seu ambiente. Como o servidor usa a mesma API, tudo o que você pode fazer por meio da referência da API também está disponível pelo MCP.

Pré-requisitos

Antes de conectar, verifique se você tem:

  1. Uma assinatura do plano Enterprise: o servidor MCP é um recurso Enterprise
  2. Uma chave de API com acesso aos ambientes que você quer expor: consulte Chaves de API
  3. Um cliente compatível com MCP, como um IDE ou assistente com IA que aceite servidores MCP remotos

Conectando seu cliente MCP

A configuração geral é a mesma em todos os clientes MCP:

  1. Abra a configuração do servidor MCP do seu cliente
  2. Adicione um servidor remoto (HTTP) usando a URL do servidor MCP do seu ambiente
  3. Defina o cabeçalho Authorizationx-api-key com sua chave de API
  4. Salve a configuração e reinicie ou reconecte seu cliente
  5. Confirme a conexão pedindo ao seu assistente para listar seus processos

Uma entrada de configuração típica é semelhante a esta:

{
	"mcpServers": {
		"processmind": {
			"url": "<mcp-server-url>",
			"headers": {
				"x-api-key": "<your-api-key>"
			}
		}
	}
}

Use a URL do servidor MCP do seu ambiente e sua própria chave de API no cabeçalho x-api-key. (Tokens OAuth de credenciais de cliente também são compatíveis por meio do endpoint de token.)

Segurança e boas práticas

  • Mantenha sua chave de API em segredo: nunca faça commit dela no controle de versão nem a exponha em código do lado do cliente
  • Defina o escopo das chaves por ambiente: crie chaves exclusivas para acesso MCP para poder revogá-las de forma independente
  • Revise o log de auditoria: as ações realizadas pelo MCP usam sua chave de API e aparecem no Log de auditoria

Tópicos relacionados

Documentação relacionada