API & Desenvolvedores

API e Integração via MCP

Atualizado em 03/11/2026

Para usos técnicos, a Horsee expõe um servidor MCP que permite criar e editar páginas e produtos por agentes/ferramentas.

Para que serve

O servidor MCP da Horsee deixa um assistente de IA, como o Claude ou o Cursor, operar a sua loja por você: ler dados, criar páginas, atualizar produtos e publicar. A conexão usa login OAuth e vale para uma loja por vez, com as permissões que você aprovar.

O que dá para fazer pelo MCP

  • Criar páginas raw (landing, produto, custom) e publicá-las.
  • Atualizar páginas e o cabeçalho/rodapé (chrome) da loja.
  • Criar produtos e gerar/capturar templates de loja.

Passo a passo: conectar ao Claude

  1. Abra o menu do seu usuário e entre em Minha Conta.
  2. No card Conexões MCP, clique em Conectar ao Claude. A janela mostra a URL do servidor e as instruções.
  3. No app do Claude, vá em Customize → Connectors, clique em +, escolha Add custom connector, cole a URL e clique em Add. No Claude Code, rode o comando mostrado na janela e digite /mcp.
  4. Na tela da Horsee que abrir, faça login, escolha a loja e aprove as permissões.
  5. Para cortar o acesso, volte ao card Conexões MCP e use Revogar.

A página Horsee MCP também traz atalhos de instalação para o Claude e o Cursor.

Autenticação e escopos

O acesso usa OAuth 2.1 com PKCE: o cliente recebe um token, com escopos por capacidade — por exemplo pages:read, pages:write e pages:write:raw (escrita de HTML/CSS/JS), além de products:write, templates:author e outros. Antes de automatizar, descubra o contrato vivo (tokens de interpolação, elementos <horsee-*> e os modos de página) — ele é a fonte da verdade.

Limites

Cada conexão aceita até 60 requisições por minuto; acima disso o servidor responde com erro 429 e indica quanto esperar. Ações destrutivas, como publicar ou apagar, têm cota por hora e pedem confirmação: a ferramenta devolve um código, e a ação só acontece se a mesma chamada for repetida com ele em até 5 minutos. Depois, o dono da loja recebe um e-mail avisando.

Erros comuns

  • Agindo na loja errada: a conexão vale para a loja escolhida no login. Peça ao assistente para trocar de loja ou conecte de novo.
  • Erro 429: o limite de requisições foi atingido. Espere o tempo indicado.
  • Publicar sem revisar: comece em rascunho, valide no preview e só então publique.
  • Plano gratuito do Claude: ele permite um conector personalizado por vez.
Para a maioria dos casos de "conectar com outra ferramenta", o caminho mais simples é o Zapier em Apps e Integrações — o MCP é para automações sob medida.

Este artigo foi útil?

Ajude-nos a melhorar nosso conteúdo com seu feedback