Guia de configuração MCP

Conecte o AdaptlyPost ao seu assistente de IA em menos de um minuto.

Pré-requisitos

Uma conta AdaptlyPost ativa registrar-se
Pelo menos uma conta de rede social conectada
Um token API de Configurações > Tokens API

Recomendado

Configuração para Claude Code e Cursor

Adicione isto às suas configurações MCP. 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",
      "headers": {
        "Authorization": "Bearer adaptly_your_api_key_here"
      }
    }
  }
}

Obtenha sua chave API na página de Tokens API. As chaves começam com adaptly_.

Claude Code CLI

claude mcp add --transport http --scope project --header "Authorization: Bearer adaptly_your_api_key_here" -- adaptlypost https://mcp.adaptlypost.com/mcp

Ou use o comando de uma linha do Claude Code CLI:

Configuração para Claude Desktop

O Claude Desktop requer a ponte <code>mcp-remote</code> para servidores MCP HTTP. 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",
        "--header",
        "Authorization: Bearer adaptly_your_api_key_here"
      ]
    }
  }
}

Configuração para outros clientes MCP

Qualquer cliente MCP que suporte transporte HTTP pode se conectar diretamente.

Endpoint

https://mcp.adaptlypost.com/mcp

Cabeçalho de autenticação

Authorization: Bearer adaptly_your_api_key_here

Transporte

HTTP (Streamable HTTP)

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 12 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?

Gerenciamento de acesso

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?

Copie a configuração acima, cole nas suas configurações MCP e comece a publicar pela sua IA.

Cadastrar-se

Obter chave API