> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakto.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Ambientes

> A URL de produção, como pedir acesso a staging, e por que o link de checkout usa outro domínio.

## Produção

A URL base da API pública é:

```
https://api.cakto.com.br
```

É 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](mailto:infoprodutores@cakto.com.br) junto com as credenciais de teste.

<Warning>
  **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.
</Warning>

## Link público de checkout

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`:

```
https://pay.cakto.com.br/{id_da_oferta}
```

É o link derivado da oferta, o mesmo que aparece em [Criar um checkout](/comece-aqui/criar-checkout) e no [Glossário](/conceitos/glossario).

<Note>
  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](mailto:infoprodutores@cakto.com.br) antes de assumir.
</Note>

## Como escolher o ambiente no CaktoMCP

O [CaktoMCP](/mcp/visao-geral) é 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:

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Tip>
  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](/mcp/ferramentas-de-execucao).
</Tip>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Autenticação" icon="key" href="/authentication">
    Trocar `client_id` e `client_secret` por um token
  </Card>

  <Card title="Primeira chamada" icon="bolt" href="/comece-aqui/primeira-chamada">
    Do zero à primeira resposta da API
  </Card>
</CardGroup>