Guia de configuração MCP
Conecte o AdaptlyPost ao seu assistente de IA em menos de um minuto. Cole a URL, faça login quando solicitado e comece a publicar.
Pré-requisitos
Uma conta AdaptlyPost ativa registrar-se
Pelo menos uma conta de rede social conectada
Opcional: um token API para agentes headless e clientes sem OAuth, de Gerenciar > API e agentes de IA
Configuração para Claude Code e Cursor
Adicione isto às suas configurações MCP e faça login quando o navegador abrir. Para Claude Code: ~/.claude/settings.json. Para Cursor: .cursor/mcp.json.
MCP config
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp"
}
}
}Claude Code CLI
claude mcp add --transport http adaptlypost https://mcp.adaptlypost.com/mcpOu use o comando de uma linha do Claude Code CLI. Ele abre a página de login no primeiro uso:
Alternativa com chave API
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp",
"headers": {
"Authorization": "Bearer adaptly_your_key"
}
}
}
}Para agentes headless ou clientes sem OAuth, adicione um cabeçalho Authorization com um token da página API e agentes de IA. As chaves começam com adaptly_.
Configuração para Claude Desktop
O Claude Desktop conecta pela ponte mcp-remote, que abre a página de login para você. Adicione isto ao seu claude_desktop_config.json:
claude_desktop_config.json
{
"mcpServers": {
"adaptlypost": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.adaptlypost.com/mcp"]
}
}
}Configuração para outros clientes MCP
Qualquer cliente MCP que suporte transporte HTTP pode se conectar diretamente.
Endpoint
https://mcp.adaptlypost.com/mcp
Autenticação
Faça login quando solicitado (OAuth), ou envie Authorization: Bearer adaptly_your_key
Transporte
HTTP (Streamable HTTP)
Sem cabeçalho Bearer o servidor responde 401 com um cabeçalho WWW-Authenticate, então clientes com OAuth abrem a página de login sozinhos.
Para clientes que suportam apenas transporte stdio, use a ponte mcp-remote conforme mostrado na seção Claude Desktop.
Alternativa: Agent Skill
Para Claude Code, Cursor, Windsurf e Codex, você também pode instalar o AdaptlyPost como um agent skill, sem necessidade de configuração MCP.
npx skills add adaptlypost/agentInstala um SKILL.md e um script CLI que ensina ao seu agente a API do AdaptlyPost. Ver no GitHub
Referência de ferramentas
O servidor MCP expõe 33 ferramentas. Sua IA as descobre automaticamente, basta perguntar em linguagem natural.
| Ferramenta | Descrição | Parâmetros principais |
|---|---|---|
| list_workspaces | Lista os espaços de trabalho em que o seu login pode agir. Passe um id como workspaceId para qualquer outra ferramenta para trabalhar nesse espaço de trabalho. | None |
| list_accounts | Lista as contas de redes sociais conectadas com IDs, plataformas, nomes de usuário e status. Uma conta marcada como unauthorized precisa ser reconectada antes de publicar. | None |
| upload_media | Faz upload de mídia a partir de URLs ou dados base64. Retorna mediaUrls para create_post. | urls?, files? |
| get_upload_urls | Obtém URLs de upload pré-assinadas para envio direto de arquivos ao armazenamento. | files (fileName + mimeType) |
| open_upload_widget | Mostra uma caixa de upload no ChatGPT ou no Claude para o usuário adicionar fotos, vídeos ou documentos do próprio dispositivo. Ao terminar, a caixa devolve as mediaUrls. | None |
| get_upload_ticket | Chamado pela caixa de upload uma vez por arquivo. Oculto para a IA. | None |
| create_post | Cria uma publicação para uma ou mais plataformas: publicar agora, agendar, salvar como rascunho ou repetir diariamente, semanalmente, mensalmente ou anualmente. | platforms, contentType, timezone, text?, scheduledAt?, saveAsDraft?, recurrence?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, pageIds?, *Configs? |
| get_post | Obtém os detalhes completos de uma publicação por ID. | id |
| list_posts | Lista publicações com filtros opcionais por plataforma, status ou intervalo de datas. | statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset? |
| update_post | Atualiza o texto, agendamento, mídia ou configurações de plataforma de uma publicação agendada ou rascunho. | id, text?, platforms?, contentType?, scheduledAt?, timezone?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, *Configs? |
| delete_post | Exclui uma publicação. Uma agendada não será publicada; uma já publicada continua no ar nas redes. | id |
| unschedule_post | Retira uma publicação agendada do calendário e a mantém como rascunho sem data. | id |
| publish_draft | Publica um rascunho imediatamente ou o agenda para mais tarde. | id, timezone, scheduledAt? |
| list_post_results | Verifica os resultados de publicação por plataforma, sucesso/falha com detalhes do erro. | id |
| retry_failed_platforms | Tenta novamente a publicação em plataformas que falharam. | id, platformIds? |
| bulk_schedule_posts | Agenda múltiplas publicações de uma vez com plataformas e IDs de conexão compartilhados. | platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs? |
| list_recurring_posts | Lista as publicações recorrentes (séries) com status, agenda e próxima ocorrência. | statuses?, limit?, offset? |
| get_recurring_post | Obtém uma publicação recorrente por ID, com o motivo da pausa e a próxima data. | id |
| pause_recurring_post | Pausa uma série e remove a próxima publicação agendada. | id |
| resume_recurring_post | Retoma uma série pausada a partir da próxima data. Datas perdidas são ignoradas. | id |
| delete_recurring_post | Encerra uma série de vez. Publicações já enviadas são mantidas. | id |
| get_analytics_overview | Visualizações, curtidas, comentários, compartilhamentos, seguidores e taxa de engajamento para um período, cada um comparado com o período anterior. | from, to, platforms? |
| get_analytics_timeseries | As mesmas métricas agrupadas por dia, semana ou mês, para perguntas de tendência. | from, to, platforms?, granularity? |
| get_platform_breakdown | As mesmas métricas separadas por plataforma, com as métricas que cada plataforma informa. | from, to |
| list_post_analytics | Métricas por publicação, ordenáveis por qualquer métrica. Melhores publicações e "como foi esta publicação". | from, to, platforms?, sortBy?, page?, limit? |
| get_analytics_sync_status | Quando cada conta foi sincronizada pela última vez e se alguma precisa ser reconectada para estatísticas. | None |
| trigger_analytics_sync | Atualiza as estatísticas agora. Uma vez a cada 10 minutos por espaço de trabalho. | None |
| generate_caption | Escreve uma legenda a partir de um prompt, dentro do limite de caracteres da plataforma escolhida. Custa 2 créditos de IA. | prompt, platform? |
| refine_caption | Reescreve uma legenda existente seguindo uma instrução como "deixe mais curta", ou termina uma legenda começada. Custa 2 créditos de IA. | prompt, originalText, partialText?, platform? |
| generate_image | Inicia uma imagem com IA e devolve na hora um ID de tarefa. 2 créditos de IA no padrão, 4 no premium, reembolsados se falhar. | prompt, aspectRatio?, model?, quality?, sessionId?, referenceImages? |
| get_image_job | Consulta uma tarefa de imagem até ela terminar, com uma URL pública pronta para a publicação, ou falhar. | jobId |
Gerenciamento de acesso
Agentes logados perdem o acesso quando você remove o conector no seu cliente ou sai da conta. Você pode visualizar e revogar tokens API a qualquer momento na sua página API e agentes de IA. Revogar um token desconecta imediatamente qualquer agente que o esteja usando.
Pronto para conectar?
Cole a URL nas suas configurações MCP, faça login uma vez e comece a publicar pela sua IA.