> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Integre a API de redes sociais Ayrshare aos seus workflows n8n para publicar, agendar e analisar as contas de redes sociais dos seus usuários.

export const XByoNotice = () => <Info>
  <strong>Targeting X/Twitter?</strong> Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
  <br /><br />
  <code>X-Twitter-OAuth1-Api-Key</code> — Your API Key (Consumer Key)<br />
  <code>X-Twitter-OAuth1-Api-Secret</code> — Your API Key Secret (Consumer Secret)
  <br /><br />
  <strong>One-time setup per Ayrshare account.</strong> You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do <em>not</em> create a new app per customer.
  <br /><br />
  Not linked yet? See the <a href="/dashboard/connect-social-accounts/x-twitter-byo-keys">full setup guide</a> to connect your X account.
  <br /><br />
  Your keys are never logged or stored by Ayrshare.
</Info>;

## Visão Geral

O [n8n](https://n8n.io) é uma plataforma de automação de workflows que permite conectar aplicativos e orquestrar processos, incluindo agentes de IA, na nuvem ou auto-hospedado.

A API de redes sociais Ayrshare pode ser integrada aos seus workflows n8n para gerenciar as contas de redes sociais dos seus usuários. Uma única chamada de API publica em Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Perfil da Empresa, Snapchat e X, então você não escreve nem mantém código de API por plataforma.

Existem duas formas de conectar:

<ul class="custom-bullets">
  <li>**Servidor MCP (orientado por agente).** Anexe o [Servidor MCP Ayrshare](/additional/mcp-action-server) ao nó MCP Client Tool integrado do n8n, e seu AI Agent pode executar todo o ciclo por conta própria: rascunhar um post, validá-lo com as regras de cada rede, publicar ou agendá-lo, e depois ler as análises. Não há nada para hospedar e nenhum nó da comunidade para instalar.</li>
  <li>**API REST (workflow fixo).** Para workflows determinísticos, sem agente, chame a [API REST Ayrshare](/apis/overview) diretamente a partir de um nó HTTP Request.</li>
</ul>

Gerenciar as contas sociais dos seus usuários requer o [plano Business](/multiple-users/business-plan-overview), mas você também pode gerenciar suas próprias contas sociais com o plano Premium usando apenas a [API Key](/apis/overview#authorization) no cabeçalho da requisição.

## Como isso se conecta

Com o caminho MCP, o nó **AI Agent** é o cérebro. O sub-nó **MCP Client Tool** se conecta a ele, conecta-se ao Servidor MCP Ayrshare, descobre as ferramentas disponíveis e as expõe ao agente. Quando o agente age, o nó despacha a chamada para a Ayrshare, que publica nas redes.

```
Trigger  ->  AI Agent (+ Chat Model)  ->  MCP Client Tool  ->  Ayrshare MCP Server  ->  social networks
```

<Note>
  Use o transporte **HTTP Streamable**, não SSE. O [guia n8n](/additional/mcp-n8n) cobre transporte, autenticação e configuração em detalhes.
</Note>

## Guia

O guia completo do n8n cobre o caminho MCP-first de ponta a ponta: pré-requisitos, configuração do nó MCP Client Tool, o system prompt de validação-primeiro, exemplos trabalhados (rascunhar e publicar a partir de uma mensagem de chat, auto-publicar novo conteúdo, um resumo semanal de análises), agir em nome de clientes com sub-perfis, manter um humano no loop, o fallback REST e solução de problemas.

<Card title="Guia n8n + Ayrshare MCP" icon="book-open" href="/additional/mcp-n8n" horizontal>
  Conecte o AI Agent do n8n ao Servidor MCP Ayrshare para publicar, agendar e analisar em suas redes sociais, sem código de API por plataforma.
</Card>

<Card title="Baixe o workflow inicial do n8n" icon="download" href="/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  Um workflow pronto para importar: Chat Trigger, AI Agent, um chat model Anthropic e o nó MCP Ayrshare pré-configurados com o system prompt de validação-primeiro.
</Card>

## Publicando no X (antigo Twitter)

<XByoNotice />

No n8n, alterne a **Autenticação** do nó MCP Client Tool para **Multiple Headers** e adicione os dois cabeçalhos `X-Twitter-OAuth1-*` junto com `Authorization`. Consulte [Connect & Setup → X/Twitter BYO credentials](/additional/mcp-action-connect#xtwitter-byo-credentials).

## Saiba mais

<ul class="custom-bullets">
  <li>Saiba mais sobre o [n8n](https://n8n.io) e seus nós [AI Agent](https://docs.n8n.io/advanced-ai/) e [MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/).</li>
  <li>Veja a [visão geral do Servidor MCP](/additional/mcp-action-server) para saber o que é o servidor e como ele se relaciona com a API Ayrshare.</li>
  <li>Navegue pelo [Catálogo de Ferramentas](/additional/mcp-action-tools) para ver as ferramentas que seu agente pode chamar, agrupadas por domínio.</li>
  <li>Leia [Connect & Setup](/additional/mcp-action-connect) para detalhes de endpoint, transporte, autenticação e direcionamento de perfis.</li>
</ul>