Agentes de IA (MCP)
O PostClaw oferece um servidor remoto de Model Context Protocol. Conecte um assistente de IA e peça com suas palavras: “escreva três posts para a próxima semana e agende na minha Página do Facebook”. O assistente verifica seus canais, rascunha os posts e os coloca no seu calendário, em seu nome.
Disponível em todos os planos, incluindo o Free. Os limites do seu plano valem exatamente como no app.
O que você precisa
- Uma conta PostClaw com pelo menos um canal conectado.
- Um cliente MCP que envie um cabeçalho
Authorizationvia Streamable HTTP: Claude Code, Cursor, VS Code e a maioria dos outros clientes MCP. - Um token criado em Configurações → Agentes de IA.
Claude.ai e ChatGPT no navegador ainda não são compatíveis. Eles exigem login OAuth, que está planejado.
Conecte em dois minutos
- Abra Configurações → Agentes de IA e clique em Novo token.
- Dê um nome fácil de reconhecer (por exemplo, “Cursor no meu notebook”) e escolha as permissões.
- Copie o token. Ele aparece só uma vez. Se perder, revogue e crie outro.
- Adicione o servidor ao seu cliente. A página de configurações mostra estes trechos já com o seu token.
URL do servidor: https://app.postclaw.fun/mcp
Claude Code
claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"postclaw": {
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"postclaw": {
"type": "http",
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Depois pergunte ao assistente algo como “Quais canais eu tenho no PostClaw?” para testar a conexão.
Permissões
Cada token tem suas próprias permissões. O assistente só vê as ferramentas que o token permite.
| Permissão | O que o assistente pode fazer |
|---|---|
| Ler (sempre ativa) | Ver canais, posts, mídia e métricas, e receber sugestões de horário |
| Escrever | Criar e editar rascunhos, enviar mídia, escrever posts com IA, criar imagens com IA |
| Publicar (desativada por padrão) | Agendar, publicar, desagendar e excluir posts nas suas contas reais |
Sem Publicar, o assistente só deixa rascunhos para você revisar e aprovar no PostClaw. Ative apenas para assistentes em que você confia para postar em seu nome.
Você pode ter até 10 tokens ativos. A revogação vale a partir da próxima solicitação do assistente.
Ferramentas
| Ferramenta | Permissão | O que faz |
|---|---|---|
list_channels | Ler | Contas e páginas conectadas onde você pode publicar |
list_posts, get_post | Ler | Rascunhos, posts agendados e publicados, com links e erros |
get_analytics | Ler | Totais, divisão por plataforma, melhores horários, posts em destaque |
suggest_posting_times | Ler | Bons horários por plataforma |
list_media | Ler | Mídias enviadas recentemente |
generate_post | Escrever | Texto do post a partir de um briefing, opcionalmente na voz da sua marca |
adapt_post | Escrever | Um conteúdo reescrito para cada plataforma |
create_image | Escrever | Imagens com IA para seus posts |
upload_media, add_media_to_post | Escrever | Anexar suas próprias imagens e vídeos |
create_post, update_post | Escrever | Criar e editar rascunhos; informar um horário agenda o post (requer Publicar) |
publish_post | Publicar | Publicar agora e retornar o link de cada plataforma |
unschedule_post | Publicar | Voltar um post agendado para rascunho |
delete_post | Publicar | Remover um post do PostClaw |
A mídia deve ser uma URL https:// ou um arquivo enviado por upload_media.
create_post e publish_post aceitam um idempotency_key opcional. Se o assistente repetir a chamada com a mesma chave em até 24 horas, o PostClaw devolve o primeiro resultado em vez de criar ou publicar duas vezes.
Limites e créditos
O assistente trabalha com o mesmo plano que você usa no app:
- Posts por mês, créditos de IA e cota de imagens contam igual no PostClaw e pelo assistente.
- As ferramentas de IA usam sua própria chave de IA se você conectou uma nas configurações.
- Cada token pode fazer até 60 solicitações por minuto.
- Cada chamada fica registrada na sua conta.
Solução de problemas
| O que você vê | Por quê | O que fazer |
|---|---|---|
401 / “invalid token” | O token está errado ou foi revogado | Crie um token novo e atualize seu cliente |
429 | Mais de 60 solicitações por minuto de um token | Aguarde alguns segundos; a resposta informa quanto |
| Falta uma ferramenta | O token não tem a permissão necessária | Crie um token com essa permissão |
scope_missing | Agendar ou publicar sem a permissão Publicar | Ative Publicar em um token novo ou agende pelo app |
quota_exceeded, credit_cap_exceeded | O limite mensal do seu plano acabou | Aguarde o próximo período ou faça upgrade |
| ”your … configuration failed” | Sua própria chave de IA retornou erro (cota, cobrança, login expirado) | Corrija ou remova a chave em Configurações → Providers |
Mantenha seus tokens seguros
Um token age como você. Trate-o como uma senha:
- Não faça commit em repositórios nem cole em chats compartilhados.
- Use um token por dispositivo ou ferramenta, para revogar um sem afetar os outros.
- Revogue os tokens que não usa mais em Configurações → Agentes de IA.