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

Como adicionar o Onlypult ao Claude Code

Crie uma chave de API, rode um comando e confira o servidor com /mcp.

URL do servidor MCP https://mcp.onlypult.com/mcp
  1. 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. 2

    Rode o comando abaixo no terminal. Adicione --scope user para deixar o Onlypult disponível em todos os projetos.

  3. 3

    Inicie o Claude Code e rode /mcp. onlypult deve aparecer como conectado.

Terminal
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. 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. 2

    Rode o comando abaixo. O Claude Code inicia o pacote com npx no primeiro uso.

  3. 3

    Rode /mcp para conferir a conexão.

Terminal
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. 1

    Adicione .mcp.json à raiz do projeto com o bloco abaixo e envie o arquivo para o repositório.

  2. 2

    Cada desenvolvedor define ONLYPULT_API_KEY no perfil do terminal com a própria chave.

  3. 3

    O Claude Code pede a cada desenvolvedor que aprove os servidores do projeto na primeira vez.

Configuração do projeto .mcp.json
{
  "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.

Claude Code
/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.

SKILL.md

Cross-post

A mesma mensagem em várias redes, conferindo antes os limites de texto e de mídia de cada plataforma.

SKILL.md

Reels, Shorts e Stories

A ferramenta e as opções certas para Reels do Instagram e do Facebook, YouTube Shorts e Stories.

SKILL.md

Enviar mídia

Escolher entre uma URL pública, um envio no navegador e um envio direto a partir de um arquivo local.

SKILL.md

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.

SKILL.md

Relatório de análises

Seguidores, alcance, engajamento e melhores posts, lidos do jeito certo, com lacunas de dados e métricas derivadas explicadas.

SKILL.md

Melhor horário para postar

Encontrar os melhores dias e horas no mapa de engajamento e agendar os posts nesses horários.

SKILL.md

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.

SKILL.md

Conjuntos de hashtags

Gerenciar os conjuntos de hashtags salvos de um perfil e reutilizá-los em vez de digitar as tags de novo.

SKILL.md

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

14

Criar 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)

8

Alcance, 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

6

Fuso 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

6

Reutilize 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

3

URLs 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.

O 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
Ver preços

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

Experimente grátis