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

# AI Onboarding

> Dale a un agente el conocimiento, las herramientas, el entorno y los límites necesarios para implementar Commet.

Un agente necesita dos tipos de contexto para trabajar con Commet: conocimiento curado que explique el comportamiento de billing y contratos versionados que definan las operaciones exactas. Dale ambos en lugar de pedirle que infiera reglas de negocio desde schemas de API.

## Elegí cómo crear la organización

### Primero el humano

Creá una cuenta en [commet.co](https://commet.co), abrí la organización sandbox y generá una API key en **Settings → API Keys**. Usá OAuth cuando el cliente MCP pueda abrir un navegador; usá la key de sandbox en clientes headless.

### Primero el agente

Un agente headless puede aprovisionar organizaciones live y sandbox antes de que una persona inicie sesión:

```bash theme={null}
curl -X POST https://commet.co/api/v1/provision \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f5ebf70-8afd-4fc0-ae6e-6eaf0f647c91" \
  -d '{"name":"Acme","country":"US","businessType":"company"}'
```

La respuesta contiene una key live, una de sandbox y un claim URL. Guardá las keys en el momento, usá sandbox para implementar y entregale el claim URL al owner humano. Repetir el mismo UUID y body devuelve el mismo resultado; reutilizarlo con otro body falla.

## Conectá el MCP server

Usá el endpoint hosted:

```json theme={null}
{
  "mcpServers": {
    "commet": {
      "url": "https://commet.co/mcp/v2"
    }
  }
}
```

OAuth fija una conexión interactiva a la organización elegida en el navegador. Una conexión con `x-api-key` queda fijada a la organización de esa key. Antes de escribir, confirmá siempre si es sandbox o live.

MCP v2 genera una tool `api_*` por cada operación actual de OpenAPI y también permite buscar documentación. Leé [MCP Server](/docs/es/mcp-server) para configurar cada cliente.

## Dale la documentación correcta

Usá la fuente más chica que resuelva la tarea:

1. `node_modules/@commet/node/docs/README.md` para la API que coincide con la versión instalada del SDK.
2. El [índice de documentación](/docs/llms.txt) para descubrir el concepto o la regla de negocio curada correcta.
3. Agregá `.md` a una URL para obtener Markdown enfocado, por ejemplo `https://commet.co/docs/how-does-billing-work.md`.
4. Usá la [documentación completa](/docs/llms-full.txt) solo cuando la tarea realmente necesite todo el corpus curado.
5. Usá [OpenAPI](https://commet.co/openapi.json) y la API Reference generada para el contrato exacto de la plataforma actual.

La documentación instalada coincide con la versión del SDK. Documentation explica cómo se conectan dashboard y API. Knowledge Base define reglas de negocio. API Reference y Webhooks definen los contratos generados actuales.

Prepará un repositorio existente con un bloque administrado y reversible en `AGENTS.md`:

```bash theme={null}
commet agents setup
commet agents setup --check --output agent
```

Después validá la integración local sin cambiar archivos, conectarte con Commet ni imprimir secretos:

```bash theme={null}
commet doctor --output agent
```

`@commet/next`, `@commet/ai-sdk` y `@commet/better-auth` mantienen la guía específica de cada integración en el README de su paquete y comparten el contrato del SDK de Node indicado arriba.

## Instalá skills de billing

```bash theme={null}
npx skills add commet-labs/skills
```

Las skills agregan instrucciones específicas para SDKs, comportamiento de billing, webhooks, workflows de CLI y AI billing. El conocimiento universal de pricing y suscripciones está en los paquetes standalone de [Commet Skills](/docs/es/commet-skill).

## Usá un loop de implementación seguro

1. Pedile al agente que identifique el modelo de billing y el resultado visible para el customer.
2. Configurá o inspeccioná el catálogo en sandbox.
3. Implementá un flujo canónico con customer IDs estables e idempotencia.
4. Confirmá resultados asíncronos desde webhooks firmados, no desde redirects.
5. Avanzá el Test Clock y verificá renovación, falla y recovery.
6. Revisá cada mutación live antes de cambiar las credenciales.

Empezá por [Elegí un modelo de billing](/docs/es/choose-a-billing-model) y los [Ejemplos](/docs/es/examples) ejecutables.


## Related topics

- [Períodos de prueba](/docs/es/trial-periods.md)
- [Países soportados](/docs/es/supported-countries.md)
- [Descuentos](/docs/es/how-do-discounts-work.md)
- [Cobro por Tokens de IA](/docs/es/ai-token-billing.md)
- [Servidor MCP](/docs/es/mcp-server.md)


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