# Chaves de API e assistentes de IA (MCP)

O Postbird foi criado para que um assistente de IA ou as suas próprias ferramentas possam efetuar publicações. O Claude, o ChatGPT, o Claude Code, o Cursor, o n8n, o Make ou os seus próprios scripts podem planear e publicar conteúdos para as suas marcas. Tudo se encontra no separador **API e MCP**.

::: master-only
<figure><img src="../.gitbook/assets/v2-postbird-api.png" alt="A página de API e MCP: Ligue um assistente de IA com o endereço MCP, separadores de configuração para Claude, ChatGPT, Claude Code, Cursor e n8n, Make, scripts com passos numerados, e abaixo a secçã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 as suas chaves de API.</p></figcaption></figure>
:::

## Ligar um assistente de IA

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

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

- **Claude** (web ou desktop): Definições, Conectores, **Adicionar conector personalizado**, dê-lhe o nome Postbird e cole o endereço. Clique em **Adicionar**, depois em **Ligar** e aprove o início de sessão.
- **ChatGPT**: Definições, Conectores (ou Apps), **Criar**, dê-lhe o nome Postbird, cole o endereço e escolha OAuth como início de sessão. Guarde, ligue e aprove.
- **Claude Code** e **Cursor**: cole o endereço com uma chave de API (abaixo). O separador de cada um mostra os passos exatos.

Uma vez ligado, o assistente pode listar as suas marcas e canais, redigir, agendar e publicar publicações, adicionar imagens a partir de uma ligação, ler o calendário e o registo de publicações, e importar muitas publicações de uma só vez (verifique-as primeiro, importe-as e anule a importação, se necessário). Basta pedir-lhe, por exemplo, "agenda uma publicação sobre o nosso menu de primavera em todos os canais da Sunrise Dental para sexta-feira às 10:00". Também pode sugerir hashtags por rede, manter os seus grupos de hashtags guardados, criar imagens com IA para os conteúdos multimédia da marca, e ler e responder aos comentários nas suas publicações na [Caixa de entrada](inbox.md): responder, colocar gosto, ocultar ou eliminar onde a rede o permita, marcar conversas como concluídas e sugerir uma resposta. Os rascunhos de IA, sugestões de hashtags, imagens de IA e respostas sugeridas pedidas através de um assistente têm o mesmo custo que na aplicação ([Escrever com IA e Hashtags](ai-drafts.md)).

## Chaves de API

Uma chave permite que uma ferramenta aja em seu nome nas suas marcas, sem precisar da sua palavra-passe.

1. Em **Chaves de API**, dê um nome à chave (por exemplo, "Claude Code no meu portátil").
2. Selecione **Apenas leitura** se a ferramenta apenas dever consultar marcas, canais, publicações e o calendário, sem criar, alterar ou publicar nada.
3. Clique em **Criar chave** e copie-a imediatamente. As chaves começam por `pb_live_`. Por motivos de segurança, é mostrada apenas uma vez; se a perder, revogue-a e crie uma nova.

Crie uma chave por ferramenta, para que possa desativar uma única ferramenta mais tarde com **Revogar**. Qualquer pessoa que possua uma chave pode publicar em nome das suas marcas, por isso trate-a como uma palavra-passe.

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

## Pedidos web simples (n8n, Make, scripts)

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