Servidor MCP do Flowlu

O servidor MCP do Flowlu permite que assistentes de IA como Claude, Cursor e Windsurf trabalhem diretamente com seus dados do Flowlu: criando oportunidades, consultando projetos, atualizando tarefas, extraindo resumos financeiros e muito mais, tudo a partir de uma única conversa.

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA interajam perfeitamente com serviços externos por meio de uma interface unificada. Em vez de transferir dados manualmente, você pode descrever sua tarefa em linguagem natural e a IA lidará com a interação usando a ferramenta apropriada para concluí-la.

Capacidades e Módulos Disponíveis

O servidor MCP do Flowlu funciona através da API da plataforma, realizando todas as ações em nome do usuário associado à chave de API fornecida. Isso garante que as permissões, o acesso aos dados e as restrições sigam estritamente a configuração da sua conta.

O MCP fornece acesso a todos os principais módulos da plataforma. Para os módulos de CRM, Projetos, Tarefas, Agile e Controle de tempo, o servidor MCP do Flowlu possui acesso de leitura e escrita. Para os módulos de Finanças, Produtos, Calendário e Campos personalizados, ele possui acesso apenas de leitura.

Modo de Visualização Prévia: Segurança Integrada para Cada Gravação

Antes de criar ou atualizar qualquer registro no Flowlu, a IA mostra uma visualização completa de exatamente o que planeja gravar, campo por campo. Nada é executado até que você confirme explicitamente. Isso se aplica a todas as operações de escrita: criação de registros, atualização de registros e adição de comentários. Sem a sua confirmação, nenhum dado é alterado. Se algo parecer errado na visualização, você pode corrigir seu comando (prompt) e tentar novamente antes que qualquer coisa seja salva.

Ferramentas de IA Disponíveis

O servidor MCP do Flowlu fornece 11 ferramentas especializadas que a IA utiliza para interagir com seus dados:

Navegação na Estrutura de Dados

1. describe_modules: Fornece uma visão geral de todos os módulos e seus entidades. A IA chama essa função para entender o que está disponível em seu espaço de trabalho do Flowlu antes de realizar qualquer ação.
2. describe_entity: Revela o esquema de uma entidade específica, incluindo campos, tipos, descrições, chaves estrangeiras e listas relacionadas disponíveis. A IA usa isso antes de criar ou atualizar um registro para garantir que os nomes e formatos dos campos estejam corretos.

Recuperação de Dados

1. list_records: Recupera uma lista de registros para qualquer entidade com suporte a busca e paginação (até 100 por solicitação). É isso que roda quando você pede algo como "mostre-me todos os negócios abertos".
2. get_record: Recupera um único registro por seu ID exclusivo. Usado quando você solicita detalhes de um negócio, tarefa ou contato específico.
3. list_related: Busca registros vinculados via aliases, por exemplo, subtarefas de uma tarefa ou itens de uma fatura.
4. list_comments: Recupera comentários anexados a um registro específico. Usado quando você pergunta "qual é a última atualização deste negócio?".
5. list_files: Lista arquivos anexados a um registro específico. Usado quando você pergunta "há algum documento nesta tarefa?".
6. list_users: Exibe uma lista de usuários da conta. A IA precisa disso para encontrar a pessoa certa quando você diz "atribua isto à Maria" ou "quem é o responsável por esta tarefa?".

Entrada de Dados

1. create_record: Cria um novo registro. Utiliza o modo de visualização prévia: sem confirmação, a IA mostra o que pretende criar. Ela só salva os dados quando você confirma.
2. update_record: Atualiza um registro existente por ID, também usando o modo de visualização prévia.
3. create_comment: Adiciona um comentário a um registro, com visualização prévia antes da postagem.

Limitações e Restrições Rígidas

O servidor MCP do Flowlu opera dentro do escopo dos métodos padrão da API (list, get, create e update) e é estritamente regido pelas permissões atribuídas à chave de API do proprietário. Embora seja uma ferramenta poderosa para gerenciamento de dados, possui várias fronteiras técnicas:

