Automatisch MCP Server

Conecte assistentes de IA ao Automatisch para automação de fluxos de trabalho.

GitHub
7

Documentação

MseeP.ai Security Assessment Badge

Automatisch MCP Server

npm version npm downloads bundle size

Um servidor Model Context Protocol (MCP) que fornece aos assistentes de IA acesso às capacidades de automação de fluxos de trabalho do Automatisch.

Visão Geral

Este servidor MCP permite que assistentes de IA interajam com o Automatisch, uma alternativa de código aberto ao Zapier para automação de fluxos de trabalho. Ele fornece ferramentas para gerenciar fluxos de trabalho, conexões, execuções e integrações de aplicativos.

Recursos

Ferramentas Disponíveis

  • Gerenciamento de Fluxos de Trabalho: Criar, ler, atualizar, excluir e testar fluxos de trabalho
  • Gerenciamento de Conexões: Gerenciar conexões e credenciais de aplicativos
  • Monitoramento de Execuções: Visualizar histórico e status de execuções de fluxos de trabalho
  • Descoberta de Aplicativos: Navegar pelos aplicativos disponíveis e suas capacidades
  • Testes: Testar fluxos de trabalho com dados de exemplo

Recursos Fornecidos

  • Visão geral dos fluxos de trabalho com resumo de status
  • Listagem de conexões de aplicativos
  • Catálogo de aplicativos disponíveis
  • Registro de execuções recentes

Pré-requisitos

  • Node.js 18+
  • Instância do Automatisch em execução
  • Acesso à API do Automatisch (chave de API recomendada)

Instalação

  1. Clone ou baixe o código do servidor MCP

  2. Instale as dependências:

    npm install

  3. Compile o projeto:

    npm run build

Configuração

Defina as variáveis de ambiente:

# Automatisch instance URL (default: http://localhost:3001)
export AUTOMATISCH_BASE_URL="http://your-automatisch-instance:3001"

# API key for authentication (optional but recommended)
export AUTOMATISCH_API_KEY="your-api-key"

Uso

Integração com Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "automatisch": {
      "command": "npx",
      "args": ["-y", "automatisch-mcp-server"],
      "env": {
        "AUTOMATISCH_BASE_URL": "http://localhost:3001",
        "AUTOMATISCH_API_KEY": "your-api-key"
      }
    }
  }
}

Uso Autônomo

npm start

Ferramentas Disponíveis

Gerenciamento de Fluxos de Trabalho

  • list_workflows - Listar todos os fluxos de trabalho com filtragem opcional
  • get_workflow - Obter informações detalhadas do fluxo de trabalho
  • create_workflow - Criar novo fluxo de trabalho
  • update_workflow - Atualizar fluxo de trabalho existente
  • delete_workflow - Excluir fluxo de trabalho
  • test_workflow - Testar fluxo de trabalho com dados de exemplo

Gerenciamento de Conexões

  • list_connections - Listar conexões de aplicativos
  • create_connection - Criar nova conexão de aplicativo

Monitoramento e Descoberta

  • list_executions - Visualizar histórico de execuções de fluxos de trabalho
  • get_available_apps - Navegar pelos aplicativos e integrações disponíveis

Exemplo de Uso com Assistente de IA

# List all active workflows
"Show me all active workflows"

# Create a new workflow
"Create a workflow named 'Email Notifications' that sends emails when new GitHub issues are created"

# Check recent executions
"Show me the recent workflow executions and their status"

# Get workflow details
"Tell me about the workflow with ID 'abc123'"

# List available apps
"What apps are available for integration?"

Endpoints da API

O servidor interage com estes endpoints da API do Automatisch:

  • GET /api/flows - Listar fluxos de trabalho
  • POST /api/flows - Criar fluxo de trabalho
  • PATCH /api/flows/:id - Atualizar fluxo de trabalho
  • DELETE /api/flows/:id - Excluir fluxo de trabalho
  • GET /api/connections - Listar conexões
  • POST /api/connections - Criar conexão
  • GET /api/executions - Listar execuções
  • GET /api/apps - Listar aplicativos disponíveis

Desenvolvimento

Executando em Modo de Desenvolvimento

npm run dev

Compilação

npm run build

Limpeza de Arquivos de Compilação

npm run clean

Tratamento de Erros

O servidor inclui tratamento abrangente de erros:

  • Problemas de conectividade de rede com o Automatisch
  • Respostas de API inválidas
  • Parâmetros obrigatórios ausentes
  • Falhas de autenticação

Os erros são registrados e retornados como respostas estruturadas ao assistente de IA.

Considerações de Segurança

  • Use chaves de API para autenticação quando disponíveis
  • Garanta que a instância do Automatisch esteja devidamente protegida
  • Limite o acesso à rede a fontes confiáveis
  • Atualize regularmente as dependências

Solução de Problemas

Problemas Comuns

  1. Falha na Conexão: Verifique se AUTOMATISCH_BASE_URL está correto e acessível
  2. Erro de Autenticação: Verifique se AUTOMATISCH_API_KEY é válido
  3. Ferramenta Não Encontrada: Garanta que o servidor MCP esteja devidamente registrado com o Claude Desktop
  4. Erros de API: Verifique os logs do Automatisch para obter informações detalhadas sobre erros

Modo de Depuração

Ative o registro de depuração definindo:

export NODE_ENV=development

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça suas alterações
  4. Adicione testes, se aplicável
  5. Envie um pull request

Licença

Este projeto é licenciado sob a Licença MIT.

Projetos Relacionados

Suporte

Para problemas relacionados a: