API e MCP

A Aurora expõe o site e o hub por uma API documentada em OpenAPI e por um servidor MCP, que conecta assistentes de IA (Claude, ChatGPT e outros) ao blog, ao formulário de contato e, com token, à operação do hub.

Servidor MCP

Endereço: https://auroraliderancacontabilidade.com/mcp, em HTTP (Streamable HTTP), sem sessão e com respostas em JSON. Sem token, só as ferramentas públicas aparecem. Com o token pessoal criado no hub (Meu perfil → Tokens do MCP), aparecem as do seu acesso.

{
  "mcpServers": {
    "aurora": {
      "type": "http",
      "url": "https://auroraliderancacontabilidade.com/mcp",
      "headers": {
        "Authorization": "Bearer <seu token do hub>"
      }
    }
  }
}

Ferramentas do MCP e quem pode usá-las
Ferramenta	O que faz	Acesso
saude	Estado da aplicação e dos serviços (banco, cache, armazenamento), como em /api/health.	Pública (sem token)
blog_listar	Artigos publicados no blog, do mais recente ao mais antigo, com busca sem acento (q), filtro por categoria (público: empresas, mei, pessoa-fisica, produtor-rural, gestao-e-patrimonio, parceiros), por servico (o id de um serviço do catálogo, como irpf) e por quem assina (autor).	Pública (sem token)
blog_obter	Um artigo publicado, pela categoria e pelo endereço (slug), com assinatura e ressalva.	Pública (sem token)
acervo_listar	Ativos publicados com versão e impressão digital do conteúdo, paginados — a leitura de integração do acervo.	Pública (sem token)
acervo_obter	Um ativo publicado pelo identificador, com versão e impressão digital.	Pública (sem token)
medicao_configuracao	O ID público do Google Analytics 4 do site, ou null quando não configurado.	Pública (sem token)
contato_enviar	Registra um pedido de atendimento no funil do escritório, como o formulário do site.	Pública (sem token)
artigos_listar	Todos os artigos do hub com estado, categoria, tags, marca de taxonomia legada, autoria e destaque.	Equipe do hub (token)
artigo_obter	Um artigo com a versão atual, as ações permitidas para quem pede e a trilha.	Equipe do hub (token)
artigo_criar	Cria um rascunho vazio em nome de quem pede.	Equipe do hub (token)
artigo_salvar	Salva uma versão nova do conteúdo (categoria, tags, slug, título, subtítulo, pergunta respondida, resposta direta, corpo e termos).	Equipe do hub (token)
artigo_transicionar	Envia para revisão (submeter), conclui e assina de uma vez (concluir_e_assinar, só administrador), aprova, publica, tira do ar (despublicar) ou destaca no blog — só as ações que o artigo permite a quem pede.	Equipe do hub (token)
publicacoes_agenda_listar	Publicações agendadas (da mais próxima) e o histórico de 90 dias: publicadas, canceladas e falhas, com o motivo.	Equipe do hub (token)
publicacao_agendar	Marca data e hora (ISO 8601 com fuso) para publicar um artigo APROVADO; reagendar substitui o anterior.	Administrador (token)
agendamento_cancelar	O artigo continua aprovado, sem horário.	Administrador (token)
agendamento_publicar_agora	Publica já, sem esperar o horário marcado.	Administrador (token)
cadencia_ler	Dias da semana (0 = domingo) e horário de Brasília, com o próximo horário livre sugerido.	Equipe do hub (token)
cadencia_salvar	Grava uma versão nova da cadência (dias e horário).	Administrador (token)
artigo_devolver	O revisor devolve o artigo em revisão com o motivo, que entra na trilha.	Equipe do hub (token)
artigos_importar_redigidos	Leva ao hub, como rascunhos, os artigos redigidos no código do site que ainda não existem lá (pelo endereço).	Administrador (token)
pessoas_listar	Pessoas, papéis, situação e assinatura (cargo, credencial, link).	Administrador (token)
pessoa_criar	Cria a conta com senha provisória, devolvida uma vez nesta resposta.	Administrador (token)
pessoa_alterar	Nome, papel, situação (ativa) e assinatura de uma pessoa.	Administrador (token)
pessoa_redefinir_senha	Gera senha provisória (devolvida uma vez) e encerra as sessões da pessoa.	Administrador (token)
ressalva_ler	O texto que aparece no fim de cada artigo publicado.	Administrador (token)
ressalva_definir	Grava uma versão nova da ressalva (a anterior fica no histórico).	Administrador (token)
contatos_listar	Pedidos do formulário do site no funil (Aguardando → Cancelado).	Equipe do hub (token)
contato_obter	Dados do pedido e o histórico de etapas e anotações.	Equipe do hub (token)
contato_mover	Aguardando, Contato, Proposta, Contrato, Concluído ou Cancelado.	Equipe do hub (token)
contato_anotar	Acrescenta uma anotação ao histórico do contato.	Equipe do hub (token)
contato_excluir	Apaga o contato e o histórico (pedido do titular, LGPD art.	Equipe do hub (token)
email_ler	Serviço de envio (SMTP, Brevo ou Resend) e estado — nunca o segredo.	Administrador (token)
email_salvar	Grava a configuração em configuracao (provedor smtp, brevo ou resend; o segredo, se enviado, é cifrado).	Administrador (token)
email_remover	Apaga a configuração e o segredo.	Administrador (token)
email_testar	Envia um e-mail de teste pelo serviço configurado.	Administrador (token)
ia_listar	OpenAI, Anthropic e Gemini: se há chave, o modelo padrão, os modelos vistos e o último teste — nunca a chave.	Administrador (token)
ia_salvar	Grava o modelo padrão e, se enviada, a chave da API (cifrada).	Administrador (token)
ia_remover	Apaga a chave e o modelo padrão do provedor.	Administrador (token)
ia_testar	Pede ao provedor a lista de modelos (não gera texto nem gasta crédito) e grava o resultado.	Administrador (token)
auditoria_listar	Quem fez o quê, como e quando: escritas no hub, no site e no MCP, acessos e eventos do sistema.	Administrador (token)
monitoramento_ler	Quais peças de monitoramento estão ligadas (Sentry, GA4, Cloudflare, cópia do backup).	Administrador (token)
perfil_ler	Nome, e-mail, acesso e se há foto, da pessoa dona do token.	Equipe do hub (token)
perfil_atualizar_nome	Troca o nome da pessoa dona do token.	Equipe do hub (token)
perfil_remover_foto	Apaga a foto da pessoa dona do token; o hub volta às iniciais.	Equipe do hub (token)
notificacoes_listar	Notificações da pessoa dona do token, da mais nova à mais antiga, com filtro (todas ou não lidas) e por tipo, e o total de não lidas.	Equipe do hub (token)
notificacoes_marcar_lidas	Sem ids, marca todas as não lidas; com ids, só essas.	Equipe do hub (token)
notificacao_marcar	Marca uma notificação como lida ou de volta como não lida.	Equipe do hub (token)
notificacoes_preferencias_ler	Por tipo: no sino e por e-mail; e se o e-mail está disponível.	Equipe do hub (token)
notificacoes_preferencias_salvar	Grava, por tipo, se o aviso aparece no sino e se vai por e-mail.	Equipe do hub (token)
notificacoes_padrao_ler	O que vale, por tipo, para quem ainda não mudou as próprias preferências.	Administrador (token)
notificacoes_padrao_salvar	Grava uma versão nova do padrão por tipo (no sino, por e-mail).	Administrador (token)
painel_ler	Cloudflare, Google Analytics, Sentry e os números do hub, cada fonte com o próprio estado.	Equipe do hub (token)

API do site

Pública, sem autenticação. Contrato completo: /api/v1/openapi.json (versão 2.0.0).

acervo · 2 operações · Leitura pública do acervo editorial publicado.

Operação	O que faz
GET /api/v1/acervo	Lista as peças publicadas do acervo editorial.
GET /api/v1/acervo/{identificador}	Devolve uma peça publicada do acervo.

plataforma · 1 operação · Exame de saúde da instância — contrato da plataforma, sem versão.

Operação	O que faz
GET /api/health	Estado da instância e dos seis serviços canônicos.

medicao · 1 operação · Configuração pública de medição de audiência, lida só depois do aceite de cookies.

Operação	O que faz
GET /api/v1/medicao	ID público do Google Analytics 4, quando configurado.

contatos · 1 operação · Pedido de atendimento enviado pelo formulário do site (rodada E).

Operação	O que faz
POST /api/v1/contatos	Recebe um pedido de atendimento do formulário do site.

blog · 2 operações · O blog exatamente como o site mostra (AURORA-ADR-012).

Operação	O que faz
GET /api/v1/blog	Artigos publicados no blog, como o site mostra.
GET /api/v1/blog/{categoria}/{slug}	Um artigo publicado, pelo endereço que ele tem no site.

contrato · 1 operação · Este contrato, servido pela própria aplicação.

Operação	O que faz
GET /api/v1/openapi.json	Este contrato, em JSON (AURORA-SPEC-007 C-03, AURORA-ADR-012).

mcp · 3 operações · Servidor MCP no mesmo processo (AURORA-ADR-012).

Operação	O que faz
GET /mcp	Não há fluxo de eventos nem sessão (sem estado).
POST /mcp	Servidor MCP (Streamable HTTP, sem estado, resposta em JSON).
DELETE /mcp	Não há sessão a encerrar (sem estado).

API do hub

É a mesma API que a interface do hub usa: exige sessão de quem está logado, e cada acesso (operador, administrador) vê o que lhe cabe. Para automação, use o MCP com token. Contrato completo: https://app.auroraliderancacontabilidade.com/api/v1/openapi.json (versão 2.0.0).

sessao · 6 operações

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/sessao	Quem está logado.
POST https://app.auroraliderancacontabilidade.com/api/v1/sessao	Entra com e-mail e senha.
DELETE https://app.auroraliderancacontabilidade.com/api/v1/sessao	Encerra a sessão.
POST https://app.auroraliderancacontabilidade.com/api/v1/sessao/senha	Troca a própria senha (inclusive a provisória do primeiro acesso).
POST https://app.auroraliderancacontabilidade.com/api/v1/sessao/recuperacao	Pede o link de redefinição de senha por e-mail (rodada J).
POST https://app.auroraliderancacontabilidade.com/api/v1/sessao/recuperacao/confirmar	Cria a senha nova com o código do link; encerra as sessões abertas da pessoa.

artigos · 6 operações

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/artigos	listar_artigos
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos	Cria um rascunho vazio.
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/importar-redigidos	Leva ao hub, como rascunhos, os artigos redigidos no código (só administrador).
GET https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}	obter_artigo
PUT https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/conteudo	Salva uma versão nova do rascunho (igual à anterior não cria versão).
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/devolver	Revisor devolve à autora, com o motivo na trilha.

