Conecta Claude con INITE Studio

curl -fsSL https://inite.studio/install.sh | sh

Destino por defecto: ~/.claude/skills/. Pasa --target=project para instalarlas en .claude/skills/ del repositorio actual — útil si el proyecto tiene prompts propios.

Todas las skills son markdown plano: léelas, edítalas, bifúrcalas. No hay nada mágico. Cada paso que sigue Claude queda a la vista.

{
  "mcpServers": {
    "ideaudit": {
      "type": "http",
      "url": "https://api.inite.studio/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Reinicia Claude Desktop después de editar la config. El registro por CLI surte efecto al momento. El SDK usa la clave en cada petición.

Cada lente (audit-team, audit-market, audit-competition, …) devuelve dos salidas que alimentan el veredicto v2:

• Pasa / no pasa — booleano, según el criterio de la propia lente.
• Confianza (0..1) — cuánto se fía la lente de su conclusión con la evidencia que ha reunido. Un «no pasa» con poca confianza es una señal más floja que un «no pasa» con mucha.

compute_dealbreakers_v2 junta esas salidas en una decisión de cuatro cajas:

El estadio pesa. La misma salida de una lente vale distinto para quien está en fase de idea y para quien levanta una Series A: la falta de un CFO es fatal en Series A e irrelevante en fase de idea. El estadio se graba con setAuditStageSector al guardar.

Consenso entre lentes. Cuando dos lentes afirman cosas contradictorias (audit-market: «CAGR del 30%» frente a audit-competition: «saturado, no queda recorrido»), mostramos un aviso de consenso y bajamos la confianza global. Se ve en el detalle de la auditoría; si lo prefieres, llama a GET /api/methodology/consensus/:auditId directamente.

Percentil en la cohorte. Si la auditoría tiene sector marcado y al menos otra auditoría comparte ese sector, mostramos dónde cae esta idea en la distribución. GET /api/methodology/cohort/:auditId.

Calibración. La plataforma sigue los desenlaces que registras y dice si el score predice rondas de verdad. GET /api/methodology/calibration devuelve el score medio de quien levantó frente al de quien cerró, la exactitud del umbral y un umbral de GO sugerido. Reúne al menos 30 desenlaces antes de apoyar decisiones en el número de discriminación.

Qué skills emiten confianza

Las lentes devuelven un número de 0 a 1 junto al pasa / no pasa. Antes de decidir el veredicto global, el agregador pondera cada lente por su confianza: un «no pasa» rotundo pesa más que un «pasa» dubitativo en otro sitio. Hoy emiten confianza:

Las cabeceras que enviamos

• Content-Type: application/json
• X-Ideaudit-Event — una de audit.finalized, audit.outcome.recorded, entity.created.
• X-Ideaudit-Signature: sha256=<hex> — mira abajo.
• X-Ideaudit-Endpoint: <uuid> — el id de tu endpoint, para enrutar en receptores con varios endpoints.

Verificar la firma (Node)

La firma es HMAC-SHA256(secret, raw_request_body) en hex, con el prefijo sha256=. Compárala contra los bytes crudos del cuerpo, nunca contra el JSON reserializado.

import { createHmac, timingSafeEqual } from 'node:crypto';

export function verify(secret: string, signatureHeader: string, rawBody: string): boolean {
  const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(signatureHeader);
  const b = Buffer.from(expected);
  if (a.length !== b.length) return false;
  return timingSafeEqual(a, b);
}

Verificar la firma (Python)

import hmac, hashlib

def verify(secret: str, signature_header: str, raw_body: bytes) -> bool:
    expected = "sha256=" + hmac.new(
        secret.encode(), raw_body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature_header)

Eventos de prueba

El botón «Probar» del dashboard usa el id de tu auditoría finalizada más reciente (o el UUID de ceros, si no tienes ninguna) y añade isTest: true al payload. Mira ese campo en tu receptor para saltarte los efectos secundarios.

Desactivación automática

Tras 5 respuestas seguidas fuera del rango 2xx ponemos active = false y marcamos el endpoint como desactivado. Arregla el receptor y pulsa Reactivar en Ajustes → Webhooks. El historial reciente de entregas — estado y cuerpo de la respuesta — se ve en un panel desplegable por endpoint.

Autentícate como usuario del dashboard, con un Bearer JWT de inite-auth (auth.inite.ai). Este endpoint no vive en la superficie de las claves de API del MCP: es un endpoint del dashboard, detrás de la misma autenticación que el resto. El cuerpo junta el prompt del usuario, la clave de Anthropic que va a gastar Claude y la clave MCP del propio usuario, para que el orquestador pueda guardar el resultado.

curl -N https://api.inite.studio/api/audit/run \
  -H "Authorization: Bearer $INITE_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "audit this idea: an AI note-taking app for lawyers",
    "anthropicKey": "sk-ant-...",
    "ideauditKey": "ideaudit_...",
    "model": "claude-sonnet-5"
  }'

Eventos del stream

• event: text — los tokens de Claude según van saliendo.
• event: tool — se ha disparado una herramienta MCP ({ toolName, input }).
• event: done — evento terminal; el payload trae el auditId si el orquestador llamó a save_audit. El informe completo está en GET /api/audits/<id>.
• event: error — cualquier cosa que reviente en el servidor. Fuera de producción viene además un requestId.