Conectar o Ascendly ao Claude e outras IAs

Última atualização: 15 de setembro de 2026

O Ascendly é um servidor MCP. MCP (Model Context Protocol) é o padrão pelo qual um assistente de IA — Claude, Claude Code, Cursor e outros — opera um sistema externo. Conectado, o assistente deixa de só conversar sobre a sua operação e passa a fazer: consultar o catálogo, importar produto, gerar imagem e página, ler métricas de anúncio, exportar relatório.

Você continua no controle. A conexão é por OAuth, você escolhe o que liberar numa tela de permissões, e pode revogar a qualquer momento sem trocar senha nenhuma.

1. Antes de começar

  • Uma conta no Ascendly — ascendly.com.br.
  • Um cliente de IA que fale MCP remoto por HTTP (lista de exemplos na seção 4).
  • Nada para instalar e nenhuma chave para copiar: o login é o mesmo do painel, feito no navegador.

2. O endereço do servidor

É este, e é a única coisa que você precisa colar no seu cliente de IA:

https://www.ascendly.com.br/api/mcp

Repare no www. O endereço sem ele responde com um redirecionamento permanente, e há cliente de MCP que não segue redirecionamento durante a descoberta do login — o sintoma é uma conexão que falha sem explicar por quê. Cole exatamente como está acima.

3. Conectar no Claude (aplicativo e web)

  1. Abra Configurações → Conectores.
  2. Clique em Adicionar conector personalizado.
  3. Dê um nome (Ascendly) e cole o endereço da seção 2.
  4. Clique em conectar. Abre uma janela do Ascendly: faça login se ainda não estiver logado.
  5. Na tela de permissões, escolha o que liberar (seção 5) e confirme. O navegador volta sozinho para o Claude.

Da segunda vez em diante a reconexão não pede clique nenhum, desde que você não esteja pedindo uma permissão nova.

4. Conectar em outros clientes

4.1. Claude Code

claude mcp add --transport http ascendly https://www.ascendly.com.br/api/mcp

Depois rode /mcp dentro do Claude Code e siga o login no navegador. Para desconectar, claude mcp logout ascendly.

4.2. Cursor, VS Code, Zed e afins

Esses clientes guardam servidores MCP num arquivo JSON (o nome e o lugar mudam conforme o programa — procure por MCP nas configurações dele). A entrada do Ascendly é esta:

{
  "mcpServers": {
    "ascendly": {
      "type": "http",
      "url": "https://www.ascendly.com.br/api/mcp"
    }
  }
}

Não coloque token nenhum aí. O cliente descobre o login sozinho na primeira chamada e abre o navegador para você autorizar.

4.3. Qualquer outro

Serve qualquer cliente que fale MCP remoto por HTTP com OAuth. O servidor publica a descoberta nos endereços padrão (/.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server) e aceita registro automático de cliente, então não há nada para cadastrar conosco antes. Um detalhe técnico: o canal é POST; não há SSE.

5. A tela de permissões

É onde você decide o alcance do assistente. São quatro permissões, e elas não são equivalentes:

  • Ler — catálogo, saldo, lojas, métricas, status de trabalho. Vem sempre incluída e nunca gasta crédito.
  • Importar produtos e gerar conteúdo — o que cria coisa dentro do Ascendly. Gasta créditos da sua conta. Nada é publicado em loja nenhuma.
  • Publicar na sua loja e no seu blog — envia produto, página, post e SEO para Shopify, Nuvemshop e demais lojas e CMS conectados. Sai do Ascendly.
  • Alterar campanhas de anúncio — pausa, ativa e muda orçamento no Meta Ads e no Google Ads. Mexe em gasto real de mídia. No Google Ads a alteração depende de uma aprovação do Google que ainda não saiu: até lá o Ascendly recusa a mudança e avisa, e a leitura segue funcionando.

As duas últimas são as de risco, e o Ascendly as trata como tal: nascem desmarcadas, nunca são concedidas por inércia, e mesmo depois de concedidas cada ação individual pede confirmação antes de acontecer. Você pode liberar só a leitura agora e ampliar depois — o cliente pede de novo e a tela reaparece.

Uma ressalva que vale ler: o nome do aplicativo que aparece na tela é informado por ele mesmo e não é verificado pelo Ascendly. O que de fato identifica para onde o acesso vai é o endereço de retorno, que a tela mostra. Só autorize se foi você quem começou a conexão.

6. Conferir se funcionou

Peça ao assistente algo que só a sua conta responde — “qual é o meu saldo de créditos no Ascendly?” ou “liste meus últimos produtos”. Se vier o número certo, está conectado. Se ele responder que não tem a ferramenta, veja a seção 9.

7. Créditos, e o que não custa nada

  • Leitura nunca gasta. Saldo, catálogo, lojas, métricas, status de trabalho, histórico: tudo de graça.
  • Trabalho gasta o mesmo que gastaria no painel. Importar produto, gerar imagem, gerar página, exportar relatório. O preço sai da mesma tabela que a tela usa — a ferramenta não tem preço próprio.
  • O assistente deve avisar antes. As ferramentas que gastam dizem isso na própria descrição, e um assistente bem comportado confirma com você antes de chamar.
  • Há duas travas. No máximo 10 ações pagas por minuto, e um teto de 2.000 créditos a cada 24 horas por conexão. A janela é móvel: conta as últimas 24 horas, não o dia do calendário. Servem para que um agente em laço não esvazie sua conta.

Trabalho demorado (imagem, página, importação) devolve um número de acompanhamento em vez de travar a conversa. O assistente consulta o andamento sozinho e mostra o resultado quando fica pronto — imagem gerada aparece na própria conversa.

8. Ver e revogar o acesso

No Ascendly, abra Configurações → Apps conectados. Ali você vê cada aplicativo conectado, quais permissões ele tem e o histórico de chamadas — o que foi feito, e quando.

O botão de revogar derruba o acesso na hora. O que já foi publicado na sua loja não volta atrás — revogar impede o que vem depois, não desfaz o que passou.

9. Quando não funciona

  • A conexão falha sem mensagem clara. Confira o www no endereço (seção 2). É a causa mais comum.
  • O assistente diz que não tem a ferramenta. Ele só enxerga as ferramentas que a permissão concedida cobre — quem liberou só leitura não vê as que escrevem. Reconecte e marque a permissão na tela.
  • “Limite de ações atingido, tente em N segundos.” É a trava de 10 por minuto. Não é erro: espere o tempo que a mensagem diz.
  • Pediu para publicar e ele pediu confirmação de novo. É o comportamento correto das permissões de risco. Cada ação confirma, sempre.
  • Parou de funcionar do nada. Veja em Apps conectados se a conexão ainda está lá — alguém da equipe pode tê-la revogado.

10. Privacidade e segurança

  • Sua senha nunca é compartilhada com o cliente de IA. O login acontece no Ascendly; o que o cliente recebe é um acesso limitado ao que você marcou, e revogável.
  • Cada chamada fica registrada — inclusive as recusadas. É o histórico que você lê em Apps conectados.
  • O acesso é da sua conta e enxerga só os dados dela.
  • Detalhes completos em Política de Privacidade.

11. Suporte

Dúvidas ou problemas? Escreva para contato@ascendly.com.br — respondemos em até 48h úteis. Diga qual cliente de IA você está usando e o que aconteceu (uma captura de tela da mensagem de erro ajuda muito).