# Keener AI

> Um endereço MCP para a empresa toda: Claude, ChatGPT ou o chat do portal com memória compartilhada e acesso a bancos, APIs e robôs, com permissões por pessoa.

Um só endereço MCP para a empresa toda. Funciona dentro do Claude, do ChatGPT ou de qualquer cliente MCP, e no chat do próprio portal: a IA lembra o que a empresa decidiu, consulta os seus sistemas e respeita o que cada pessoa pode ver.

Produto da Keener, para empresas no Brasil. Interface e atendimento em português. Site: https://ai.keener.io/

## O que é

O Keener AI é a camada entre as pessoas de uma empresa e os sistemas dela. O assistente (Claude, ChatGPT, qualquer cliente MCP ou o chat do portal) é a interface; o Keener AI dá a ele:

- **Memória compartilhada:** Memória pessoal (só a pessoa vê), da empresa e das equipes. O dono da empresa decide quem lê e quem escreve na memória da empresa.
- **Conectores:** Bancos SQL sempre em modo somente leitura, APIs a partir do OpenAPI (escritas só com confirmação) e os robôs publicados no Keener Automate.
- **Arquivos:** Lê PDFs e planilhas; cria planilhas, documentos e gráficos; roda Python num ambiente isolado (sandbox) para análises.
- **Chat com créditos pré-pagos:** No chat do portal, o modo automático escolhe o modelo (Claude ou GPT) conforme a pergunta; você também pode escolher. O uso sai de créditos comprados antes.
- **Chaves próprias (BYOK):** A empresa pode usar a própria chave da Anthropic ou da OpenAI. O que roda com ela não consome créditos; a chave fica cifrada e nunca é mostrada de novo.
- **A marca da empresa:** O logo e a cor da empresa vão nos documentos, planilhas e gráficos que a IA gera.

## Como funciona

1. **Conecte o assistente ao endereço da empresa.** Cole o endereço MCP do Keener AI no Claude, no ChatGPT ou em outro cliente MCP e entre com o login da Keener. Quem preferir usa o chat do portal, sem configurar nada.
2. **Ele lembra decisões e fatos.** O que vale guardar vira memória: pessoal, da empresa ou da equipe. Cada pessoa só vê o que tem permissão para ver.
3. **Ele consulta os seus sistemas.** Bancos de dados em modo somente leitura, APIs descritas em OpenAPI e os robôs do Keener Automate viram ferramentas do assistente.

## Como conectar um cliente MCP

Endereço MCP (Streamable HTTP, o mesmo para todas as empresas; o login de cada pessoa define a empresa): https://keener-ai-api.azurewebsites.net/mcp

1. Crie a conta em https://ai.keener.io/cadastro (ou peça um convite ao dono da sua empresa). Cada pessoa precisa de uma licença do Keener AI.
2. **Claude** (claude.ai, desktop ou celular): Configurações → Conectores → Adicionar conector personalizado. Cole https://keener-ai-api.azurewebsites.net/mcp e clique em Conectar. O Claude abre o login da Keener (keener-id); entre e escolha a empresa.
3. **ChatGPT:** Configurações → Conectores → Criar (com o modo desenvolvedor ativado). Use a URL https://keener-ai-api.azurewebsites.net/mcp com autenticação OAuth, entre na Keener e escolha a empresa.
4. **Outro cliente MCP** (Claude Code, Cursor e outros): use a URL https://keener-ai-api.azurewebsites.net/mcp. Com OAuth, ele encontra o login da Keener sozinho (https://keener-ai-api.azurewebsites.net/.well-known/oauth-protected-resource). Sem OAuth, crie uma chave de acesso no portal (Conta › Chaves de acesso) e envie no cabeçalho `Authorization: Bearer ka_…`.
5. Pronto: o assistente lista as ferramentas da empresa (memória, conectores, arquivos). Sem licença ou com o plano vencido, ele mostra só como contratar.

## API para os seus sistemas (/v1)

Base: https://keener-ai-api.azurewebsites.net · documentação: https://ai.keener.io/docs/api

- `GET /v1/models`: Os modelos que a empresa liberou, com o preço em reais por 1 mil tokens e os níveis (rápido, equilibrado, avançado).
- `POST /v1/chat`: Uma chamada ao modelo: mensagens, arquivos opcionais (base64 ou https), resposta em texto ou em JSON conferido.
- `POST /v1/chat/async`: O mesmo pedido na fila: responde 202 com o jobId e envia a resposta, assinada, para o seu webhook (https). Com o cabeçalho Idempotency-Key, repetir o pedido em até 24 h devolve o mesmo jobId (200) sem cobrar de novo.
- `GET /v1/jobs/:id`: A situação de um pedido assíncrono e, quando pronto, a resposta ou o erro.
- `POST /v1/jobs/:id/cancel`: Cancela um pedido assíncrono: na fila, na hora (200); rodando, ele é interrompido e o que já rodou é cobrado (202); já terminado, 409.