pessoas · 4 operações

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/pessoas	Só administrador.
POST https://app.auroraliderancacontabilidade.com/api/v1/pessoas	Cria a conta com senha provisória, mostrada uma vez nesta resposta.
PATCH https://app.auroraliderancacontabilidade.com/api/v1/pessoas/{id}	alterar_pessoa
POST https://app.auroraliderancacontabilidade.com/api/v1/pessoas/{id}/redefinir-senha	Nova senha provisória; as sessões da pessoa são encerradas.

configuracao · 4 operações

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/configuracao	ler_configuracao
PUT https://app.auroraliderancacontabilidade.com/api/v1/configuracao/ressalva	Grava uma versão nova da ressalva (a anterior fica no histórico).
GET https://app.auroraliderancacontabilidade.com/api/v1/configuracao/notificacoes	O padrão do escritório por tipo, para quem ainda não mudou as próprias preferências.
PUT https://app.auroraliderancacontabilidade.com/api/v1/configuracao/notificacoes	Grava uma versão nova do padrão (a anterior fica no histórico).

contatos · 5 operações

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/contatos	Funil de contatos do site.
GET https://app.auroraliderancacontabilidade.com/api/v1/contatos/{id}	obter_contato
DELETE https://app.auroraliderancacontabilidade.com/api/v1/contatos/{id}	Apaga o contato e o histórico (pedido do titular, LGPD art.
POST https://app.auroraliderancacontabilidade.com/api/v1/contatos/{id}/etapa	mover_contato
POST https://app.auroraliderancacontabilidade.com/api/v1/contatos/{id}/anotacoes	anotar_contato

