# Chaves de API e assistentes de IA (MCP)

O Postbird foi criado para que um assistente de IA ou suas próprias ferramentas possam realizar as postagens. Claude, ChatGPT, Claude Code, Cursor, n8n, Make ou seus próprios scripts podem planejar e publicar postagens para suas marcas. Tudo está na aba **API e MCP**.

::: master-only
<figure><img src="../.gitbook/assets/v2-postbird-api.png" alt="A página de API e MCP: Conecte um assistente de IA com o endereço MCP, guias de configuração para Claude, ChatGPT, Claude Code, Cursor e n8n, Make, scripts com etapas numeradas e, abaixo, a seção de chaves de API"><figcaption><p>API e MCP: o endereço para assistentes de IA, configuração passo a passo por assistente e suas chaves de API.</p></figcaption></figure>
:::

## Conectar um assistente de IA

MCP é a forma como os assistentes de IA se conectam a ferramentas. O endereço é:

```
https://mcp.postbird.ai/mcp
```

- **Claude** (web ou desktop): Configurações, Conectores, **Adicionar conector personalizado**, nomeie como Postbird e cole o endereço. Clique em **Adicionar**, depois em **Conectar** e aprove o login.
- **ChatGPT**: Configurações, Conectores (ou Apps), **Criar**, nomeie como Postbird, cole o endereço e escolha OAuth como login. Salve, conecte e aprove.
- **Claude Code** e **Cursor**: cole o endereço com uma chave de API (abaixo). A aba de cada um mostra os passos exatos.

Uma vez conectado, o assistente pode listar suas marcas e canais, redigir, agendar e publicar posts, adicionar imagens a partir de um link, ler o calendário e o registro de publicações, e importar vários posts de uma vez (verifique-os primeiro, importe-os e desfaça a importação, se necessário). Basta pedir, por exemplo: "agende um post sobre nosso menu de primavera em todos os canais da Sunrise Dental para sexta-feira às 10:00". Ele também pode sugerir hashtags por rede, manter seus grupos de hashtags salvos, criar imagens com IA para a mídia da marca, e ler e responder aos comentários em seus posts na [Caixa de entrada](inbox.md): responder, curtir, ocultar ou excluir onde a rede permitir, marcar conversas como concluídas e sugerir uma resposta. Rascunhos de IA, sugestões de hashtags, imagens de IA e respostas sugeridas solicitadas por meio de um assistente custam o mesmo que no aplicativo ([Escreva com IA e Hashtags](ai-drafts.md)).

## Chaves de API

Uma chave permite que uma ferramenta aja como você em suas marcas, sem precisar da sua senha.

1. Em **Chaves de API**, dê um nome à chave (por exemplo, "Claude Code no meu laptop").
2. Marque **Somente leitura** se a ferramenta deve apenas visualizar marcas, canais, postagens e o calendário, sem criar, alterar ou publicar nada.
3. Clique em **Criar chave** e copie-a imediatamente. As chaves começam com `pb_live_`. Por segurança, ela é exibida apenas uma vez; se você a perder, revogue-a e crie uma nova.

Crie uma chave por ferramenta, para que você possa desativar uma única ferramenta mais tarde com **Revogar**. Qualquer pessoa que possua uma chave pode publicar em nome de suas marcas, portanto, trate-a como uma senha.

Uma chave criada por um membro da equipe funciona com a função e as marcas desse membro, e o acompanha caso sua função mude ou ele saia da equipe. Apenas você e os Administradores podem criar chaves. Veja [Funções da equipe](team-roles.md).

## Requisições web simples (n8n, Make, scripts)

Cada ação do assistente também é uma requisição web simples. Envie sua chave no cabeçalho `X-API-Key`. O link **Descrição da API** na aba n8n, Make, scripts é uma descrição padrão de cada requisição, que o n8n e o Make podem importar diretamente.