### Autenticação

- Cabeçalho Authorization: Bearer <chave>, com uma chave de acesso do Keener AI (ka_…) ou um token OAuth (kaa_…) do keener-id, o login único da Keener. A mesma chave serve para o MCP.
- A chave é de uma pessoa numa empresa: crie-a no portal, em Conta › Chaves de acesso. A pessoa precisa de uma licença do Keener AI.
- Valem as regras da empresa: modelos liberados, limite de saída, limites de gasto e de pedidos por minuto (120 por padrão).
- Cada chamada é cobrada dos créditos da empresa, ou não custa créditos quando a empresa tem a própria chave do provedor, e fica no extrato e na auditoria (sem o conteúdo das mensagens).

### POST /v1/chat: pedido (JSON)

- `model` (string): Um id de GET /v1/models, ou "auto" para escolher pela complexidade.
- `complexity` (low | medium | high): No lugar de model: o modelo mais barato do nível (medium quando nenhum dos dois vem).
- `messages` ([{ role, content }]): De 1 a 200 mensagens (system, user, assistant); pelo menos uma de user, terminando com user.
- `files` ([{ mimeType, data } | { url }]): Até 20 arquivos na última mensagem: imagens, PDF, docx, xlsx, csv, texto. O tipo real vem dos bytes.
- `maxOutputTokens` (inteiro): Limitado pelo modelo e pela empresa.
- `responseFormat` (text | json): json: a resposta precisa ser um JSON válido (com responseSchema, as chaves obrigatórias são conferidas).
- `responseSchema` (JSON Schema): Só com responseFormat json.

### Resposta

```json
{
  "requestId": "5f0c…",
  "content": "…o texto do modelo…",
  "json": { "nome": "João", "idade": 32 },
  "model": "claude-sonnet-5-5",
  "tier": "medium",
  "usage": { "inputTokens": 1200, "outputTokens": 80, "cacheReadTokens": 0, "cacheWriteTokens": 0 },
  "costCentavos": 3,
  "balanceCentavos": 49870
}
```

- json só no modo JSON; tier só quando o pedido usou complexity; byok: true quando a chave da empresa atendeu (custo 0); truncated quando a resposta bateu no limite de saída.
- costCentavos é o que o pedido descontou dos créditos; o cabeçalho X-Request-Id repete o requestId.

### Erros

- Todo erro vem como { statusCode, message, reason }, com a mensagem em português.
- 401 nao_autenticado (sem chave, chave vencida ou de outro destino); 403 sem_plano, plano_suspenso, sem_licenca ou chat_desligado; 429 limite_requisicoes (com Retry-After).
- 400 pedido_invalido, modelo_nao_liberado, url_recusada; 402 sem_creditos, limite_mensal, limite_empresa; 413 arquivo_grande; 415 tipo_nao_suportado; 422 resposta_invalida (JSON que não confere, cobrado).
- 502 erro_modelo (nada cobrado); 504 tempo_esgotado.

### Exemplo

```bash
curl -X POST https://keener-ai-api.azurewebsites.net/v1/chat \
  -H "Authorization: Bearer ka_..." -H "content-type: application/json" \
  -d '{
    "complexity": "low",
    "messages": [
      { "role": "system", "content": "Você classifica e-mails de uma corretora." },
      { "role": "user", "content": "Classifique: Bati o carro ontem, como abro o sinistro?" }
    ],
    "maxOutputTokens": 200
  }'
```

## Preços

Preços em reais (BRL).

