Conecte o Claude ao INITE Studio

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

Destino padrão: ~/.claude/skills/. Passe --target=project para instalar em .claude/skills/ do repositório atual — útil quando o projeto tem prompts próprios.

Todas as skills são markdown puro: leia, edite, faça fork. Não há mágica nenhuma. Cada passo que o Claude segue fica à vista.

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

Reinicie o Claude Desktop depois de editar a config. O registro pela CLI vale na hora. O SDK usa a chave a cada requisição.

Cada lente (audit-team, audit-market, audit-competition, …) devolve duas saídas que alimentam o veredito v2:

• Passa/não passa — booleano, pelo critério da própria lente.
• Confiança (0..1) — o quanto a lente confia na própria conclusão diante das evidências que reuniu. Um “não passa” com pouca confiança é um sinal mais fraco do que um “não passa” com muita.

compute_dealbreakers_v2 junta essas saídas em uma decisão de quatro caixas:

O estágio pesa. A mesma saída de lente vale coisas diferentes para quem está em estágio de ideia e para quem está captando Series A: a falta de um CFO é fatal no Series A e irrelevante no estágio de ideia. O estágio é gravado por setAuditStageSector no salvamento.

Consenso entre lentes. Quando duas lentes afirmam coisas contraditórias (audit-market: “CAGR de 30%” contra audit-competition: “saturado, sem espaço para crescer”), mostramos um aviso de consenso e derrubamos a confiança geral. Ele aparece no detalhe da auditoria; se preferir, chame GET /api/methodology/consensus/:auditId direto.

Percentil na cohort. Se a auditoria tem setor marcado e pelo menos uma outra auditoria divide esse setor, mostramos onde a ideia cai na distribuição. GET /api/methodology/cohort/:auditId.

Calibração. A plataforma acompanha os desfechos que você registra e diz se o score realmente prevê rodadas. GET /api/methodology/calibration devolve o score médio de quem captou contra o de quem morreu, a acurácia do limiar e um limiar de GO sugerido. Junte pelo menos 30 desfechos antes de apoiar decisões no número de discriminação.

Quais skills emitem confiança

As lentes devolvem um número de 0 a 1 junto com o passa/não passa. Antes de decidir o veredito geral, o agregador pondera cada lente pela confiança dela: um “não passa” convicto pesa mais do que um “passa” hesitante em outro lugar. Hoje emitem confiança:

Os cabeçalhos que enviamos

• Content-Type: application/json
• X-Ideaudit-Event — um entre audit.finalized, audit.outcome.recorded, entity.created.
• X-Ideaudit-Signature: sha256=<hex> — veja abaixo.
• X-Ideaudit-Endpoint: <uuid> — o id do seu endpoint, para rotear em receptores com vários endpoints.

Verificando a assinatura (Node)

A assinatura é HMAC-SHA256(secret, raw_request_body) em hex, prefixada com sha256=. Confira contra os bytes crus do corpo — nunca contra o 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);
}

Verificando a assinatura (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 teste

O botão “Testar” do dashboard usa o id da sua auditoria finalizada mais recente (ou o UUID zerado, se você não tiver nenhuma) e acrescenta isTest: true ao payload. Cheque esse campo no seu receptor para pular efeitos colaterais.

Desativação automática

Depois de 5 respostas seguidas fora da faixa 2xx, viramos active = false e marcamos o endpoint com um selo de desativado. Conserte o receptor e clique em Reativar em Configurações → Webhooks. O histórico recente de entregas — status e corpo da resposta — fica num painel expansível por endpoint.

Autentique como usuário do dashboard, com um Bearer JWT do inite-auth (auth.inite.ai). Este endpoint não fica na superfície das chaves de API do MCP: ele é um endpoint do dashboard, atrás da mesma autenticação do resto do dashboard. O corpo junta o prompt do usuário, a chave da Anthropic que o Claude vai gastar e a chave MCP do próprio usuário, para o orquestrador conseguir salvar o 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 do stream

• event: text — os tokens do Claude conforme saem.
• event: tool — uma ferramenta MCP disparou ({ toolName, input }).
• event: done — evento terminal; o payload traz o auditId se o orquestrador chamou save_audit. O relatório completo fica em GET /api/audits/<id>.
• event: error — qualquer coisa que estourou no servidor. Fora de produção, vem também um requestId.