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

# Integración con MCP (Model Context Protocol)

> Conecta clientes de IA como Cursor, VS Code y Claude al servidor MCP oficial de caBRAPI para gestionar tu tienda en lenguaje natural.

El servidor **caBRAPI MCP** expone la API REST de caBRAPI como **33 herramientas MCP** sobre **Streamable HTTP**, permitiendo que clientes compatibles gestionen tiendas, productos, categorías, cupones, pagos, afiliados, páginas, webhooks y tarifas directamente desde el chat.

## Datos de conexión

* **Endpoint:** `https://mcp.cabrapi.com.br/mcp`
* **Transporte:** Streamable HTTP (`POST /mcp`)
* **Autenticación:** OAuth 2.0 con PKCE (S256) o API key de caBRAPI

## Autenticación

Puedes conectarte de dos maneras:

1. **OAuth 2.0 con PKCE (recomendado):** los clientes modernos (como Cursor y VS Code) abren automáticamente la página de autorización en el navegador para que ingreses tu API key de caBRAPI sin guardarla en texto plano.
2. **Header `Authorization`:** envía tu API key directamente en el header `Authorization` (**sin** el prefijo `Bearer`).

## Configuración en clientes

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

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

Si prefieres autenticar manualmente con tu API key en el header:

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

## Recursos disponibles (35 tools)

Una vez conectado, el cliente de IA tendrá acceso a herramientas para:

* **Tiendas y tarifas:** listar, consultar y actualizar tiendas y tarifas.
* **Productos y categorías:** crear, editar, reordenar y eliminar productos y categorías.
* **Cupones:** crear, consultar por código/ID, actualizar, reordenar y eliminar cupones.
* **Pagos:** listar, filtrar y consultar detalles de pagos.
* **Afiliados, páginas y webhooks:** gestionar afiliados, páginas de la tienda y suscripciones de webhooks.


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