MCP do Claude Code
Publique nas redes sociais pelo Claude Code
Um comando adiciona o Onlypult ao Claude Code. Transforme notas de versão, um lançamento ou uma pasta de capturas em rascunhos e posts agendados em mais de 15 redes, sem sair do terminal.
- Um comando
- Hospedado ou local
- Envio a partir do disco
Leia o CHANGELOG.md da v2.4 e crie um rascunho de post no LinkedIn e um no X anunciando a versão. Anexe ./docs/release.png.
Dois rascunhos criados, com a captura anexada:
- RascunhoLinkedIn — “A v2.4 saiu: exportações mais rápidas e SSO”
- RascunhoX — 3 destaques + link para as notas da versão
Como adicionar o Onlypult ao Claude Code
Crie uma chave de API, rode um comando e confira o servidor com /mcp.
https://mcp.onlypult.com/mcp - 1
No Onlypult, abra Configurações → Chaves de API e crie uma chave. Ela começa com
op_e aparece uma única vez. Copie para um lugar seguro. - 2
Rode o comando abaixo no terminal. Adicione
--scope userpara deixar o Onlypult disponível em todos os projetos. - 3
Inicie o Claude Code e rode
/mcp. onlypult deve aparecer como conectado.
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp \
--header "Authorization: Bearer op_your_api_key" Roda o servidor MCP do Onlypult na sua máquina, para o Claude Code enviar imagens e vídeos direto do repositório com media_upload_file. Exige Node.js 18+.
- 1
No Onlypult, abra Configurações → Chaves de API e crie uma chave. Ela começa com
op_e aparece uma única vez. Copie para um lugar seguro. - 2
Rode o comando abaixo. O Claude Code inicia o pacote com
npxno primeiro uso. - 3
Rode
/mcppara conferir a conexão.
claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key \
-- npx -y @onlypult/mcp@latest Compartilhe o servidor com a equipe por um arquivo do projeto. A chave fica no ambiente de cada desenvolvedor, não no git.
- 1
Adicione
.mcp.jsonà raiz do projeto com o bloco abaixo e envie o arquivo para o repositório. - 2
Cada desenvolvedor define
ONLYPULT_API_KEYno perfil do terminal com a própria chave. - 3
O Claude Code pede a cada desenvolvedor que aprove os servidores do projeto na primeira vez.
{
"mcpServers": {
"onlypult": {
"type": "http",
"url": "https://mcp.onlypult.com/mcp",
"headers": {
"Authorization": "Bearer ${ONLYPULT_API_KEY}"
}
}
}
} Confira se funcionou: peça ao Claude Code “Mostre meus perfis sociais conectados no Onlypult”.
Pedidos no Claude Code que funcionam
O Claude Code vê o seu repositório, então pode escrever posts a partir de notas de versão, documentos e arquivos reais.
Anúncio de lançamento
“Leia a entrada mais recente do CHANGELOG.md e crie rascunhos de posts para LinkedIn, X e o nosso canal do Telegram. Somente rascunhos.”
Capturas para um carrossel
“Envie cada PNG de ./launch/screens e crie um rascunho de post com várias imagens no Instagram, com uma legenda explicando cada recurso.”
Documentos para uma série de dicas
“Percorra docs/guides e crie oito dicas curtas para o LinkedIn, uma por guia, agendadas toda terça e quinta às 10:00.”
Resumo semanal das alterações
“Resuma as alterações mescladas desta semana num post “O que há de novo” para o Telegram e agende para sexta às 17:00.”
Corrigir as falhas da noite
“Liste os posts do Onlypult que falharam nas últimas 24 horas, explique os erros e tente de novo os que tiverem retryable.”
Conferir os limites primeiro
“Consulte posts_limits dos nossos perfis no X e no Threads e encurte os rascunhos em ./social/*.md para caber, antes de criá-los.”
Habilidades para o Claude Code
Instale o plugin do Onlypult no Claude Code com dois comandos
O plugin junta as habilidades do Onlypult à conexão MCP, então o Claude Code conhece as regras de cada tarefa: qual ferramenta chamar, como escrever o horário, como ler as análises e como diagnosticar um post que falhou antes de tentar de novo. Como ele lê os arquivos do repositório, as habilidades que transformam um texto já escrito em posts são onde ele se sai melhor.
Instalar para o Claude Code
Adicione o marketplace e depois instale o plugin. Dois comandos em qualquer sessão do Claude Code. Entre no Onlypult na primeira chamada de ferramenta.
/plugin marketplace add onlypult/agent-skills
/plugin install onlypult@onlypult Já adicionou o servidor MCP à mão? Rode antes claude mcp remove onlypult, para o Claude Code não manter duas conexões com o mesmo servidor.
Agendar um post
Rascunho, agendamento ou publicação no fuso horário certo e no perfil certo, com os limites do plano e as opções da rede.
Cross-post
A mesma mensagem em várias redes, conferindo antes os limites de texto e de mídia de cada plataforma.
Reels, Shorts e Stories
A ferramenta e as opções certas para Reels do Instagram e do Facebook, YouTube Shorts e Stories.
Enviar mídia
Escolher entre uma URL pública, um envio no navegador e um envio direto a partir de um arquivo local.
Corrigir posts que falharam
Ver o que falhou, explicar por quê, corrigir a causa e tentar de novo só quando uma nova tentativa pode funcionar.
Relatório de análises
Seguidores, alcance, engajamento e melhores posts, lidos do jeito certo, com lacunas de dados e métricas derivadas explicadas.
Melhor horário para postar
Encontrar os melhores dias e horas no mapa de engajamento e agendar os posts nesses horários.
Calendário de conteúdo
Planejar uma semana ou um mês a partir do que já funciona: mostrar o plano primeiro e criar os posts depois da sua aprovação.
Conjuntos de hashtags
Gerenciar os conjuntos de hashtags salvos de um perfil e reutilizá-los em vez de digitar as tags de novo.
Seu agente ganha as mãos, não o botão de publicar
A maioria das configurações de “publicação com IA” é tudo ou nada. O Onlypult deixa você passar o trabalho repetitivo a um agente e manter a palavra final, em cada post.
Rascunhos por padrão
Peça um rascunho e o agente envia is_draft: true. O post é salvo no calendário e não vai a lugar nenhum até uma pessoa, ou um “publicar agora” explícito, decidir.
Permissões por ferramenta
No Claude, ChatGPT, Cursor e na maioria dos clientes MCP você aprova as ferramentas uma a uma. Deixe leituras e rascunhos em “Sempre permitir” e publicar e excluir em “Perguntar sempre”.
Tudo cai no seu calendário
Todo post que um agente cria aparece no calendário do Onlypult ao lado dos posts da equipe. Edite, reagende ou envie para aprovação antes de ir ao ar.
OAuth para apps de chat, chaves para código
Claude e ChatGPT conectam com OAuth 2.1: você entra em onlypult.com e o app de chat nunca vê a sua senha. Agentes de código usam uma chave de API op_ em Configurações → Chaves de API.
Erros com os quais o agente pode agir
Erros de validação voltam com um código e um indicador retryable. O agente explica “seu plano termina no dia 5, escolha uma data anterior” em vez de tentar de novo sem parar.
Protegido contra instruções escondidas
Legendas e comentários trazidos pelas análises são marcados como conteúdo externo não confiável, então o agente os resume em vez de seguir instruções escondidas neles.
Cada ferramenta que o seu agente recebe
Um servidor MCP cobre todo o ciclo do post: contexto, publicação, mídia, hashtags, reparo e análises. 37 ferramentas.
Posts e agendamento
14Criar rascunho, agendar, publicar, republicar em outras redes, editar, excluir e reparar.
posts_createposts_create_storyposts_create_reelsposts_create_shortsposts_publish_nowposts_cross_postposts_listposts_list_failedposts_getposts_updateposts_deleteposts_retryposts_retry_all_failedposts_limits Análises (somente leitura)
8Alcance, seguidores, melhores posts, melhor horário, período contra período.
analytics_profiles_listanalytics_metrics_listanalytics_overviewanalytics_audienceanalytics_postsanalytics_top_postsanalytics_best_timeanalytics_compare_periods Conta e perfis
6Fuso horário, limites do plano, perfis conectados, quadros e categorias.
account_getprofiles_listprofiles_getprofiles_platforms_listprofiles_get_pinterest_boardsprofiles_get_youtube_categories Conjuntos de hashtags
6Reutilize grupos de hashtags salvos por perfil em vez de digitá-los de novo.
hashtags_listhashtags_createhashtags_deletehashtag_groups_createhashtag_groups_updatehashtag_groups_delete Mídia
3URLs públicas, upload no navegador ou envio direto do disco.
media_get_upload_urlmedia_check_statusmedia_upload_file Publique em mais de 15 redes a partir de um chat
O agente escolhe perfis do seu espaço de trabalho no Onlypult. Toda conta que você conectou por OAuth oficial fica disponível, com opções por rede como Reels, Shorts, Stories, quadros e primeiros comentários.
Dicas e solução de problemas do Claude Code
Hospedado ou local
O servidor hospedado basta para texto e URLs públicas de imagem. Use o pacote local quando o Claude Code precisar enviar arquivos do repositório. O servidor hospedado não lê o seu disco.
O servidor aparece como falha em /mcp
No servidor hospedado, confira se o cabeçalho é exatamente Authorization: Bearer op_…. No pacote local, confira se o Node.js 18+ está instalado e se npx está no PATH.
Mantenha as chaves fora do git
Use ${ONLYPULT_API_KEY} no .mcp.json e guarde a chave real no seu ambiente. Cada chave pertence a uma conta Onlypult. Crie uma chave separada por pessoa da equipe.
Permissões
O Claude Code pergunta antes de rodar ferramentas MCP. Permita ferramentas de leitura e de rascunho na sessão. Deixe posts_publish_now e posts_delete em perguntar.
“Não é possível agendar depois do fim do plano”
Não dá para agendar posts depois da data de fim do plano. O agente lê isso em account_get e deve escolher uma data anterior ou pedir para você renovar. Este erro vem marcado como retryable: false, então um agente bem-comportado para em vez de ficar repetindo.
Claude Code e Onlypult: perguntas frequentes
O Claude Code pode publicar nas redes sociais?
Sim. Com o servidor MCP do Onlypult adicionado, o Claude Code pode criar rascunhos, agendar e publicar posts em mais de 15 redes e anexar imagens do seu repositório.
Qual é o comando para adicionar o Onlypult ao Claude Code?
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp --header "Authorization: Bearer op_your_api_key". Para envio local de arquivos, use: claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key -- npx -y @onlypult/mcp@latest.
O Claude Code pode enviar imagens do meu projeto?
Sim, com o pacote local. Ele adiciona media_upload_file, que envia um arquivo de um caminho local e devolve um ID para posts_create.
Posso usar em CI ou em scripts?
Para fluxos fixos, chame a API REST do Onlypult direto com a mesma chave de API. É mais previsível do que um agente. Use o Claude Code quando quiser que ele decida o que escrever.
Está incluído no meu plano?
Sim. MCP e a API estão em todos os planos do Onlypult, inclusive nos 7 dias grátis.
Conectar outro agente de IA
Claude.ai e Claude Desktop. Adicione um conector personalizado, entre com o Onlypult, sem chave de API para colar.
Guia de configuraçãoConector personalizado no Plus e no Pro, ou modo de desenvolvedor em qualquer plano. Entrada por OAuth e depois mencione @Onlypult.
Guia de configuraçãoAdicione o Onlypult ao .cursor/mcp.json: hospedado, ou o pacote local que envia arquivos direto do disco.
Guia de configuraçãoAdicione o Onlypult ao Codex CLI ou à extensão da IDE via config.toml ou codex mcp add.
Guia de configuraçãoAdicione o Onlypult ao Cascade no Windsurf via mcp_config.json, hospedado ou pacote local.
Guia de configuraçãoO MCP está incluído em todos os planos
- Funciona nos 7 dias grátis
- Sem cartão para começar
- Sem plano separado para desenvolvedores
- Sem taxa de API por perfil
Lance a versão e os posts juntos
Adicione o Onlypult ao Claude Code e deixe-o anunciar o que você acabou de construir, como rascunhos que você aprova.
7 dias grátis · Sem cartão · MCP e API em todos os planos
