documentação · agente
O Concept fala MCP nativo: um servidor Streamable HTTP stateless no mesmo backend. Conectou, o servidor entrega o protocolo in-band no initialize — seu agente recebe as regras antes da primeira chamada. Esta página é o espelho humano delas.
⚠️ a key vai SEMPRE em header ou env var — nunca em campo de conector (Client ID/URL), nunca literal em config commitada · gere e revogue as suas em Painel → Chaves
o header vai por env var de propósito (bug de espaços em args no Windows) · reinicie o Desktop depois
Cole a key nas configurações do app — uma key própria (read_only pra consultar; read_write pra decidir o inbox), revogável isolada.
O conector custom do claude.ai exige OAuth, e o Concept é key-only por decisão (fase partner). Enquanto isso: Desktop ou Code cobrem o mesmo uso.
server adicionado no meio de uma sessão só carrega na próxima · keys hoje são por convite (sem signup)
Você só vê e toca o que é seu. Row-Level Security no banco, não filtro de aplicação.
Todas as leituras. É a key do app no seu celular e de qualquer superfície de consulta.
Leituras + adoções, gaps, work items — e propõe mudança de canon: a proposta espera o dono no painel (US008b).
Idem; com a aprovação de canon DESLIGADA (seed em massa), aplica direto. A key do dono do tenant.
Consulte o compliance e olhe as linhas behind/gap na área da sua mudança. Drift = pin < head — é fato (query), não opinião. O bloco due (US020) traz cadências de auditoria/legal vencidas, nunca rodadas ou com rearm — não-vazio, sinalize ao dono. Veio total: 0? O projeto está cego: faça antes o passe inicial de mapeamento (o que ele já adota → adoption_report com evidência).
Proponha uma entry nova ou evolua a existente — a versão anterior fica imutável. O changeNote explica o porquê, não só o quê.
Reporte a adoção com o pin novo e evidência arquivo:linha ou a story real. Nunca reporte sem evidência.
Registre o gap — vira work item para curadoria humana no app. Em projeto com backlog migrado, crie a story com concept_story_create. Para editar, leia concept_story_get e use concept_story_update; o corpo é substituído integralmente, sem histórico. O antigo concept_story_upsert foi removido.
O ledger contém a auditoria completa. O Concept guarda uma projeção verificável do último FULL.
concept_audit_list aceita projectSlug, kind, state, limit (1–50, default 20), offset e includeArchived. Tipos: audit_cadence, legal_cadence e marketing_cadence. Estados: unconfigured, never, overdue, rearm e ok. Retorna items, total, hasMore, offset, limit, states e projects. Linhas virtuais não criam relógios.
Copie revision para expectedRevision antes de reportar ou corrigir marketing ou evidência estruturada. Use new somente se a linha retornou new. Conflito exige releitura. Projetos arquivados são consulta histórica.
Propose/evolve aceitam metaJson como string JSON; omitir no evolve preserva, um objeto vazio limpa. O manifesto só cabe em Checklist e exige 1–100 IDs únicos com práticas e versões existentes no tenant.
{
"auditManifest": {
"schemaVersion": 1,
"kind": "marketing_cadence",
"criteria": [
{
"id": "M01",
"practiceSlug": "business-growth/product-landing-page",
"practiceVersion": 2,
"description": "Oferta observável no recorte",
"evidenceRule": "URL e observação datada da oferta real",
"maxAgeDays": 30
}
]
}
}Um FULL real pode incluir assessment no report, com todos os checks do manifesto. Exemplo de formato abaixo: substitua os valores pela evidência real; não execute como uma auditoria.
{
"schemaVersion": 1,
"kind": "marketing_cadence",
"checklistSlug": "business-growth/marketing-audit-cadence",
"checklistVersion": 1,
"runAt": "2026-09-19T12:00:00Z",
"scope": {
"nature": "Application",
"stage": "Early",
"surfaces": [
"Web"
],
"market": "BR / pt-BR"
},
"evidenceRef": "docs/marketing-audit.md#full-exemplo",
"evidenceHash": "SHA256_HEXADECIMAL_DO_RELATORIO_COMPLETO",
"complete": true,
"checks": [
{
"id": "M01",
"practiceSlug": "business-growth/product-landing-page",
"practiceVersion": 2,
"result": "pass",
"evidenceRef": "URL_OU_CAMINHO_REAL",
"observedAt": "2026-09-19T11:30:00Z",
"reason": null
}
]
}Schema 1, complete=true e todos os IDs são obrigatórios. Kind, runAt e evidenceRef coincidem com o report; natureza, estágio e superfícies coincidem com o projeto. Hash tem 64 caracteres hexadecimais (SHA-256). A API valida a estrutura; não busca nem atesta a fonte. Pass/fail exigem referência e data observada; unknown/na/pending exigem motivo; N/A também data. Datas não ultrapassam o corte. Não envie PII ou segredos.
C=pass, D=fail, U=unknown, N=na; A=C+D+U. Distância=D+U; avaliado=(C+D)/A; comprovado=C/A. A=0 ou aplicabilidade pendente suprimem percentuais. As contagens vêm do servidor. Versão, recorte, idade da evidência, prazo ou rearm podem tornar o FULL histórico.
DELTA preserva âncora e resumo FULL. FULL preserva rearm posterior ao corte. Correção invalida o resumo. Marketing rejeita score escalar; cadência mensal ou trimestral é uma decisão explícita. Configurar cadência não cria execução e não há scheduler de campanhas.
Create, evolve, link e maturity seguem a mesma curadoria: aprovação ligada cria proposta; desligada permite aplicação direta apenas por key ReadWrite + Trusted, sem bypass de sessão humana.
Estrela é prioridade compartilhada. Referência é uma versão publicada com checklist. Adoção e pin não comprovam conformidade. A consulta mostra a última observação registrada; o agente precisa inspecionar o ambiente autorizado antes de relatar resultados.
concept_entry_set_favorite recebe entrySlug, isFavorite e expectedRevision. concept_entry_set_reference recebe entrySlug, versionNo (null remove), expectedRevision e reason; passa pela curadoria de canon.
concept_pattern_conformance aceita favoritesOnly, q, area, projectSlug, nature, surface, status, entrySlug, includeArchived, environment, limit e offset. Default: favoritos, production, 20 linhas; máximo 50. Snapshot, totais, navegação, aplicabilidade e estados vêm do backend. Projetos sem adoção também aparecem.
Publique o manifesto no metaJson da versão: conformanceManifest com schemaVersion=1 e criteria (1–100). Cada critério tem id único, description, surfaces, natures, minStage, evidenceRule e maxAgeDays (1–366). Anexar arquivo e colar print são checks distintos.
concept_pattern_assessment_report recebe input como objeto JSON ou texto desse objeto, com projectSlug, entrySlug, referenceVersionNo, requestId, expectedAssessmentId (null na primeira), observedAt, scope (nature, stage, surfaces), environment, release, reportRef e checks.
Cada check contém id, surface, result, evidenceRef, observedAt, reason e storyCode opcional. Cubra todos os critérios × superfícies: pass/fail exigem prova e data; unknown/pending exigem motivo; na exige motivo e data. Datas com Z/offset. Não inspecionado fica unknown. Ambientes production, quality e code são separados. Nova release exige nova observação.
Use requestId estável para retry e releia expectedAssessmentId em conflito. Correções informam supersedesId e correctionReason, mantendo o original. Histórico: concept_pattern_assessment_history com entrySlug, projectSlug e environment, até 50 registros. Nunca envie segredos, mídia inline ou URLs assinadas. Nenhuma dessas ações renova auditorias, move pins ou abre histórias automaticamente.