Pular para conteúdo

MCP servers personalizados (n8n Bepex)

Servidores MCP feitos à mão no n8n da Bepex (nós mcpTrigger + tools). São ferramentas que evoluem com o tempo, então o projeto delas (blueprint) mora aqui como fonte da verdade. Os arquivos *.blueprint.json são importáveis no n8n. Backbone da instância: ../n8n-bepex.md.

Não confundir com o MCP nativo do n8n (Instance-level MCP, OAuth, n8n.bepex.com.br/mcp-server/http), que não é workflow e não mora aqui. Estes são os personalizados, que expõem tools específicos.

Servidores

Blueprint Workflow n8n O que expõe Credencial n8n
chatwoot-bepex.blueprint.json MCP Chatwoot Bepex (nWE1aU08WJX0OG3X) 8 tools do Chatwoot chat.bepex.com.br account 2 Chatwoot Bepex (chat.bepex.com.br) (FzLnFD8cohSYSYIN, httpHeaderAuth)
google-sheets-bepex.blueprint.json MCP Google Sheets Bepex (qZH4lE2oF7M2ENVM) 2 tools de Google Sheets (append/update, read) Google Sheets account (fPTJHGlBzeJeSR1E, googleSheetsOAuth2Api)

Chatwoot (8 tools)

listar_conversas, buscar_mensagens, enviar_mensagem, atualizar_status_conversa, adicionar_label, listar_inboxes, listar_labels, buscar_contato. Base: https://chat.bepex.com.br/api/v1/accounts/2.

Google Sheets (2 tools)

sheets_append_or_update (appendOrUpdate), sheets_read (read). O OAuth do Google vive na credencial do n8n (não no Claude). Se a conta/escopo não bater com o alvo, reautenticar a credencial dentro do n8n (Sign in with Google = ação do dono da conta).

OAuth por trás da credencial fPTJHGlBzeJeSR1E (validado 2026-07-14): - Client "n8n Bepex" no projeto Google Cloud pipedrive-data-468012 (conta rafael@bepex.com.br). Redirect URI: https://n8n.bepex.com.br/rest/oauth2-credential/callback. Sheets API + Drive API habilitadas nesse projeto (o n8n Sheets precisa das duas). - O consent screen tem que ficar em Produção. Em modo Testing o Google expira o refresh token em ~7 dias e a credencial quebra sozinha (foi a causa raiz do "refresh token invalid/expired" que derrubou o MCP). App fica "não verificado" (tela de aviso 1x no login) — ok para uso interno. "Internal" não é opção enquanto o projeto estiver sem organização Workspace. - Diagnóstico e passo a passo completos no arquivo de progresso local _progresso-mcps/PROGRESSO-MCPS.md (fora do repo).

Segredo: o path do trigger

O endpoint de cada MCP é https://n8n.bepex.com.br/mcp/<PATH>, e esse <PATH> (UUID no nó mcpTrigger) é o segredo de autenticação (não há login por membro). Por isso os blueprints aqui trazem <<GERAR_NOVO_UUID_NO_IMPORT>> no lugar do path. O valor real vive só no n8n. Tratar como segredo (não commitar; rotacionar trocando o path do trigger).

Instalar / importar

  1. No n8n: Workflows > Import from File e escolher o *.blueprint.json.
  2. Gerar um path novo: setar parameters.path e webhookId do nó MCP Server Trigger com um UUID novo (iguais entre si).
  3. Religar a credencial (o ID é específico da instância; remapear pela credencial equivalente).
  4. Salvar e ativar o workflow.
  5. Pegar o endpoint: https://n8n.bepex.com.br/mcp/<PATH>.

Conectar no Claude

  • Pessoal (recomendado p/ estes, que são path-auth): no chat, + > Conectores > Adicionar conector > Web. Nome + a URL do endpoint. Sem OAuth (o path é o segredo).
  • Org-wide: Configurações da org > Conectores > Adicionar > Personalizado > Web. Só faça isso se aceitar que fica disponível pra org (lembrando: path-auth, sem login por membro).

Melhorar um tool

Editar aqui o blueprint (fonte da verdade) E aplicar no n8n. Para adicionar/editar tool no workflow vivo sem quebrar a sessão MCP, seguir o processo de deploy da skill n8n-mcp-builder (PATCH via browser + reativar com versionId fresh; nunca o MCP patchear a si mesmo).

Pendências (2026-07-14)

  • Construídos do conhecimento documentado, não do blueprint da agência Laços. Conferir contra os blueprints originais quando disponíveis.
  • ~~tools/list validado ponta a ponta~~ FEITO: Chatwoot (listar_inboxes com dados reais) e Google Sheets (sheets_read retornou linhas reais de planilha do rafael@bepex.com.br) validados ao vivo via conector.
  • ~~Google Sheets: confirmar credencial fPTJHGlBzeJeSR1E~~ CONFIRMADO: é a conta certa (rafael@bepex.com.br), reautenticada e com OAuth publicado em Produção (ver seção Google Sheets acima).