Pular para o conteúdo

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 Authorization via 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

  1. Abra Configurações → Agentes de IA e clique em Novo token.
  2. Dê um nome fácil de reconhecer (por exemplo, “Cursor no meu notebook”) e escolha as permissões.
  3. Copie o token. Ele aparece só uma vez. Se perder, revogue e crie outro.
  4. 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ãoO que o assistente pode fazer
Ler (sempre ativa)Ver canais, posts, mídia e métricas, e receber sugestões de horário
EscreverCriar 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

FerramentaPermissãoO que faz
list_channelsLerContas e páginas conectadas onde você pode publicar
list_posts, get_postLerRascunhos, posts agendados e publicados, com links e erros
get_analyticsLerTotais, divisão por plataforma, melhores horários, posts em destaque
suggest_posting_timesLerBons horários por plataforma
list_mediaLerMídias enviadas recentemente
generate_postEscreverTexto do post a partir de um briefing, opcionalmente na voz da sua marca
adapt_postEscreverUm conteúdo reescrito para cada plataforma
create_imageEscreverImagens com IA para seus posts
upload_media, add_media_to_postEscreverAnexar suas próprias imagens e vídeos
create_post, update_postEscreverCriar e editar rascunhos; informar um horário agenda o post (requer Publicar)
publish_postPublicarPublicar agora e retornar o link de cada plataforma
unschedule_postPublicarVoltar um post agendado para rascunho
delete_postPublicarRemover 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 revogadoCrie um token novo e atualize seu cliente
429Mais de 60 solicitações por minuto de um tokenAguarde alguns segundos; a resposta informa quanto
Falta uma ferramentaO token não tem a permissão necessáriaCrie um token com essa permissão
scope_missingAgendar ou publicar sem a permissão PublicarAtive Publicar em um token novo ou agende pelo app
quota_exceeded, credit_cap_exceededO limite mensal do seu plano acabouAguarde 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.