INICIO RÁPIDO PARA DESARROLLADORES

API e integraciones de uso de IA

Empieza con un proyecto y un evento. Añade visibilidad donde ya se ejecuta tu flujo.

UN PROYECTO. CONTEXTO DE SOLO LECTURA.

Lleva tus señales a la conversación.

Ambas conexiones consultan el uso instrumentado, el estado de las automatizaciones y las estimaciones internas de cargos a clientes. Crea primero una clave de lectura exclusiva del proyecto. No se necesitan claves API de proveedores.

Complemento local de Codex

Descargar el complemento local

La descarga incluye INSTALL.md. Tras extraerla, ejecuta npm ci --prefix server desde esa carpeta. El ejemplo siguiente usa la estructura completa del código fuente de la aplicación.

Usa el paquete incluido plugin/ con el código fuente. Instala sus dependencias de servidor y registra el paquete mediante el procedimiento de complementos locales compatible con tu host de Codex.

npm ci --prefix plugin/server

# In your MCP host's secure environment:
TRACEWELL_URL=https://tracewell.bhsoftwareproductions.com
TRACEWELL_READ_KEY=YOUR_PROJECT_READ_KEY

El paquete declara un servidor stdio local en plugin/mcp.json. Los detalles de configuración se incluyen en docs/PLUGIN.md. Que el código fuente esté disponible no significa que el complemento esté instalado en tu host.

ChatGPT o un host MCP compatible

Añade una conexión MCP personalizada con el endpoint alojado y autenticación OAuth. Revisa la página de consentimiento de Tracewell y autoriza allí una clave de lectura exclusiva del proyecto; no pegues secretos de proveedores ni claves de lectura en un chat.

Endpoint MCP alojadohttps://tracewell.bhsoftwareproductions.com/mcp

Tu host, tu cuenta y tu administrador deben admitir conexiones MCP personalizadas. El propietario debe configurar el origen OAuth alojado y la persistencia. Esta página no verifica que haya una conexión instalada.

Abrir la guía oficial de configuración de ChatGPT

Solo los metadatos que envías.

SDK de JavaScript · SDK de Python

Estas herramientas no descubren cuentas de proveedores, suscripciones de chat ni todas las conversaciones. Para conectar otro proyecto, usa otra clave de lectura exclusiva y otra conexión.

Crear una clave de lectura del proyecto

Crear un proyecto

Abre el espacio, elige Clientes y proyectos y asigna un nombre y un presupuesto mensual en USD a tu trabajo. Usa el modo de espacio real solo cuando la autenticación y la API estén configuradas.

Abrir proyectos →

Emitir una clave de alcance limitado

Crea una clave de ingesta para ese proyecto. Copia su secreto una vez y guárdalo en el servidor. Nunca lo incluyas en código del navegador ni envíes tus credenciales del proveedor a Tracewell.

Enviar metadatos de uso

curl https://YOUR_HOST/api/v1/usage \
  -H 'Authorization: Bearer YOUR_PROJECT_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"eventId":"unique-event-id","provider":"custom",
       "model":"my-model","costUsd":0.042}'

Usa un eventId único y estable para reintentar con seguridad. Proporciona costUsd o tanto inputRatePerMillion como outputRatePerMillion junto con las cantidades de tokens. Sin precios explícitos, el coste sigue siendo desconocido. Se admite cualquier nombre de proveedor o modelo.

Comunicar resultados

POST /api/v1/runs
{
  "eventId": "unique-run-id",
  "automationId": "YOUR_AUTOMATION_ID",
  "status": "success",
  "recordsProcessed": 12,
  "durationMs": 3400
}

Crea primero una automatización. Las ejecuciones ausentes se evalúan tras el intervalo previsto más cinco minutos. Los resultados fallidos o insuficientes generan alertas en la aplicación. Las alertas informan; no detienen las cargas de trabajo de origen.

Lleva el contexto a Codex

Usa el inicio rápido de conexión del recuadro anterior para el complemento local de Codex o el endpoint MCP OAuth alojado. Ambos exponen resúmenes de proyecto, uso, resultados de automatizaciones y estimaciones internas de cargos a clientes mediante acceso de lectura exclusivo del proyecto. La configuración del host y la autorización son explícitas.

Solo lee los eventos que has instrumentado. No descubre suscripciones de chat, inspecciona todas las conversaciones de Codex o ChatGPT ni deduce costes de la facturación de cuentas. Para medir una llamada API, envía sus metadatos por el endpoint de ingesta. Mantén los secretos del proveedor separados de las claves de Tracewell.

Crear una clave de proyecto de solo lectura →

Reduce los datos enviados

Solo se aceptan los campos de metadatos documentados. Se rechazan instrucciones, respuestas, secretos de proveedores y campos arbitrarios. Las solicitudes JSON se limitan a 16 KB. Los ID de evento se delimitan por proyecto y tipo de evento.