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

# Integração com MCP (Model Context Protocol)

> Conecte clientes de IA como Cursor, VS Code e Claude ao servidor MCP oficial da caBRAPI para gerenciar sua loja por linguagem natural.

O servidor **caBRAPI MCP** expõe a API REST da caBRAPI como ferramentas MCP (**35 tools**) via **Streamable HTTP**, permitindo que clientes compatíveis gerenciem lojas, produtos, categorias, cupons, pagamentos, afiliados, páginas, webhooks e taxas diretamente pelo chat.

## Informações de conexão

* **Endpoint:** `https://mcp.cabrapi.com.br/mcp`
* **Transporte:** Streamable HTTP (`POST /mcp`)
* **Autenticação:** OAuth 2.0 com PKCE (S256) ou chave de API da caBRAPI

## Autenticação

Você pode conectar de duas formas:

1. **OAuth 2.0 com PKCE (recomendado):** clientes modernos (como Cursor e VS Code) abrem automaticamente a página de autorização no navegador para você informar sua API Key da caBRAPI sem precisar salvá-la em texto plano no arquivo de configuração.
2. **Header `Authorization`:** envie sua chave de API diretamente no header `Authorization` (**sem** o prefixo `Bearer`).

## Configuração nos clientes

### Cursor / VS Code (`mcp.json`)

```json theme={null}
{
  "mcpServers": {
    "cabrapi": {
      "url": "https://mcp.cabrapi.com.br/mcp"
    }
  }
}
```

Se preferir autenticar manualmente com API Key via header:

```json theme={null}
{
  "mcpServers": {
    "cabrapi": {
      "url": "https://mcp.cabrapi.com.br/mcp",
      "headers": {
        "Authorization": "SUA_API_KEY_CABRAPI"
      }
    }
  }
}
```

## Recursos disponíveis (35 tools)

Após conectar, o cliente de IA terá acesso a ferramentas para:

* **Lojas e taxas:** listar, consultar e atualizar lojas e taxas.
* **Produtos e categorias:** criar, editar, reordenar e remover produtos e categorias.
* **Cupons:** criar, consultar por código/ID, atualizar, reordenar e remover cupons.
* **Pagamentos:** listar, filtrar e consultar detalhes de pagamentos.
* **Afiliados, páginas e webhooks:** gerenciar afiliados, páginas da loja e inscrições de webhooks.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.