Conecte sua IA (MCP)

A zankh expõe um servidor MCP (Model Context Protocol) no mesmo endereço da API. Quem vende conecta a zankh ao ChatGPT e cria a loja e cadastra produtos conversando — foto, nome e preço. Quem desenvolve aponta a ferramenta de IA para cá e descreve o catálogo, em vez de escrever um script: ela descobre as operações sozinha e executa.

Pelo Claude, pelo ChatGPT ou por outro cliente MCP (para quem administra a loja)

Quem já tem loja conecta a IA que usa e administra por conversa: “suba 10% os preços da categoria X”, “ative tudo que tem estoque”, “quanto vendi esta semana?”, “complete este produto com esta página”. Alterações viram proposta com a prévia do antes e depois, e só valem quando você confirma na conversa; tudo fica no Modo IA do painel, com desfazer. O passo a passo por cliente (Claude.ai, ChatGPT, Claude Code, Gemini CLI) e as conexões ativas ficam no painel, em Loja → Conectar sua IA.

Pelo ChatGPT (para quem vende)

1. No ChatGPT, abra Configurações → Apps e procure Zankh. Enquanto o app não está no diretório, ative o modo desenvolvedor (Configurações → Apps → Avançado) e crie um app com o endereço acima, autenticação OAuth.
2. Clique em Conectar. O ChatGPT abre zankh.com.br/conectar: você entra na sua conta (ou cria, e abre a loja com CPF ou CNPJ pelo autocadastro de sempre), escolhe a loja e aprova as permissões.
3. De volta à conversa: “quero vender na zankh”. Mande a foto do produto e diga o preço — o ChatGPT cadastra, mostra o link e avisa quando a loja entra no ar.

Pela chave de API (para quem desenvolve)

Pela linha de comando do Claude Code:

claude mcp add --transport http zankh https://api.zankhapi.com.br/mcp \
  --header "Authorization: Bearer zk_live_SUA_CHAVE"

Ou no arquivo de configuração, que serve para qualquer cliente MCP:

{
  "mcpServers": {
    "zankh": {
      "type": "http",
      "url": "https://api.zankhapi.com.br/mcp",
      "headers": { "Authorization": "Bearer zk_live_SUA_CHAVE" }
    }
  }
}

Sem o header, um cliente que fala OAuth (Claude Code, MCP Inspector) descobre o login sozinho pelo 401 e abre o navegador.

Pedir

Cole este prompt na sua ferramenta. Ele já traz as três regras que evitam os erros comuns — conferir a loja antes de escrever, não duplicar e preço em centavos:

Você está conectado ao MCP da zankh, onde fica o catálogo da minha loja.

1. Chame dados_da_loja e me diga em qual loja você está. Se não for a que eu espero, pare.
2. Chame listar_produtos para ver o que já existe — não quero duplicar nada.
3. Cadastre os produtos do arquivo em anexo com criar_produto, um por vez.

Regras:
- Preço em CENTAVOS inteiros: R$ 199,90 é 19990, nunca 199.9.
- Se um produto já existir com o mesmo nome, pule e me diga qual.
- Ao terminar, liste o que criou e o que pulou.

Ferramentas disponíveis

Toda foto é baixada e copiada para a zankh (JPEG, PNG ou WebP, até 12 por produto) — o link só precisa funcionar durante a chamada. Produtos criados pelo MCP seguem as mesmas regras do painel: aparecem à venda, e a loja do autocadastro entra no ar sozinha quando tem o primeiro produto com foto e preço.

OAuth 2.1 (para quem implementa um cliente)

Segue a especificação de autorização do MCP: o 401 traz WWW-Authenticate: Bearer resource_metadata="…", o cliente lê os metadados, registra-se sozinho e faz o código de autorização com PKCE.

• redirect_uri comparado exato com o registrado; só https de clientes conhecidos (ChatGPT, Claude) ou localhost.
• Access token de 1 hora; refresh de 30 dias, trocado a cada uso — reapresentar um refresh já usado encerra a conexão.
• O token vale para UMA loja (a escolhida na tela) e só para este servidor MCP (resource). Quem sai da equipe da loja perde o acesso na hora.
• Escopos: loja.ler, produtos.ler, produtos.escrever, pedidos.ler. Ferramenta sem o escopo responde isError com o desafio insufficient_scope em _meta["mcp/www_authenticate"].

O escopo é a credencial, não o prompt

Uma chave — ou uma conexão OAuth — é uma loja, e toda ferramenta opera dentro dela. Não existe parâmetro de loja para o modelo preencher errado, nem para um texto injetado numa planilha apontar para outra. É a mesma garantia do REST, pela mesma razão: o escopo vem da credencial.