integracoes · 9 operações

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/integracoes/email	Estado do SMTP do cliente.
PUT https://app.auroraliderancacontabilidade.com/api/v1/integracoes/email	Grava a configuração (SMTP, Brevo ou Resend); o segredo, quando enviado, é cifrado (AES-256-GCM).
DELETE https://app.auroraliderancacontabilidade.com/api/v1/integracoes/email	remover_integracao_de_email
POST https://app.auroraliderancacontabilidade.com/api/v1/integracoes/email/teste	testar_integracao_de_email
GET https://app.auroraliderancacontabilidade.com/api/v1/integracoes/ia	Chaves de IA do escritório (rodada P) — o estado de cada provedor, nunca a chave.
PUT https://app.auroraliderancacontabilidade.com/api/v1/integracoes/ia/{provedor}	Grava o modelo padrão e, se enviada, a chave da API (cifrada).
DELETE https://app.auroraliderancacontabilidade.com/api/v1/integracoes/ia/{provedor}	remover_chave_de_ia
POST https://app.auroraliderancacontabilidade.com/api/v1/integracoes/ia/{provedor}/teste	Pede a lista de modelos ao provedor (não gera texto nem gasta crédito); o resultado fica em ultimoTeste.
GET https://app.auroraliderancacontabilidade.com/api/v1/integracoes/monitoramento	Peças de monitoramento ligadas por variável do servidor.

