Octri: gerador de documentação de API, SDKs e MCP

Octri é um gerador de documentação de API que também cria bibliotecas SDK, oferece acesso via MCP e reúne monitoramento. O objetivo é manter os recursos entregues aos desenvolvedores ligados à mesma especificação.

O que o Octri faz, em linguagem simples?

Imagine a especificação como o manual que descreve os pedidos aceitos pela API e as respostas que ela devolve. O Octri transforma esse manual em um site para leitura, pacotes que outros programas podem instalar e ferramentas para assistentes de IA.

É útil para empresas SaaS, provedores de API e equipes que atendem desenvolvedores de várias plataformas. A API real continua sendo sua responsabilidade, assim como conferir as explicações geradas. Os quatro módulos podem ser usados separadamente.

Criar a documentação e testar uma integração

API Studio organiza endpoints, parâmetros, esquemas aninhados e exemplos de requisição. Você pode editar a página gerada e escrever guias MDX para autenticação, primeiros passos ou fluxos que envolvam várias chamadas.

1. Envie a especificação ou conecte o repositório GitHub.
2. Confira operações, autenticação e modelos de entrada e saída.
3. Gere as páginas e ajuste os textos de acordo com a implementação.
4. Execute uma requisição válida e um caso de erro em ambiente de testes.
5. Configure publicação e SDKs, se necessário, e revise o rascunho e as diferenças antes de aprovar.

A chamada da interface de teste sai do navegador do leitor, portanto as regras CORS da API precisam permitir o acesso. A sincronização pode iniciar uma reconstrução, mas novas versões dos SDKs passam por aprovação antes de chegar aos registros de pacotes.

Onde termina o gratuito?

Valores mensais oficiais em dólares americanos, conferidos em 6 de outubro de 2026. Os planos pagos são anunciados sem impostos; não se trata de uma cotação em reais.

• Free: um projeto, uma linguagem de SDK, 50 endpoints, 100 MB de monitoramento por mês e 100 créditos de IA concedidos uma única vez.
• Starter: US$ 49 por mês, com duas linguagens de SDK.
• Growth: US$ 99 por mês, com quatro linguagens, versões e código ou componentes personalizados.
• Business: US$ 249 por mês, com os dez linguagens e white-label.
• Enterprise: sob consulta, com gerador e renderizador de documentação disponíveis para infraestrutura própria.

Gerar a descrição de um endpoint ou receber uma resposta no Ask-the-docs consome um crédito. Editar manualmente, construir SDKs e hospedar o site não usam esse saldo. Veja limites completos e adicionais no comparativo oficial de planos.

SDKs para dez linguagens de programação

SDK Studio suporta TypeScript, Python, Go, Java, Kotlin, Ruby, PHP, Rust, Swift e Dart. É possível ajustar nomes de métodos, excluir endpoints internos e configurar opções por linguagem antes de gerar e publicar os pacotes.

O total de linguagens ativadas depende do plano. Código SDK personalizado está listado a partir do Growth. Antes de distribuir, valide autenticação e respostas específicas da sua API; gerar a biblioteca não substitui testar a integração.

MCP para consultar documentação e executar chamadas

O servidor MCP fornece sete ferramentas de documentação e pode expor endpoints selecionados como operações executáveis. Claude, Cursor e outros clientes recebem informações publicadas e atualizadas sobre a API.

Para leitura, basta o identificador do projeto. A execução depende das credenciais da API, que ficam na máquina onde o servidor roda. Defina ambiente, permissões e exclusões de endpoints antes de conectar ações com efeitos reais.

Monitoramento e privacidade dos dados

O monitoramento começa desligado. Depois de ativado, SDKs e pacotes de backend podem enviar logs, erros agrupados e traces, além de permitir verificações de disponibilidade e alertas. A documentação oficial descreve ocultação de dados sensíveis no cliente e na ingestão.

A política de privacidade explica que partes da especificação são enviadas a provedores de modelos para geração; perguntas e trechos relevantes são usados nas respostas; a busca também envolve embeddings. O Octri afirma que esses conteúdos não treinam modelos, mas o processamento não ocorre inteiramente no dispositivo.

Perguntas frequentes

Posso usar gratuitamente?

Sim, respeitando as cotas de Free. Domínio próprio e sincronização GitHub estão incluídos. Quando acabam os créditos, param as funções de IA, enquanto documentação publicada, builds de SDK e monitoramento continuam.

O Octri aceita Swagger e Postman?

Sim. A lista também inclui OpenAPI 3.0/3.1 e AsyncAPI, em JSON ou YAML. Confira os modelos depois da importação.

A atualização apaga minhas correções?

Segundo o Octri, as alterações manuais são preservadas por campo na regeneração. Os campos gerados que não foram editados podem ser atualizados.

Recursos oficiais

• Documentação do Octri: configuração e guias por linguagem.
• Octri no GitHub: pacotes públicos e problemas nos SDKs.
• Suporte de produto e cobrança: canais oficiais e solução de problemas.