• Os módulos de Finanças, Produtos, Calendário e Campos personalizados são apenas para leitura. Você pode consultar dados desses módulos, mas não pode criar ou atualizar registros neles.
• O MCP não aciona processos de negócios internos não padrão nem inicia automaticamente as regras de automação de fluxo de trabalho do Flowlu.
• Não há ferramenta de exclusão disponível; toda remoção de dados deve ser realizada manualmente na interface do Flowlu.
• Embora você possa listar arquivos e ver seus metadatos, a IA não pode fazer upload de novos arquivos nem ler o conteúdo real dos documentos.
• O MCP não pode ser usado para enviar e-mails ou exportar dados para formatos CSV, Excel ou PDF.
• Não fornece acesso às Configurações do sistema, configurações da conta ou configuração de webhooks de saída.
• Você pode listar usuários, mas não pode criar, atualizar ou desativar contas de usuário.
• Filtragem complexa e configurações de todo o sistema ainda são melhor gerenciadas diretamente pela interface do Flowlu.
• O uso requer um cliente de IA externo que suporte especificamente o Model Context Protocol.

Configuração da Conexão

Para se conectar ao MCP do Flowlu, primeiro você precisa criar uma chave de API. Você pode fazer isso acessando as configurações da conta.

Em seguida, vá para a seção de Configurações da API.

E clique no botão Adicionar.

Insira o nome da chave de API, selecione os aplicativos necessários e clique no botão Salvar.

Salve sua chave de API.

Nota: Você não poderá visualizar a chave de API novamente.

Para configurar o MCP, você também precisará do código da conta, que pode ser encontrado na barra de endereços do seu navegador. Por exemplo, se a sua barra de endereços exibir https://mycompany.flowlu.com, o seu código de conta é mycompany.

Depois disso, você poderá adicionar a configuração do MCP do Flowlu nas configurações da sua ferramenta de IA. Cole a sua chave de API e o código da conta na configuração.

{
  "mcpServers": {
    "flowlu": {
      "url": "https://mcp.flowlu.com/mcp",
      "headers": {
        "x-account-code": "<your-account-code>",
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Uma lista de ferramentas compatíveis e links para a documentação de configuração do servidor MCP são fornecidos abaixo.

Ferramentas de IA Compatíveis

O MCP do Flowlu conta com autorização de cabeçalho estático, uma abordagem comumente suportada. As seguintes ferramentas de IA estão prontas para uso sem configuração adicional.

Nota: A versão web do Claude (Claude.ai) não suporta MCP atualmente. Você deve usar o aplicativo Claude Desktop.

FAQ (Perguntas Frequentes)

O que acontece se a IA cometer um erro?

Cada ação de criação e atualização passa primeiro por uma etapa de visualização prévia. A IA apresenta o que está prestes a gravar e nada acontece até que você confirme. Se algo parecer errado, você simplesmente não confirma e corrige o comando.

Isso funciona com o Claude na web (claude.ai)?

Não no momento. A versão web do Claude não suporta conexões MCP. Você precisará do Claude Desktop (o aplicativo) ou do Claude Code (CLI). Cursor, Windsurf, VS Code Copilot e os outros clientes listados também funcionam.

Existem limites de taxa?

O servidor MCP funciona através da API do Flowlu, portanto, aplicam-se os limites de taxa de API padrão. Para uso típico (criar registros, executar consultas, extrair relatórios), é improvável que você os atinja.

Posso usar o MCP e a interface web do Flowlu ao mesmo tempo?

Sim. A conexão MCP não bloqueia nada. Você pode ter a interface do Flowlu aberta no seu navegador enquanto seu assistente de IA trabalha via MCP. As alterações feitas por qualquer canal aparecem imediatamente.

O MCP funcionará com o ChatGPT?

O MCP funciona com qualquer cliente de IA que suporte o protocolo. Até o momento, os clientes testados incluem Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, Codex (OpenAI), Continue e Cline. Se o ChatGPT ou outras ferramentas adicionarem suporte ao MCP, o servidor do Flowlu funcionará com elas automaticamente.

Se você tiver quaisquer problemas ou preocupações, entre em contato com nosso suporte ao cliente através do chat no aplicativo ou envie um e-mail para [email protected]