MCP Tools Reference

Depois do setup MCP, o Claude tem acesso a 5 ferramentas que cobrem o fluxo principal do Fala Cheese.

list_accounts

Lista as contas sociais conectadas na workspace ativa.

Input: nenhum

Output:

[
  {
    "id": "acc_abc",
    "platform": "linkedin",
    "handle": "andre.smythe",
    "displayName": "André Smythe",
    "active": true
  },
  ...
]

Quando o Claude chama: quando você diz "lista minhas contas" ou indica que vai criar post mas não sabe qual conta usar.

create_post

Cria post (rascunho, agendado ou publica agora).

Input:

{
  "body": "Texto do post",
  "socialAccountIds": ["acc_abc"],
  "publishNow": false,
  "scheduledAt": "2026-06-01T12:00:00Z",
  "firstComment": "...",
  "poll": {
    "question": "...",
    "options": ["A", "B"],
    "durationDays": 7
  }
}

Output:

{
  "ok": true,
  "post": { "id": "post_...", "status": "scheduled" }
}

Quando o Claude chama: quando você descreve um post e indica que quer publicar/agendar/salvar.

get_calendar

Retorna posts agendados/publicados num intervalo.

Input:

{
  "from": "2026-06-01T00:00:00Z",
  "to": "2026-06-07T23:59:59Z",
  "status": "scheduled"
}

Output: array de posts com status, plataforma, datetime.

Quando o Claude chama: quando você pergunta "o que tenho agendado essa semana" ou "tem post pra amanhã".

list_comments

Lista comentários do Inbox da workspace.

Input:

{
  "platform": "instagram",
  "sentiment": "negative",
  "since": "2026-05-15T00:00:00Z",
  "limit": 25
}

Output: array de comentários com texto, autor, sentiment, plataforma.

Quando o Claude chama: quando você pergunta "tem algum comentário ruim hoje" ou "quem comentou meus posts da semana".

reply_comment

Responde um comentário específico.

Input:

{
  "commentId": "com_xyz",
  "message": "Texto da resposta"
}

Output: { "ok": true } ou erro com motivo.

Quando o Claude chama: quando você define o texto da resposta e indica qual comentário responder.

Exemplos de prompts úteis

"Lista minhas contas conectadas e o status de cada uma."

"Cria um rascunho de post pro LinkedIn comemorando o lançamento do help center. Cita as 3 categorias mais úteis: composer, conectar e api."

"Mostra os comentários negativos do Instagram dos últimos 7 dias."

"Pra cada comentário positivo dos últimos 3 dias, sugere uma resposta calorosa e mostra ela pra eu aprovar antes de mandar."

"Lista os posts agendados pra próxima semana e me diz se algum dia tá sem post."

O que NÃO está exposto via MCP

Pra usar essas, vai pela UI ou REST direto:

• Upload de mídia binária (imagem/video)
• Brand voice (config + análise)
• Bio link (CRUD)
• Auto-rules do Inbox
• Configurações da workspace
• Billing / faturas
• Repurpose / Topic→Semana
• AI Coach (rewrite de texto existente)

Esses ficam pra V2 do MCP — quando tivermos mais dados de uso pra priorizar.

Custos via MCP

• create_post com publishNow: true consome quota de posts do plano
• Demais tools não consomem quota (apenas leituras)
• IA não roda direto via MCP — se você quer post gerado por IA, peça pro Claude gerar o texto na conversa e passar pro create_post