API & Integrações

O Chinaski é construído para ser automatizado: uma API REST para scripts e pipelines, webhooks de saída para outros sistemas e um servidor Model Context Protocol para que assistentes de IA trabalhem o CMS diretamente. Esta seção cobre os três.

Nesta seção

• Servidor MCP: o servidor Jinja JSON-RPC sobre stdio que expõe o CMS ao Claude Code e a outros clientes MCP; setup, sessões, retries e as famílias de ferramentas.
• Referência de Ferramentas MCP: a referência por ferramenta: argumentos, comportamento e as ferramentas de composição de nível mais alto.
• Webhooks: os quatro tipos de evento de saída (form, post, publish, build), formas de payload, assinatura, retries e o log de entregas.
• Automação: a superfície de API de máquina: chaves de API (escopos leitura/escrita, rate limits, expiração), os endpoints /api/* (leituras, criações/atualizações, upserts, jobs em lote, disparos de build) e os endpoints de saúde para monitores.

Dois públicos, duas portas

• Máquinas que querem escrever scripts para o Chinaski conversam REST com uma chave de API: leituras para relatórios, create/update para pipelines, jobs para importações em lote e o disparador de build. Tudo é auditado por chave, e uma chave pode ter escopo de leitura ou escrita.
• Assistentes que querem trabalhar o CMS passam pelo servidor MCP embutido: um processo por projeto, JSON-RPC sobre stdio, apoiado no mesmo modelo de chave de API; ele sobrepõe ferramentas de nível mais alto (create-with-blocks, translate, bulk import, audits) aos verbos REST.

O que é de saída

A superfície de API também inclui webhooks de saída: eventos que o CMS envia a você, como submissões, mudanças de post, publicações agendadas e builds concluídos, cada um assinável com um segredo HMAC. O modo air-gap desabilita tudo isso (e qualquer outra chamada de saída) até uma integração ser habilitada deliberadamente.

O que a API não faz

• Nenhum endpoint público de comentários/feed (esses não existem).
• Nenhum verbo DELETE: a remoção fica na UI de admin para prevenir perda acidental de dados induzida por automação; estado de publicação e lixeira permanecem operações manuais ou de nível de editor.
• Nenhuma personificação de sessão de admin baseada em chave: chaves de API não carregam identidade de usuário nem papéis; elas atuam como seu próprio ator na trilha de auditoria.