Pular para o conteúdo principal

Conectar n8n, Make e Zapier

As plataformas de automação conseguem se conectar a um servidor MCP externo. Como o Senso MCP é um servidor MCP padrão, n8n, Make e Zapier podem usar as ferramentas do seu site em seus fluxos de trabalho, com ou sem um agente de IA.


Preparar o site

Para uma automação, prefira o token de API do Joomla ao OAuth: sem tela de consentimento e sem token que precise ser renovado por uma pessoa.

  1. Crie um usuário Joomla dedicado à automação, em um grupo limitado ao que ela precisa fazer (por exemplo, Editor ou Publisher para conteúdo). Não reutilize uma conta de Super Usuário.
  2. Verifique se esse grupo tem a permissão API Login (Usuários → Grupos → permissões do componente Usuários).
  3. No perfil desse usuário, na aba Token de API, ative e copie o token.
  4. Anote a URL do servidor: https://seu-site.tld/api/index.php/v1/mcp.

n8n

O n8n oferece dois nós. O MCP Client Tool é conectado a um nó AI Agent: o agente descobre todas as ferramentas do seu site e escolhe sozinho quais chamar. O nó MCP Client é usado sem agente, para chamar uma ferramenta específica em um workflow tradicional, como criar um artigo a cada nova linha de uma planilha.

A configuração é a mesma nos dois casos:

  • Endpoint: a URL do servidor MCP;
  • Transport: HTTP Streamable;
  • Authentication: Bearer Auth, com uma credencial contendo o token de API;
  • para o nó MCP Client: operação Execute Tool, seguida do nome da ferramenta e de seus argumentos em JSON.

Make

O Make oferece o módulo MCP Client para cenários e um botão Add MCP nos AI Agents. Crie uma conexão com a URL do servidor e a autenticação por token (cabeçalho Authorization: Bearer <token>); as ferramentas do seu site aparecerão ao lado dos módulos do Make. Em um cenário, o módulo lista as ferramentas e chama uma delas com os argumentos desejados; em um agente, quem decide é o modelo.

Zapier

A integração MCP Client do Zapier conecta um servidor MCP remoto via HTTP streamable e disponibiliza suas ferramentas como ações de um Zap. Adicione o aplicativo MCP Client, crie uma conexão com a URL do servidor e o token de API, depois escolha a ferramenta do seu site como ação e associe seus argumentos aos dados do gatilho. Essa integração ainda é indicada como beta pelo Zapier: a interface pode mudar.

Outras plataformas

Qualquer plataforma que disponha de um módulo HTTP Request pode chamar o servidor sem um cliente MCP: MCP nada mais é do que JSON-RPC sobre HTTP. Basta fazer um POST para a URL do servidor, com o cabeçalho Authorization: Bearer <token> e um corpo tools/call. Os exemplos completos (lista de ferramentas e chamada de uma ferramenta) estão em Conectar outro cliente MCP.

Boas práticas

  • uma conta e um token por automação, para revogar um sem afetar os demais;
  • permissões do Joomla limitadas ao estritamente necessário: a ACL se aplica às chamadas por token exatamente como aos assistentes;
  • em caso de dúvida, ative o modo somente leitura do Senso MCP durante os testes do workflow;
  • armazene o token nas credenciais criptografadas da plataforma, nunca em texto puro em um nó.

Documentação oficial