Documentação · MCP

Conecte sua IA ao seu quadro de tarefas

A Klyven tem um servidor MCP nativo: Claude, ChatGPT ou qualquer cliente compatível cria, move, comenta e conclui tarefas do seu workspace por linguagem natural. Esta página documenta como conectar e o que a IA consegue fazer.

O que é o MCP da Klyven?

MCP (Model Context Protocol) é o protocolo aberto que conecta assistentes de IA a ferramentas externas. O servidor MCP da Klyven expõe seu workspace de projetos e tarefas para a sua IA: você pede em português — "cria uma tarefa de revisar o contrato pra sexta, prioridade alta" — e o card nasce no quadro da equipe, na hora, sem abrir o app.

Funciona com Claude (web, celular e Claude Code), ChatGPT (nos planos com conectores MCP) e qualquer outro cliente que fale MCP. O endpoint é remoto (Streamable HTTP / JSON-RPC 2.0): não é preciso instalar nada.

Endpoint MCP: https://klyven.blackia.tech/mcp
Autenticação: Bearer token klv_... gerado nas Configurações do seu workspace. O token já carrega o workspace — cada token só vê e mexe no seu.

Como conectar, passo a passo

Leva poucos minutos. O caminho é o mesmo em qualquer cliente: gerar o token na Klyven e colar a URL + token no assistente.

1. Gere o token na Klyven

Entre no seu workspace → ConfiguraçõesTokens de API / MCP → gerar token. Copie o klv_... mostrado (ele aparece uma única vez; se perder, revogue e gere outro).

2a. Conectar no Claude (web e celular)

  1. Abra Settings → Connectors → Add custom connector.
  2. Cole a URL https://klyven.blackia.tech/mcp.
  3. Informe o token klv_... como autenticação.

Pronto: as tools da Klyven aparecem na conversa. Peça "o que tá pendente essa semana?" pra testar.

2b. Conectar no ChatGPT

  1. Abra Configurações → Conectores (disponível nos planos do ChatGPT que suportam conectores MCP).
  2. Adicione um conector com a URL https://klyven.blackia.tech/mcp e o token klv_....

2c. Outros clientes MCP

Qualquer cliente que suporte MCP remoto (Streamable HTTP) conecta com a mesma URL e o header Authorization: Bearer klv_.... O servidor é stateless: sem cookie, sem sessão, só o token.

As tools disponíveis

23 tools — tudo que a IA consegue fazer no seu workspace. Você não chama tool nenhuma na mão: pede em português e a IA escolhe.

ToolO que faz
klyven_contextMostra o workspace ativo, o usuário e as contagens (projetos, tarefas em aberto).
klyven_list_projectsLista os projetos do workspace, incluindo os compartilhados com você por outros workspaces (com a permissão de cada um).
klyven_list_tasksLista e filtra tarefas por status, prioridade, projeto, lista ou busca no título — do seu workspace e dos projetos compartilhados.
klyven_get_taskDetalhe completo de uma tarefa: descrição, subtarefas e comentários.
klyven_create_taskCria uma tarefa com descrição, projeto, status, prioridade, prazo, lista e etiquetas.
klyven_update_taskAtualiza uma tarefa: move status, muda prioridade, prazo, responsáveis, lista e etiquetas.
klyven_comment_taskAdiciona um comentário a uma tarefa.
klyven_update_commentEdita um comentário próprio.
klyven_delete_commentExclui um comentário próprio.
klyven_delete_taskExclui uma tarefa.
klyven_move_taskMove a tarefa para outro projeto.
klyven_add_subtaskAdiciona uma subtarefa (item de checklist) a uma tarefa.
klyven_create_projectCria um projeto.
klyven_add_attachmentAnexa imagem, PDF ou arquivo leve (até ~8 MB) a uma tarefa.
klyven_list_columnsLista as colunas do quadro de um projeto ou de uma lista.
klyven_create_columnCria uma coluna de status, opcionalmente entre duas colunas (after_key).
klyven_update_columnRenomeia, muda a cor ou marca/desmarca uma coluna como "concluído".
klyven_reorder_columnsReordena as colunas do quadro.
klyven_delete_columnExclui uma coluna; as tarefas nela migram para a primeira restante.
klyven_list_listsLista as listas de um projeto, com contagem de tarefas.
klyven_create_listCria uma lista dentro de um projeto.
klyven_update_listRenomeia ou muda a descrição de uma lista.
klyven_delete_listExclui uma lista; as tarefas nunca somem (migram ou vão para "Sem lista").

Segurança

  • Isolamento por workspace: o token carrega o workspace. A IA só enxerga e mexe no workspace daquele token — token de outro workspace recebe 404.
  • Token com hash: só o hash SHA-256 do token fica no banco; a verificação usa comparação de tempo constante.
  • Revogável: revogue qualquer token nas Configurações, na hora, sem afetar os demais.
  • Rate limit: 120 requisições por minuto por token.

Perguntas frequentes

O MCP custa à parte?

Não. O MCP está incluso em todos os planos, a partir de R$ 29/mês (Solo). Recurso travado por plano não existe na Klyven.

Preciso saber programar?

Não. Conectar é colar uma URL e um token nas configurações do seu assistente. Depois é conversa em português.

Funciona com qual IA?

Claude (web, celular e Claude Code), ChatGPT (planos com conectores MCP) e qualquer cliente compatível com MCP remoto. O protocolo é aberto — a Klyven não te prende a um fornecedor de IA.

A equipe vê o que a IA fez?

Sim. Toda ação da IA vira card, comentário ou movimento real no quadro, com histórico — a equipe vê tudo atualizado em tempo real, e quem tem tarefa atribuída recebe push no celular.

Posso conectar mais de uma IA ou mais de uma pessoa?

Pode. Cada usuário gera quantos tokens quiser (um por assistente, por exemplo) e revoga individualmente quando quiser.

Sua IA já sabe usar a Klyven

Crie o workspace, gere o token e conecte. A partir daí, seu backlog anda enquanto você conversa.

Criar workspace