> ## 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.

> ## Agent Instructions
> Leia /llms.txt antes de explorar páginas. A API HTTP usa Authorization: Bearer com o JWT da conta. A chave kl_live_ serve só ao assistente MCP e não substitui o JWT. Não invente rotas, hosts públicos, SDKs ou CLI. companyId e userId vêm da sessão. Consultas não aceitam SQL. Exclusão no assistente exige confirm=true. O webhook público é POST /webhook/leads.

# Trocar por sessão

> Troca a chave kl_live_ por um JWT de 1 dia, com empresa e usuário.

Troca a chave kl\_live\_ por um JWT de 1 dia, com empresa e usuário.

```text theme={null}
POST /mcp/session
```

Autenticação: `Authorization: Bearer kl_live_...`. A integração HTTP direta continua usando o JWT da conta.

| Campo | Valor |
| - | - |
| Identificador | `mcp.session` |
| Efeito | escrita |
| Domínio | Chaves do assistente |

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "data": {
    "token": "SEU_JWT",
    "companyId": "UUID_DA_EMPRESA",
    "userId": "UUID_DO_USUARIO"
  },
  "code": "SUCCESS"
}
```

## Resposta

Sucesso: `success` é `true`, `code` é `SUCCESS` e o conteúdo vem em `data`. Falha de regra traz `message`, `status` e `code`. Falha de validação traz `error`. O índice está em [Erros e códigos](https://docs.kinglog.com.br/pages/reference/erros.md).

| Código | Quando | `code` |
| - | - | - |
| `200` | A operação concluiu | `SUCCESS` |
| `400` | Corpo ou combinação de campos recusada | `MCP_API_KEY_INVALID` |
| `401` | JWT ausente, inválido ou chave `kl_live_` revogada | `MCP_API_KEY_INVALID` |
| `403` | A pessoa, ou a chave restrita, não pode esse recurso | `FORBIDDEN` |
| `404` | Registro ou rota inexistente | `NOT_FOUND` |


## OpenAPI

````yaml openapi.json POST /mcp/session
openapi: 3.1.0
info:
  title: API KingLog
  version: 1.0.0
  description: >-
    API REST + JSON da KingLog. Produção: https://kinglog.app.br. Homologação é
    outro endereço, com os mesmos caminhos.
servers:
  - url: https://kinglog.app.br
    description: Produção
security: []
tags:
  - name: Sistema
  - name: Empresa
  - name: Usuários
  - name: Acesso
  - name: Projetos
  - name: Clientes
  - name: Equipes
  - name: Cargos
  - name: Quadros
  - name: Tarefas
  - name: Tags
  - name: Metas
  - name: OKR
  - name: Avisos
  - name: Notificações
  - name: Documentos
  - name: Sprints
  - name: Planner
  - name: CRM
  - name: Atendimento
  - name: Relatórios
  - name: Busca
  - name: Consultas
  - name: Produtos
  - name: SLA
  - name: Atendimento ao cliente
  - name: Chaves do assistente
paths:
  /mcp/session:
    post:
      tags:
        - Chaves do assistente
      summary: Trocar por sessão
      description: Troca a chave kl_live_ por um JWT de 1 dia, com empresa e usuário.
      operationId: mcp.session
      parameters: []
      responses:
        '200':
          description: >-
            A operação concluiu. success é true, code é SUCCESS e o conteúdo vem
            em data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessEnvelope'
              example:
                success: true
                data:
                  token: SEU_JWT
                  companyId: UUID_DA_EMPRESA
                  userId: UUID_DO_USUARIO
                code: SUCCESS
        '400':
          description: Corpo ou combinação de campos recusada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 400
                message: Chave inválida ou revogada
                code: MCP_API_KEY_INVALID
        '401':
          description: JWT ausente, inválido ou chave kl_live_ revogada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 401
                message: Chave inválida ou revogada
                code: MCP_API_KEY_INVALID
        '403':
          description: A pessoa, ou a chave restrita, não pode esse recurso.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 403
                message: Sem permissão
                code: FORBIDDEN
        '404':
          description: Registro ou rota inexistente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                status: 404
                message: Não encontrado
                code: NOT_FOUND
      security:
        - mcpKey: []
components:
  schemas:
    SuccessEnvelope:
      type: object
      required:
        - success
        - data
        - code
      properties:
        success:
          type: boolean
          example: true
        data:
          description: >-
            Conteúdo da operação. O exemplo 200 de cada rota preenche os campos
            do recurso.
        code:
          type: string
          example: SUCCESS
    ErrorEnvelope:
      type: object
      properties:
        success:
          type: boolean
          example: false
        status:
          type: integer
          example: 400
        message:
          type: string
        code:
          type: string
        errors:
          type: array
          items:
            type: object
        error:
          type: object
  securitySchemes:
    mcpKey:
      type: http
      scheme: bearer
      description: >-
        Chave do assistente. Todas as requisições desta rota usam Authorization
        no formato Bearer kl_live_.... A integração HTTP direta continua usando
        o JWT da conta.

````

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