- **Planos:** Individual: R$ 59 por mês. Inclui R$ 20,00 em créditos por mês, que renovam todo mês e não acumulam. Equipe: R$ 49 por pessoa por mês. Inclui R$ 15,00 em créditos por pessoa/mês, compartilhados pela equipe; renovam todo mês e não acumulam. Créditos extras em pacotes (não expiram): R$ 50, R$ 100, R$ 250 ou R$ 500. Grandes empresas: fale conosco. Com a sua própria chave de API (Anthropic ou OpenAI) o chat não consome créditos.
- **Teste grátis:** 30 dias grátis com 5 licenças, sem cartão. O teste inclui R$ 5,00 em créditos.
- **Créditos:** os créditos incluídos no plano são gastos primeiro e não acumulam de um mês para o outro; os pacotes pré-pagos (R$ 50, R$ 100, R$ 250 ou R$ 500) não expiram. Cada mensagem do chat e cada chamada à API descontam o custo dos tokens.
- **Chave própria (BYOK):** o que roda com a chave da Anthropic ou da OpenAI da empresa não consome créditos.
- **Keener Automate:** plano à parte (https://automate.keener.io).

Preço por modelo quando a pessoa escolhe o modelo; no modo automático o mesmo modelo custa 10% menos:

| Modelo | Nível | Entrada (R$ por 1 mil tokens) | Saída (R$ por 1 mil tokens) |
|---|---|---|---|
| Claude Haiku 5.5 (`claude-haiku-5-5`) | Rápido | R$ 0,0011 | R$ 0,0057 |
| Claude Sonnet 5.5 (`claude-sonnet-5-5`) | Equilibrado | R$ 0,023 | R$ 0,11 |
| Claude Opus 5.5 (`claude-opus-5-5`) | Avançado | R$ 0,046 | R$ 0,23 |

## Segurança

- **Identidade única Keener:** O login é o keener-id, o mesmo do Keener Automate: um link no e-mail, sem senha.
- **Tokens com audiência:** Cada token vale só para o Keener AI e para uma empresa, e é conferido no keener-id antes de cada uso.
- **Permissões de memória por pessoa:** Memória pessoal é só da pessoa; a da empresa e a das equipes seguem o acesso que o dono dá a cada um.
- **Auditoria de cada chamada:** Cada ferramenta usada e cada chamada à API ficam registradas: quem, quando, o quê e o resultado.
- **Segredos no Azure Key Vault:** Senhas de bancos e chaves de APIs ficam no Azure Key Vault; a configuração guarda só a referência.
- **Dados no Azure:** Memória, conversas, arquivos e registros ficam hospedados no Microsoft Azure.
- **Quem processa o quê:** O que vai para um modelo é processado pela Anthropic (Claude) ou pela OpenAI (GPT), fora do Brasil. A busca na memória usa a Voyage AI e o Python roda na E2B.

## Perguntas frequentes

### O que é MCP?

MCP (Model Context Protocol) é o padrão aberto que assistentes de IA usam para se conectar a ferramentas e dados. O Keener AI é um servidor MCP: você cola um endereço no assistente e ele passa a ter a memória e os sistemas da empresa.

### Funciona com quais assistentes?

Claude (web, desktop e celular), ChatGPT (conectores, no modo desenvolvedor) e qualquer cliente MCP por HTTP, como Claude Code e Cursor. Sem assistente nenhum, use o chat do portal.

### Onde ficam os dados?

Memória, conversas, arquivos e registros ficam no Microsoft Azure. O que vai para um modelo é processado pela Anthropic ou pela OpenAI, fora do Brasil; a busca na memória usa a Voyage AI e a análise em Python roda na E2B, num ambiente isolado.

### Quem vê a memória?

A memória pessoal só a própria pessoa vê. A memória da empresa e das equipes depende do acesso que o dono dá a cada pessoa: nenhum, leitura ou escrita. O dono da empresa vê tudo e pode corrigir ou apagar entradas; cada acesso desses fica na auditoria.

### Como funcionam os créditos?

Individual: R$ 59 por mês. Inclui R$ 20,00 em créditos por mês, que renovam todo mês e não acumulam. Equipe: R$ 49 por pessoa por mês. Inclui R$ 15,00 em créditos por pessoa/mês, compartilhados pela equipe; renovam todo mês e não acumulam. Créditos extras em pacotes (não expiram): R$ 50, R$ 100, R$ 250 ou R$ 500. Grandes empresas: fale conosco. Os créditos são comprados à parte, em pacotes pré-pagos (R$ 50, R$ 100, R$ 250 ou R$ 500). Cada mensagem do chat ou chamada à API desconta o custo dos tokens em reais, pela tabela de preços. O dono pode pôr limites por pessoa e para a empresa.

### Posso usar a minha própria chave?

Sim. Cadastre uma chave da Anthropic ou da OpenAI: o que roda com ela não consome créditos, e o provedor cobra o uso direto de você. A chave fica cifrada e nunca é mostrada de novo.

### O que acontece depois do teste?

O teste dura 30 dias, com 5 licenças, sem cartão. Para continuar, o dono contrata as licenças no portal, por Pix ou cartão. Sem contratar, o assistente passa a mostrar só como contratar; nada é apagado.

### Como cancelo?

O dono pode reduzir as licenças no portal quando quiser; o valor novo vale a partir da próxima cobrança. Para cancelar a assinatura, fale com a Keener em contato@keener.io.

## Links

- [Começar grátis](https://ai.keener.io/cadastro)
- [Entrar](https://ai.keener.io/login)
- [API para os seus sistemas](https://ai.keener.io/docs/api)
- [Resumo para agentes](https://ai.keener.io/llms.txt)
- [Keener Automate](https://automate.keener.io)
- [Falar com a Keener](mailto:contato@keener.io)