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

# IndiqAI API Pública

> Guia oficial do MCP público do IndiqAI, com catálogo de tools, autenticação e integração com agentes

Esta documentação cobre o **MCP público do IndiqAI**: um catálogo de tools exposto por HTTP, pronto para integrações server-to-server, automações e agentes de IA.

<Note>
  O foco desta navegação é a superfície pública autenticada por `X-API-Key`. Endpoints públicos complementares, como quests públicas e eventos de email, continuam documentados aqui quando fizerem parte da experiência externa.
</Note>

## Base URL

Use a base pública abaixo para chamadas manuais ou integrações:

`https://api.indiqai.com/api/v1/public`

No playground, o path de cada endpoint é aplicado automaticamente sobre essa base.

## Como autenticar

As tools autenticadas usam **API Key** no header `X-API-Key`:

```bash theme={null}
X-API-Key: indiqai_sua_chave_aqui
```

Algumas rotas públicas complementares, como partes de quests públicas e email, seguem contratos próprios descritos na página de cada endpoint.

Você pode gerar e revogar chaves no painel em **Integrações > API Keys**.

## O que você encontra aqui

<CardGroup cols={2}>
  <Card title="Visão geral do MCP" icon="shield-check" href="/api-reference/public-api/mcp-indiqai">
    Entenda como usar o MCP público do IndiqAI na prática.
  </Card>

  <Card title="Catálogo de tools" icon="list-tree" href="/api-reference/public-api/tools-catalog">
    Veja todas as tools disponíveis, o que cada uma faz e o que ela retorna.
  </Card>

  <Card title="Conectar clientes MCP" icon="bot" href="/api-reference/public-api/agent-integrations">
    Configure Claude Code, GitHub Copilot e Codex.
  </Card>

  <Card title="Primeiros passos" icon="rocket" href="/api-reference/public-api/intro">
    Entenda para quem serve, pré-requisitos e por onde começar.
  </Card>

  <Card title="Autenticação" icon="key" href="/api-reference/public-api/authentication">
    Como autenticar o MCP público com segurança.
  </Card>

  <Card title="Clientes" icon="users" href="/api-reference/public-api/clients/list">
    Cadastro, consulta individual e listagem paginada.
  </Card>

  <Card title="Cupons" icon="ticket" href="/api-reference/public-api/coupons/generate">
    Geração, consulta e uso de cupons.
  </Card>

  <Card title="Produtos" icon="box" href="/api-reference/public-api/products/list">
    Catálogo para integrações de estoque, ERP e PDV.
  </Card>

  <Card title="Métricas" icon="chart-column" href="/api-reference/public-api/metrics/overview">
    KPIs resumidos para dashboards e relatórios externos.
  </Card>
</CardGroup>

## Regras importantes

* o MCP público é **server-to-server** e deve ser consumido no backend ou em um adaptador seguro
* acesso disponível apenas para contas com **API Access** habilitado
* limite global de **60 requisições por minuto por API Key** nas tools autenticadas
* três writes críticos aceitam `X-Idempotency-Key`: crédito de pontos, geração de cupom e carimbo de cartão
* respostas `429` incluem `Retry-After` e headers `X-RateLimit-*`
* a empresa é derivada automaticamente da chave; você não precisa informar tenant manualmente
* chave revogada deixa de funcionar imediatamente

## Próximos passos

1. Gere uma chave em **Integrações > API Keys**
2. Leia a página [Usando o MCP do IndiqAI](/api-reference/public-api/mcp-indiqai)
3. Leia a página de [Autenticação](/api-reference/public-api/authentication)
4. Se for usar IA, siga o guia de [Conectando clientes MCP ao IndiqAI](/api-reference/public-api/agent-integrations)
5. Consulte o [Catálogo de tools](/api-reference/public-api/tools-catalog)
6. Comece por [Clientes](/api-reference/public-api/clients/list) ou [Produtos](/api-reference/public-api/products/list)