Voltar para Agentes IA

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

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/mcp

Ou 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/agent

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

FerramentaDescriçãoParâmetros principais
list_accountsLista todas as contas de redes sociais conectadas com IDs, plataformas e nomes de usuário.None
upload_mediaFaz upload de mídia a partir de URLs ou dados base64. Retorna mediaUrls para create_post.urls?, files?
get_upload_urlsObtém URLs de upload pré-assinadas para envio direto de arquivos ao armazenamento.files (fileName + mimeType)
create_postCria e agenda uma publicação para uma ou mais plataformas.text, platforms, contentType, timezone, scheduledAt?, mediaUrls?, platformTexts?, saveAsDraft?, tiktokConfigs?, youtubeConfigs?, pinterestConfigs?
get_postObtém os detalhes completos de uma publicação por ID.id
list_postsLista publicações com filtros opcionais por plataforma, status ou intervalo de datas.statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset?
update_postAtualiza 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_postExclui uma publicação agendada ou rascunho.id
publish_draftPublica um rascunho imediatamente ou o agenda para mais tarde.id, timezone, scheduledAt?
list_post_resultsVerifica os resultados de publicação por plataforma, sucesso/falha com detalhes do erro.id
retry_failed_platformsTenta novamente a publicação em plataformas que falharam.id, platformIds
bulk_schedule_postsAgenda múltiplas publicações de uma vez com plataformas e IDs de conexão compartilhados.platforms, timezone, posts[], connectionIds, platformConfigs?
get_analytics_overviewVisualizaçõ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_timeseriesAs mesmas métricas agrupadas por dia, semana ou mês, para perguntas de tendência.from, to, platforms?, granularity?
get_platform_breakdownAs mesmas métricas separadas por plataforma, com as métricas que cada plataforma informa.from, to
list_post_analyticsMé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_statusQuando cada conta foi sincronizada pela última vez e se alguma precisa ser reconectada para estatísticas.None
trigger_analytics_syncAtualiza 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.