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.

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 por dia por conexão. 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).