Conecte um agente

Seu cliente de agente se conecta a um único endpoint. Por ele, pode consultar suas marcas e canais, gerar vídeos e textos, enviar arquivos, agendar e enviar posts e acompanhar o desempenho deles.

O agente não pode conectar um canal de rede social nem alterar seu plano. Os escopos e o limite mensal de créditos do token controlam os gastos. As chaves de idempotência evitam cobranças duplicadas quando uma chamada é repetida. Para conectar um canal, você precisa entrar na conta pelo navegador, então essa etapa fica no app.

Crie um token de acesso pessoal nas configurações. Ele só aparece uma vez e só funciona neste endpoint.

• Os escopos definem o que o token pode fazer: read para leitura, generate para tudo que gasta créditos e publish para publicar.
• Vincule-o a uma marca e ele verá apenas os canais, gerações, posts e textos dessa marca. A carteira de créditos, os arquivos enviados, os atores e os produtos continuam compartilhados em toda a conta.
• Defina um limite mensal de créditos. Quando os gastos do mês atingirem esse limite, o token não poderá iniciar novas chamadas pagas. Textos que já estiverem sendo gerados serão cobrados pelo custo real, que pode ultrapassar um pouco o limite.

1POST https://www.socialfaktory.com/mcp

Streamable HTTP, versão do protocolo 2025-06-18, autenticação bearer no cabeçalho Authorization. Não é preciso enviar um ID de sessão: o token é a sessão. Um GET retorna 405.

Adicione o SocialFaktory como conector personalizado nas configurações do cliente e cole este endereço como URL do servidor. O processo é o mesmo no Claude Desktop, claude.ai, ChatGPT e Gemini, sem intermediários nem processos locais.

1https://www.socialfaktory.com/mcp

• Não é preciso colar um token nem criar um ID de cliente. O app se registra sozinho.
• Na tela de consentimento, você escolhe quais escopos conceder entre read, generate e publish, a marca vinculada à conexão, o limite mensal de créditos e a duração da conexão.
• Desconecte a qualquer momento em Configurações, Tokens de API. O app para de funcionar imediatamente.

1. 1Entre no SocialFaktory se ainda não tiver entrado. A tela mostra o nome do app que encaminhou você.
2. 2A permissão de leitura é sempre concedida e dá acesso às suas marcas, mídia e posts. Selecione as outras permissões que quer conceder. A geração cria vídeos e textos com seus créditos. A publicação agenda e envia posts nos seus canais. Deixe essa opção desmarcada até confiar no briefing.
3. 3Vincule a uma marca ou deixe em todas as marcas para permitir a publicação em todos os canais conectados.
4. 4Escolha a duração da conexão: 30, 60 ou 90 dias.
5. 5Defina um limite mensal de créditos ou deixe em branco para não limitar. Depois, clique em Conectar. Você volta ao app e ele funciona imediatamente. Ele nunca poderá conectar um canal, alterar seu plano ou entrar na sua conta como se fosse você.

Para o diretório de conectores do Claude, o SocialFaktory oferece um endereço próprio. Conectado por ele, o Claude gerencia sua conta, escreve posts, envia seus próprios arquivos de mídia e agenda e publica em todos os canais conectados.

1. Abra a página do SocialFaktory no diretório de conectores do Claude.
2. Clique em Conectar. O Claude leva você ao SocialFaktory.
3. Entre na sua conta SocialFaktory.
4. Escolha se o Claude pode escrever e publicar posts. Defina também a marca em que ele trabalha, o limite mensal de créditos e a duração da conexão. Confirme para voltar ao Claude e passar um briefing.

1https://www.socialfaktory.com/mcp/claude

• Ele não gera imagens, vídeo, voz ou música com IA. Crie esses conteúdos no app: assim que estiverem na sua biblioteca de mídia, o Claude poderá agendá-los e publicá-los.
• A conexão feita pelo diretório só funciona neste endereço. A conexão feita em /mcp só funciona em /mcp. Se você colar um token manualmente, ele funciona nos dois.

No Claude Code, Codex e curl, é mais rápido conectar colando um token. Os exemplos abaixo continuam funcionando sem alterações.

Envie JSON-RPC 2.0 via POST. Aceite tanto JSON quanto o tipo event-stream e indique a versão do protocolo em cada requisição.

1POST https://www.socialfaktory.com/mcp
2Authorization: Bearer sfp_…
3Content-Type: application/json
4Accept: application/json, text/event-stream
5MCP-Protocol-Version: 2025-06-18
6
7{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Cada ferramenta indica o escopo necessário. Sem ele, o token é recusado antes da execução. quote_generation permite consultar o preço de um vídeo, mas a consulta é opcional. generate_text reserva alguns créditos antecipadamente e depois cobra apenas o que foi usado para escrever o texto.

Inclua este argumento em toda chamada que consome créditos ou publica. Se você repetir a chamada em até 24 horas, ela retorna o resultado original, marcado como repetido, sem executar tudo de novo.

• 120 chamadas por minuto por token e 300 requisições a cada 5 minutos por endereço.
• Os agentes ainda não podem clonar vídeos a partir de links nem gerar imagens estáticas ou carrosséis.

App Gemini: adicione o endereço como app personalizado. O app se registra sozinho, então não é preciso preencher as credenciais de cliente nos recursos avançados. Atualmente, o Google só permite apps personalizados em contas pessoais de quem tem 18 anos ou mais e está nos Estados Unidos. O idioma deve ser inglês, a primeira conexão deve ser feita pela web e o salvamento de atividades precisa estar ativado.

Gemini Enterprise: um administrador adiciona um servidor MCP personalizado com os endereços de autorização e token do documento de descoberta, um ID e um segredo de cliente obtidos no registro em /oauth/register com token_endpoint_auth_method client_secret_post e o endereço de callback do administrador, PKCE ativado e os escopos read, generate e publish. Apenas Streamable HTTP, que é o transporte usado por este endpoint.

Gemini CLI: instale a extensão e a CLI cuida do acesso, incluindo a tela de consentimento.

1gemini extensions install https://github.com/socialfaktory/socialfaktory-gemini-extension

Agentes gerenciados da API Gemini: indique o endpoint como ferramenta de servidor, com um token criado por você no cabeçalho Authorization.

1{
2  "type": "mcp_server",
3  "name": "socialfaktory",
4  "url": "https://www.socialfaktory.com/mcp",
5  "headers": { "Authorization": "Bearer sfp_…" }
6}

Algo não está funcionando ou você tem uma dúvida sobre uma conexão? Respondemos em até um dia útil. Escreva usando o e-mail da sua conta para [email protected]