# A API cobre tudo o que existe na interface

Cada tela do Krokul roda na mesma API aberta para você: chaves com permissões de perfil, webhooks com novas tentativas, documentação gerada do código e MCP para agentes de IA.

**Em resumo.** O Krokul é um CRM B2B com uma API pública v1 que cobre todos os dados e ações da interface, porque a própria interface roda nela. As chaves de API são criadas com permissões de perfil e registro de chamadas; os webhooks enviam eventos (negócio, documento, pagamento, empresa cliente) com fila de entrega, novas tentativas e log; a documentação em inglês é gerada a partir da especificação do código e traz exemplos de respostas reais; o servidor MCP permite que agentes de IA leiam e ajam dentro das permissões da chave. Tudo isso faz parte do produto, sem exigir um plano superior.

**Plano:** Disponível a partir do plano Dinheiro, US$ 149 por mês; MCP e limites maiores no plano Margem

## Como é sem o Krokul

2. Um webhook não chegou porque o servidor do cliente ficou fora do ar por três minutos. O evento se perde, o pedido não é criado, e ninguém percebe.
3. A API só existe no plano caro, e a documentação são três páginas sem exemplos. A integração custa mais do que o CRM.

## O que o Krokul faz

### Uma API para a tela e para você

A interface do Krokul chama as mesmas rotas que uma chave de API libera. Um campo que você vê na tela também está na API, por construção.

### Chaves com permissões de perfil

Uma chave é criada para um perfil: vendedor, contador, somente leitura. O que o perfil não pode fazer, a chave também não pode; cada chamada fica registrada.

### Webhooks com fila

Eventos de negócios, documentos, pagamentos e empresas clientes são enviados para a sua URL com fila, novas tentativas em caso de falha e log de entrega. Os eventos não entregues ficam visíveis e podem ser reenviados à mão.

### Documentação a partir do código, e MCP

A especificação é derivada do código, e os exemplos vêm de respostas reais, então a documentação não fica desatualizada. O servidor MCP conecta agentes de IA com as mesmas permissões da chave.

## Como funciona

1. **Crie uma chave para um perfil** Nas configurações: nome, perfil, validade. A chave vê exatamente o que uma pessoa com esse perfil veria.
2. **Leia a documentação com exemplos** Documentação em inglês que descreve cada rota e os seus campos, com exemplos de resposta, no endereço indicado no rodapé do site.
3. **Conecte os webhooks** Uma URL e os eventos; o log de entrega mostra cada tentativa com o código de resposta. Em caso de falha, a nova tentativa acontece pela agenda ou à mão.
4. **Conecte um agente pelo MCP** Uma chave e o endereço do MCP, e um agente de IA externo lê dados e propõe ações dentro das suas permissões, com o mesmo log.

## Resultado

- Nenhum evento se perde: a fila e as novas tentativas entregam o webhook, e o log mostra cada tentativa.
- API, webhooks e MCP não têm preço à parte: fazem parte do produto.

## O que não está incluído

## Perguntas

### A API cobre mesmo tudo?

Sim, porque a interface roda nas mesmas rotas: não temos uma API “interna” separada com mais recursos.

### Como limito o que uma chave pode ver?

Pelo perfil. Uma chave somente leitura não cria nada; uma chave com perfil de vendedor não vê o custo. O servidor garante isso.

### E se um webhook não chegar?

O log de entrega mostra a tentativa e o código de resposta; a nova tentativa acontece automaticamente pela agenda ou à mão, com um botão.

### O que é MCP e para que serve?

Um protocolo que os agentes de IA usam para ler dados e chamar ações. O Krokul tem o seu próprio servidor MCP: conecte um agente com uma chave, e ele vai ver exatamente o que o perfil permite.

### Quanto custa a API?

A API, as chaves e os webhooks estão incluídos no plano Dinheiro, US$ 149 por mês; o MCP e os limites maiores de chamadas estão no plano Margem. Os registros criados pela API contam como transações, iguais aos criados na tela.

### Como conectar um serviço que não está no Marketplace?

Com uma regra de integração própria: o Kro a monta a partir da sua descrição, a regra é testada com eventos de exemplo e só pode ser ativada depois desse teste. O serviço envia um evento para o endereço da regra — o Krokul encontra o negócio, o documento ou o contato e cria um pagamento, um contato ou uma tarefa; cada evento fica no registro. Regras próprias estão no plano Margin.

## Abra a documentação e faça a primeira requisição

Crie uma chave nas configurações, chame a rota de empresas clientes e receba a sua lista, em cinco minutos, sem escrever para o suporte.

Incluído no plano Dinheiro.

## Próximo na cadeia

- [Automações: o sistema faz a rotina e mostra por quê](https://krokul.com/pt-BR/solutions/automations/index.md)
- [O perfil decide quem vê o quê. O servidor garante](https://krokul.com/pt-BR/solutions/security/index.md)
- [Os seus dados são seus: API, exportação e reversão desde o primeiro dia](https://krokul.com/pt-BR/solutions/data/index.md)
- [Um assistente de IA que configura o sistema em palavras simples](https://krokul.com/pt-BR/solutions/assistant/index.md)

---

Aplicativo: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs