AI Onboarding

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

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:

{
  "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 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 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 solo cuando la tarea realmente necesite todo el corpus curado.
5. Usá OpenAPI 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:

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:

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

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.

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 y los Ejemplos ejecutables.