Procesio MCP Server

Interaja com a API da plataforma de automação Procesio.

GitHub
2

Documentação

Procesio MCP Server

Este é um servidor Model Context Protocol (MCP) projetado para interagir com a API da plataforma de automação Procesio. Ele permite que modelos de linguagem e outros clientes MCP listem, visualizem e gerenciem workflows e instâncias do Procesio.

Este servidor usa autenticação por API Key/Value.

Recursos

Ferramentas

O servidor atualmente fornece as seguintes ferramentas:

  • procesio_test_authentication:
    • Descrição: Testa a autenticação por API Key/Value buscando os detalhes do usuário atual.
    • Entrada: Nenhuma
    • Saída: Objeto JSON com detalhes do usuário em caso de sucesso.
  • procesio_list_projects:
    • Descrição: Lista os modelos de processo (workflows) disponíveis no Procesio.
    • Entrada (Opcional): pageNumber (inteiro, padrão: 1), pageItemCount (inteiro, padrão: 20)
    • Saída: Objeto JSON contendo uma lista paginada de modelos de processo.
  • procesio_get_project_details:
    • Descrição: Obtém os detalhes de um modelo de processo (workflow) específico do Procesio.
    • Entrada (Obrigatória): projectId (string - UUID do modelo de processo)
    • Saída: Objeto JSON com a configuração detalhada do modelo de processo especificado.
  • procesio_launch_project:
    • Descrição: Inicia uma instância de um modelo de processo (workflow) específico do Procesio.
    • Entrada (Obrigatória): projectId (string - UUID do modelo de processo)
    • Entrada (Opcional): payload (objeto), runSynchronous (booleano), debugMode (booleano), secondsTimeOut (inteiro), connectionId (string - passado como cabeçalho)
    • Saída: Objeto JSON com detalhes sobre a instância iniciada (por exemplo, ID da instância). Observação: a inicialização pode falhar se o projeto for inválido.
  • procesio_get_instance_status:
    • Descrição: Obtém o status de uma instância de processo em execução ou concluída.
    • Entrada (Obrigatória): instanceId (string - UUID da instância do processo)
    • Entrada (Opcional): flowTemplateId (string - UUID do modelo original), isArchived (booleano)
    • Saída: Objeto JSON com os detalhes de status da instância especificada.

Configuração

Este servidor requer variáveis de ambiente para autenticação e configuração do endpoint da API. Elas podem ser fornecidas por meio de:

  1. Arquivo .env: Crie um arquivo .env na raiz do projeto (procesio-mcp-server/.env) com o seguinte conteúdo:

    PROCESIO_API_KEY='YOUR_API_KEY'
PROCESIO_API_VALUE='YOUR_API_VALUE'
PROCESIO_USERNAME='your_procesio_username' # Still needed for initial check, though not used for auth
PROCESIO_PASSWORD='your_procesio_password' # Still needed for initial check, though not used for auth
PROCESIO_WEB_API_URL='https://webapi.procesio.app/' # Or your specific instance URL
PROCESIO_REALM='procesio01' # Or your specific realm if different

  2. Arquivo de Configurações do MCP: Alternativamente, configure-as diretamente no bloco env do arquivo de configurações do seu cliente MCP (por exemplo, cline_mcp_settings.json ou claude_desktop_config.json). Este método é preferido ao executar por meio de um cliente MCP, pois garante que as variáveis sejam passadas corretamente para o processo do servidor.

    {
  "mcpServers": {
    "procesio": {
      "command": "node",
      "args": [
        "/path/to/procesio-mcp-server/build/index.js"
      ],
      "env": {
        "PROCESIO_API_KEY": "YOUR_API_KEY",
        "PROCESIO_API_VALUE": "YOUR_API_VALUE",
        "PROCESIO_USERNAME": "your_procesio_username",
        "PROCESIO_PASSWORD": "your_procesio_password",
        "PROCESIO_WEB_API_URL": "https://webapi.procesio.app/",
        "PROCESIO_REALM": "procesio01"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

    Substitua /path/to/ pelo caminho real do diretório do servidor.

Desenvolvimento

Requer Node.js (versão LTS recomendada, consulte .nvmrc).

Instalar dependências:

npm install

Compilar o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Executando Localmente (para testes)

Garanta que as variáveis de ambiente estejam definidas (por exemplo, via .env ou exportadas no seu shell).

npm run build
node build/index.js

O servidor escutará em stdio por solicitações MCP.

Certificado por MCP Review

Licença

Este projeto é licenciado sob a Apache License, Versão 2.0. Consulte o arquivo LICENSE para obter detalhes.