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 Configurações > Tokens API
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: <code>~/.claude/settings.json</code>. Para Cursor: <code>.cursor/mcp.json</code>.
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 de Tokens API. As chaves começam com adaptly_.
Configuração para Claude Desktop
O Claude Desktop conecta pela ponte <code>mcp-remote</code>, que abre a página de login para você. Adicione isto ao seu <code>claude_desktop_config.json</code>:
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 <code>mcp-remote</code> 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 18 ferramentas. Sua IA as descobre automaticamente, basta perguntar em linguagem natural.
| Ferramenta | Descrição | Parâmetros principais |
|---|---|---|
| list_accounts | Lista todas as contas de redes sociais conectadas com IDs, plataformas e nomes de usuário. | 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) |
| create_post | Cria e agenda uma publicação para uma ou mais plataformas. | text, platforms, contentType, timezone, scheduledAt?, mediaUrls?, platformTexts?, saveAsDraft?, tiktokConfigs?, youtubeConfigs?, pinterestConfigs? |
| 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?, mediaUrls?, platformTexts? |
| delete_post | Exclui uma publicação agendada ou rascunho. | 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, platformConfigs? |
| 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 |
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 de Tokens API. 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.