> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinglog.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Cole a URL do assistente e a chave kl_live_ no Cursor ou no Claude. Nada para instalar.

O assistente da KingLog fala com a sua conta pelo [Model Context Protocol](https://modelcontextprotocol.io). Você cola a URL que a KingLog entregou e a chave `kl_live_`. A conversa passa a buscar tarefa, abrir lead e registrar o que mudou, com as permissões dessa pessoa.

> [!NOTE]
>
> A chave é a sessão. Empresa e usuário já vão nela. O segredo aparece uma vez, na criação, e cada pessoa tem a sua. Há no máximo 10 chaves ativas por usuário na empresa.

## Pré-requisitos

* A URL do assistente, no formato `https://SUA_URL_MCP/mcp`. Ela vem no campo `configs` quando a chave é criada.
* Uma chave `kl_live_`, criada com o JWT da conta. O passo a passo está em [Chaves de API](https://docs.kinglog.com.br/pages/start/chaves).

## Configuração

> [tab] Cursor
>
> Em **Settings → MCP**, cole o objeto `configs.http` da criação da chave, ou monte:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "kinglog": {
>       "url": "https://SUA_URL_MCP/mcp",
>       "headers": {
>         "Authorization": "Bearer kl_live_SUA_CHAVE"
>       }
>     }
>   }
> }
> ```
>
> Peça a sessão. A resposta mostra a empresa e o usuário, sem revelar a chave.

> [tab] Claude
>
> Em **Settings → Connectors**, adicione um conector. Nome: `KingLog`. URL: `https://SUA_URL_MCP/mcp`.
>
> Se o conector pedir cabeçalho, use `Authorization` com o valor `Bearer kl_live_SUA_CHAVE`.
>
> Na conversa, abra os anexos e selecione KingLog.
>
> No Claude Code:
>
> ```bash theme={null}
> claude mcp add --transport http kinglog https://SUA_URL_MCP/mcp \
>   --header "Authorization: Bearer kl_live_SUA_CHAVE"
> ```

> [!WARNING]
>
> A chave é um segredo. Não coloque em repositório, print ou chat compartilhado. Se ela vazou, revogue e crie outra.

## O que a conversa consegue fazer

| Você pede | A ferramenta |
| - | - |
| Conferir se entrou na empresa certa | `kinglog_session` |
| Achar um registro pelo nome | `kinglog_search` |
| Abrir a tarefa, o lead ou o ticket | `kinglog_page` |
| Listar ou atualizar pelo catálogo | `kinglog_read` e `kinglog_call` |
| Contar, filtrar ou ver um indicador | `kinglog_query_data`, `kinglog_aggregate_data`, `kinglog_metrics` |

A página da tarefa inclui checklist, comentários, dependências e compromissos. A do lead inclui atividades. A do ticket inclui comentários.

Apagar só acontece se você pedir e a chamada for com confirmação. Envio de arquivo, senha, cobrança e administração da plataforma ficam no produto, com o seu login.

As regras que o agente segue estão em [Skills](https://docs.kinglog.com.br/pages/ai/skills.md). Os caminhos HTTP estão na [referência](https://docs.kinglog.com.br/pages/reference/introduction.md).

## Solução de problemas

> [accordion] A chave foi recusada
>
> Confira se o valor colado começa com `kl_live_` e se a chave ainda está ativa. Chave revogada ou incompleta não abre sessão. Crie outra em [Chaves de API](https://docs.kinglog.com.br/pages/start/chaves) e atualize o header.

> [accordion] O Cursor ou o Claude não conecta
>
> A URL precisa ser a do assistente, com `https` e o caminho `/mcp`. Depois de salvar, reinicie o conector. Se a URL no JSON veio como texto de exemplo, peça à KingLog a URL do seu ambiente.

> [accordion] Ele não acha a tarefa ou o lead
>
> O agente usa o id que a KingLog devolveu, não o título de memória. Peça para buscar de novo e só então abrir ou alterar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.