painel · 1 operação

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/painel	Cloudflare, Google Analytics, Sentry e números do hub (shared/painel.ts).

tokens · 3 operações · Tokens pessoais do MCP (AURORA-ADR-012).

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/tokens	Os tokens ativos de quem pede (nunca o token inteiro).
POST https://app.auroraliderancacontabilidade.com/api/v1/tokens	Cria um token pessoal do MCP.
DELETE https://app.auroraliderancacontabilidade.com/api/v1/tokens/{id}	Revoga um token de quem pede.

perfil · 5 operações · Meu perfil (rodada N, AURORA-ADR-013).

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/conta	A conta de quem está logado (nome, e-mail, acesso e versão da foto).
PUT https://app.auroraliderancacontabilidade.com/api/v1/conta/perfil	Troca o próprio nome.
PUT https://app.auroraliderancacontabilidade.com/api/v1/conta/foto	Grava a própria foto (PNG, JPEG ou WebP em data URL, até 256 KB; o hub reduz para 256 px antes de enviar).
DELETE https://app.auroraliderancacontabilidade.com/api/v1/conta/foto	Remove a própria foto; o hub volta a mostrar as iniciais.
GET https://app.auroraliderancacontabilidade.com/api/v1/pessoas/{id}/foto	A foto de uma pessoa do hub, para avatares (só com sessão).

notificacoes · 5 operações · Notificações de quem está logado (rodada O, AURORA-ADR-013).

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/notificacoes	As próprias notificações, da mais nova à mais antiga, com o total de não lidas.
POST https://app.auroraliderancacontabilidade.com/api/v1/notificacoes/lidas	Marca como lidas todas as não lidas, ou só as dos ids enviados.
GET https://app.auroraliderancacontabilidade.com/api/v1/notificacoes/preferencias	Por tipo, no sino e por e-mail; e se o e-mail está disponível.
PUT https://app.auroraliderancacontabilidade.com/api/v1/notificacoes/preferencias	Grava as preferências; tipos que o acesso não recebe são ignorados.
PATCH https://app.auroraliderancacontabilidade.com/api/v1/notificacoes/{id}	Marca uma notificação como lida ou de volta como não lida.

publicacoes · 6 operações · Agenda e cadência de publicação do blog (rodada S).

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/publicacoes/agenda	Agendadas (da mais próxima) e o histórico de 90 dias.
POST https://app.auroraliderancacontabilidade.com/api/v1/publicacoes/agenda	Agenda (ou reagenda) a publicação de um artigo aprovado.
DELETE https://app.auroraliderancacontabilidade.com/api/v1/publicacoes/agenda/{id}	Cancela a publicação agendada; o artigo continua aprovado.
POST https://app.auroraliderancacontabilidade.com/api/v1/publicacoes/agenda/{id}/publicar-agora	Publica já o artigo agendado.
GET https://app.auroraliderancacontabilidade.com/api/v1/publicacoes/cadencia	Dias e horário (Brasília) e o próximo horário livre sugerido.
PUT https://app.auroraliderancacontabilidade.com/api/v1/publicacoes/cadencia	Grava uma versão nova da cadência.

auditoria · 2 operações · Quem fez o quê, como e quando (rodada Q, AURORA-ADR-013 D-6).

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/auditoria	Registros de auditoria, do mais novo ao mais antigo.
GET https://app.auroraliderancacontabilidade.com/api/v1/auditoria/exportacao	Os mesmos filtros, até 10 mil registros, em CSV (;, UTF-8 com BOM).

contrato · 1 operação

Operação	O que faz
GET https://app.auroraliderancacontabilidade.com/api/v1/openapi.json	Este contrato, em JSON (AURORA-ADR-012).

outros · 6 operações

Operação	O que faz
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/submeter
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/concluir-e-assinar
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/aprovar
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/publicar
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/despublicar
POST https://app.auroraliderancacontabilidade.com/api/v1/artigos/{id}/destacar