MCP

Conecte clientes de IA a contas, mídia, revisões, agendamentos e dados de Análises disponíveis no Influence.

Escolha o ponto de acesso para a tarefa. As ferramentas do produto exigem um espaço de trabalho autorizado do Influence; o servidor de documentação apenas lê guias públicos.

Conecte e descubra

Use o fluxo OAuth do Influence no cliente ou uma chave de API com escopos definidos quando o cliente aceitar autenticação bearer. Aplicativos e automações fornece a configuração específica de cada cliente. Armazene chaves de API no ambiente de segredos do cliente.

Leia profileGet para conferir o e-mail do Influence e o espaço de trabalho (nickname), depois connectionStatusGet para ver os escopos e a franquia de agendamento por IA. O login do próprio cliente de IA pode usar outro e-mail. Selecione a identidade pretendida do Influence durante a autorização.

A renovação OAuth exige consentimento explícito para offline_access. Para uma nova conexão personalizada do ChatGPT, as instruções de configuração também especificam esse escopo básico. Atualizar as ferramentas não adiciona permissões nem amplia os escopos básicos de uma conexão antiga.

Use tools/list e a referência de ferramentas MCP. A descoberta pode anunciar ferramentas cujos escopos ainda não foram concedidos; cada chamada continua exigindo as permissões. Recursos habilitados e suporte do cliente afetam a disponibilidade. Os pontos de acesso geral e do Claude são diferentes; baixar uma skill ou um plugin não comprova que o cliente instalado carregou suas ferramentas.

Prepare conteúdo finalizado

1. Leia accountList e depois integrationSchema para ver as configurações obrigatórias e os limites de mídia de cada conta selecionada. Use as ferramentas nomeadas de consulta do provedor para pastas, canais e destinos semelhantes.
2. Importe um arquivo HTTPS acessível com mediaImport usando url e, opcionalmente, name. Um arquivo real do host usa o objeto file separado; não invente IDs de arquivo. Para arquivos locais, use as ferramentas de envio multipart ou o helper existente do SDK/CLI. Aplicam-se os limites de mídia e requisitos para ficar pronta.
3. Para preparar o agendamento de 1–10 publicações finalizadas, use campaignScheduleBatchReview com itemKey estável, draft e scheduledFor por item. Ele salva rascunhos e revisões pendentes juntos, com texto e mídia por destino e no máximo 50 envios. Para trabalhos apenas com rascunhos ou edições, use campaignDraftSave; campaignReview prepara a ação pretendida para uma campanha salva.
4. Apresente a revisão salva completa. Um cartão exibido e carregado fornece essa apresentação; sem ele, mostre as contas exatas, o texto, as prévias ou os links de mídia, as configurações, o horário agendado e o fuso horário. Leia campaignReviewGet quando a revisão estiver ausente, desatualizada ou incerta.
5. Obtenha uma nova aprovação humana explícita antes da execução. Um cartão compatível tem seu próprio botão de aprovação. Para publicações sociais elegíveis, a aprovação na conversa é enviada por campaignReviewExecute ou campaignScheduleBatchExecute. O modelo não deve chamar a ação privada de UI campaignReviewApprove.

O TikTok Direct permite usar apenas a conversa. Leia tiktokCreatorInfoGet e faça uma pergunta agrupada sobre escolhas pendentes de visibilidade, interações, promoção e opções aplicáveis de IA e música. Mostre o texto de consentimento aplicável e os links; não deduza consentimento nem ative interações restritas. Salve as escolhas completas da pessoa com campaignReview usando reviewId e entradas de tiktokSettings que contenham connectionId e settings. Isso retorna uma nova revisão pendente, não uma aprovação. Apresente essa revisão exata e espere uma nova aprovação explícita antes da execução. Um cartão de revisão compatível continua sendo opcional. A publicação pela caixa de entrada do TikTok é concluída no TikTok.

O consentimento do TikTok pertence à revisão exata; o consentimento salvo em um rascunho não conclui essa etapa. Salvar escolhas de revisão cria uma nova versão do rascunho e torna a revisão anterior desatualizada, mesmo quando as configurações não mudam.

Confirmação e recuperação

Ferramentas marcadas como exigindo confirmação primeiro preparam sem _confirmationCapability ou _idempotencyKey. Confirme uma entrada de negócio idêntica com a capacidade de confirmação retornada e uma chave de idempotência estável gerada pelo cliente que faz a chamada. Essa troca salva ou realiza a ação declarada da ferramenta; ela é separada da aprovação humana para publicação. Respeite os pedidos de permissão do host.

mediaUploadPart, mediaUploadComplete e mediaUploadAbort continuam um envio autorizado diretamente. Transfira os bytes do arquivo para as URLs de armazenamento retornadas, não no JSON da ferramenta. Após uma interrupção, leia o status do envio e retome com o mesmo arquivo e clientKey.

O expiresAt de um envio é seu prazo atual de transferência ou processamento: inicialmente 24 horas, depois 15 minutos quando a conclusão inicia o processamento. A mídia pronta não expira com esse prazo; reutilize seu assetId da biblioteca de mídia.

Mantenha os valores de confirmação e nova tentativa após uma incerteza. Leia a revisão ou a campanha salva antes de tentar novamente uma ação de publicação; nunca suponha que um timeout significa que nada aconteceu. Uma revisão alterada ou expirada exige nova revisão e aprovação.

Os limites de agendamento por IA se aplicam aos clientes MCP e ao Influence IQ em conjunto. Automações comuns por HTTP/CLI e agendamentos manuais pela web ficam de fora. A cobertura e o comportamento de atualização de Análises estão descritos em Análises. Assinaturas opcionais de eventos exigem suporte separado habilitado no host; não são uma promessa geral de notificações em segundo plano em todos os clientes.