Skip to main content

​
Produção

A URL base da API pública é:
É o host declarado em servers: no contrato OpenAPI que gera esta documentação — todos os endpoints ficam sob o prefixo /public_api/.

​
Staging

Existe um ambiente de staging, com credenciais próprias. A URL não está publicada aqui: peça ao suporte junto com as credenciais de teste.
Não tente deduzir a URL de staging. Ela não é um subdomínio de cakto.com.br nem uma transformação mecânica da URL de produção — chutar staging.cakto.com.br ou algo parecido não leva a lugar nenhum.Pelo mesmo motivo, não deduza a URL de nenhum outro ambiente: só existe o que o suporte confirmar.
Independente do ambiente da API, o link público de checkout usa um domínio próprio — pay.cakto.com.br, e não api.cakto.com.br:
É o link derivado da oferta, o mesmo que aparece em Criar um checkout e no Glossário.
Não está confirmado se staging tem um domínio de checkout público equivalente. Se o seu caso de uso depender disso, confirme com o suporte antes de assumir.

​
Como escolher o ambiente no CaktoMCP

O CaktoMCP é um servidor remoto: cada requisição carrega o ambiente em que deve operar. A resolução vai do mais específico ao mais genérico:
1

Header X-Cakto-Env

A escolha explícita do cliente MCP. Aceita producao ou staging — exatamente assim, sem acento e em minúsculas. Um valor fora dessa lista responde erro, em vez de cair em algum default silencioso.
2

Variável CAKTO_ENV

Override do operador, para quem roda o próprio servidor. No servidor hospedado em https://mcp.cakto.com.br, o ambiente é fixado em producao por essa variável — determinístico, sem depender do endereço pelo qual a requisição chegou.
3

Host da requisição

Sem header nem variável, o próprio endereço público pelo qual você chegou identifica produção, contra uma allowlist explícita de hosts.
4

Default: staging

Nada declarado e host não reconhecido caem em staging. O default nunca é produção: errar para staging é visível e barato, errar para produção move dinheiro real de vendedores sem ninguém ter pedido.
Para apontar para qualquer host fora desses dois — um backend local, por exemplo — use CAKTO_API_BASE_URL diretamente. Ela sempre ganha de CAKTO_ENV.
Na dúvida sobre onde você está operando, chame cakto_whoami: ele responde o ambiente ativo, o client_id em uso e os escopos concedidos. Veja Ferramentas de Execução.

​
Próximos passos

Autenticação

Trocar client_id e client_secret por um token

Primeira chamada

Do zero à primeira resposta da API