Skip to main content
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:
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:
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:
Después validá la integración local sin cambiar archivos, conectarte con Commet ni imprimir secretos:
@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

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.