Conecte sua IA (MCP)

A zankh expõe um servidor MCP (Model Context Protocol) no mesmo endereço da API. A diferença em relação ao REST não é de protocolo, é de quanto trabalho humano existe entre “tenho os produtos” e “estão no ar”: em vez de ler esta documentação, escrever um script, tratar paginação e erro, você aponta a sua ferramenta de IA para cá e descreve o catálogo. Ela descobre as operações sozinha e executa.

1. Conectar

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" }
    }
  }
}

2. 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

O escopo é a chave, não o prompt

Uma chave é 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.