Referência técnica do MCP

Use esta página quando precisar de detalhes de transporte, credenciais estáticas, limites de recursos ou solução de problemas de protocolo. Para a configuração pessoal mais curta, comece com Conecte Kanera ao seu agente de IA.

Métodos de conexão

Conexão	Autenticação	Acesso efetivo
OAuth interativo	Login e consentimento do navegador	Atua como o usuário conectado com capacidade de ferramenta de leitura e gravação. O cliente controla a disponibilidade e aprovação da ação; Kanera reforça a função do usuário no quadro. Ele nunca recebe acesso de administração do espaço de trabalho.
Autorização do dispositivo	Um pequeno código de usuário aprovado em um navegador em qualquer dispositivo	Atua como usuário aprovador, exatamente como o OAuth interativo. Ele nunca recebe acesso de administração do espaço de trabalho.
Agente autônomo	OAuth client_credentials	Usa uma identidade de serviço de espaço de trabalho limitada ao máximo de leitura, gravação ou administração escolhida por um administrador. Atualmente, o administrador não adiciona ferramentas ao servidor MCP padrão; use um espaço de trabalho separado ou uma chave de API de quadro para administração REST direta.
Chave de API pessoal	Token de portador estático	Atua como seu proprietário em painéis acessíveis. O MCP padrão permanece focado no trabalho; solicitações REST diretas herdam separadamente as permissões suportadas do proprietário.
Chave de API do espaço de trabalho ou quadro	Token de portador estático	Permanece fixado em seu espaço de trabalho padrão ou quadro independente e em seu escopo de leitura, gravação ou administração. O administrador não adiciona ferramentas de configuração ao MCP padrão.

Veja Conecte um agente de IA para OAuth interativo, consentimento, revogação, agentes autônomos e fluxo de autorização.

Terminais hospedados

O endpoint MCP hospedado da Kanera é:

https://mcp.kanera.app/mcp

A verificação de integridade do serviço é:

https://mcp.kanera.app/health

Os clientes compatíveis com OAuth podem adicionar o endpoint MCP diretamente e concluir a autenticação no navegador. Um cliente que usa uma chave de API a envia como um token de portador:

Authorization: Bearer kanera_live_...

Se sua equipe administra o Kanera em seu próprio endereço, o mesmo /mcp e /health caminhos se aplicam lá. Copie o endereço MCP exato mostrado em Configurações de perfil -> Chaves de API naquela Kanera.

Versões do protocolo

O endpoint hospedado atende tanto o protocolo MCP atual quanto as revisões anteriores que Claude, Codex, Cursor, Copilot, Gemini CLI e OpenCode usam hoje, no mesmo servidor. Os clientes mais antigos veem as mesmas ferramentas, recursos e prompts de antes; clientes no protocolo atual também obtêm assinaturas de eventos. Os esquemas de ferramentas são publicados no mesmo dialeto do esquema JSON para ambos, para que nenhum cliente veja um contrato diferente. kanera mcp over stdio também aceita ambos.

Segurança do token OAuth

Os clientes compatíveis com OAuth lidam com os detalhes de segurança automaticamente. O token emitido para uma conexão Kanera funciona apenas com o endereço MCP mostrado pelo Kanera; ela não pode ser reutilizada como uma credencial de API pública geral.

Se você estiver criando um cliente OAuth personalizado, envie esse endereço MCP exato como o resource durante a autorização e cada troca de token. Os exemplos de autorização de dispositivo abaixo mostram a que lugar ele pertence. Use uma chave de API pessoal, de espaço de trabalho ou de quadro para uma integração que chame a API REST diretamente.

Autorização de dispositivo para clientes CLI e headless

Um cliente que não pode receber um redirecionamento de navegador, como uma ferramenta de terminal, uma sessão SSH ou uma máquina sem navegador utilizável, pode se conectar com a concessão de autorização de dispositivo OAuth (RFC 8628). O cliente mostra um código curto, uma pessoa o aprova em um navegador em qualquer dispositivo e o cliente pesquisa até receber tokens.

O resultado é a mesma identidade do OAuth interativo. A conexão atua como o usuário aprovador com capacidade de ferramenta de leitura e gravação, enquanto Kanera continua a impor a função desse usuário em todos os quadros. Ele nunca recebe acesso de administração do espaço de trabalho. A aprovação de uma solicitação de dispositivo requer um plano que permita conexões de agente, o mesmo requisito de qualquer outra conexão de agente.

Kanera anuncia o fluxo em /.well-known/oauth-authorization-server:

Campo de metadados	Valor
device_authorization_endpoint	https://api.kanera.app/oauth/device/code
grant_types_supported	Inclui urn:ietf:params:oauth:grant-type:device_code

Registrar um cliente de dispositivo

Cadastre o cliente em /oauth/register com o tipo de concessão do dispositivo. Um cliente somente de dispositivo não precisa de um URI de redirecionamento; redirect_uris é necessário apenas quando o cliente também usa authorization_code.

curl -X POST https://api.kanera.app/oauth/register \
  -H 'content-type: application/json' \
  -d '{
    "client_name": "Acme CLI",
    "grant_types": ["urn:ietf:params:oauth:grant-type:device_code", "refresh_token"]
  }'

Kanera rejeita o fluxo de dispositivos para qualquer cliente que não tenha sido registrado com o tipo de concessão de dispositivo.

Solicite um código de dispositivo

curl -X POST https://api.kanera.app/oauth/device/code \
  -d client_id=kanera_client_... \
  -d resource=https://mcp.kanera.app/mcp \
  -d 'scope=kanera:read kanera:write offline_access'

resource é obrigatório e deve corresponder ao endereço MCP. Kanera normaliza todas as solicitações de dispositivos autorizados pelo usuário para kanera:read kanera:write, incluindo clientes que omitem scope ou solicite apenas leitura. Kanera emite um token de atualização quando o cliente registra o refresh_token tipo de concessão; offline_access é aceito, mas não obrigatório. Somente kanera:read, kanera:writee offline_access são aceitos.

Campo de resposta	Significado
device_code	O segredo que o cliente envia de volta durante a pesquisa.
user_code	O código curto que a pessoa digita, formatado como ABCD-2345.
verification_uri	O /oauth/device página em seu endereço da web Kanera.
verification_uri_complete	A mesma página com o código pré-preenchido na string de consulta.
expires_in	600. A solicitação expira dez minutos após ser emitida.
interval	5. O número mínimo de segundos entre pesquisas.

Aprovar a solicitação

1. O cliente exibe o user_code e o verification_uri, ou abre verification_uri_complete diretamente.
2. A pessoa abre esse endereço e entra no Kanera, caso ainda não o tenha feito.
3. A página nomeia o cliente, mostra o código para que possa ser verificado no terminal e lista o que o cliente poderá fazer.
4. Escolhendo Permitir acesso aprova a conexão. Escolhendo Negar rejeita.

Pesquisa de tokens

curl -X POST https://api.kanera.app/oauth/token \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=kanera_device_... \
  -d client_id=kanera_client_... \
  -d resource=https://mcp.kanera.app/mcp

A pesquisa não é mais rápida do que interval. Até que a solicitação seja concluída, o endpoint do token retorna 400 com um erro OAuth padrão:

Erro	Significado	O que o cliente deve fazer
authorization_pending	Ninguém aprovou ou negou o pedido ainda.	Continue pesquisando no intervalo atual.
slow_down	O cliente pesquisou mais rápido que o intervalo.	Kanera adiciona cinco segundos ao intervalo. Use o intervalo mais longo a partir de agora.
access_denied	A pessoa negou o pedido.	Pare de pesquisar e inicie uma nova solicitação.
expired_token	O código expirou ou seus tokens já foram emitidos.	Inicie uma nova solicitação.
invalid_grant	O código do dispositivo é desconhecido ou pertence a outro cliente.	Inicie uma nova solicitação.

Após a aprovação, o endpoint retorna a mesma carga que qualquer outra concessão: uma concessão vinculada ao público. kanera_mcp_... token de acesso válido por quinze minutos, mais um token de atualização quando o cliente registrou o refresh_token tipo de concessão. Um código de dispositivo é de uso único, portanto, uma troca repetida retorna expired_token. As solicitações de atualização devem incluir o mesmo resource.

Gerenciar ou revogar uma conexão de dispositivo onde todas as outras conexões de agente são gerenciadas, em Configurações de perfil -> Chaves de API.

Crie uma chave de API

Use chaves de API para stdio local, clientes que aceitam apenas tokens de portador estáticos ou integrações personalizadas do lado do servidor.

Chave de API pessoal

1. Abrir Configurações de perfil.
2. Vá para Chaves de API.
3. Crie uma chave de API pessoal.
4. Escolha Somente leitura ou Ler e escrever. Somente leitura é o padrão correto para um agente autônomo: Kanera recusa todas as mutações na API, portanto, as permissões da ferramenta do cliente não são a única coisa que existe entre um agente e seu trabalho. Um cliente conectado com uma chave somente leitura recebe apenas as ferramentas de leitura, portanto, ele nunca planeja uma alteração que não possa fazer.
5. Adicione uma marca própria opcional que identifique o cliente.
6. Copie o segredo quando ele for mostrado.

Uma chave pessoal tem um prefixo como kanera_u_live_.... Ele é mostrado uma vez e atua como seu proprietário, limitado pelo escopo escolhido. Armazene-o apenas no armazenamento de credenciais do cliente AI ou no gerenciador de segredos do seu servidor.

Chave de API do espaço de trabalho ou quadro

1. Abra o espaço de trabalho padrão ou quadro independente.
2. Vá para Configurações -> API.
3. Crie uma chave de API.
4. Escolha o menor escopo adequado ao fluxo de trabalho.
5. Copie o segredo quando ele for mostrado.

Escopo	Subsídios
Leia	Inspecione, pesquise, resuma e relate sem alterar o Kanera.
Escreva	Crie e atualize o conteúdo do quadro, incluindo cartões, listas de verificação, comentários, tarefas, rótulos, valores de campos personalizados e notas.
Administrador	Execute a administração direta de API pública com suporte. O servidor MCP padrão permanece focado no trabalho e não expõe ferramentas de administração de espaço de trabalho, quadro, lista, rótulo, campo, opção, retenção ou pedido.

Conecte um cliente stdio local

O servidor stdio local mais simples é o Kanera CLI. Instale-o, faça login uma vez e aponte o cliente para kanera mcp; ele serve a mesma camada de ferramenta sobre stdio usando a credencial armazenada, portanto, não há uma segunda chave para configurar em segundo lugar.

npm install --global @kanera/cli
kanera auth login

{
  "mcpServers": {
    "kanera": {
      "command": "kanera",
      "args": ["mcp"]
    }
  }
}

Usar npx @kanera/cli mcp em vez de uma instalação global quando você prefere não instalar nada, e adicione "args": ["mcp", "--profile", "agent"] para escolher um perfil nomeado.

Para fornecer a credencial por meio do ambiente, em vez de um perfil armazenado – a escolha usual em CI ou um agente em área restrita – tanto a CLI quanto o pacote MCP independente dizem:

Variável de ambiente	Objetivo
KANERA_API_KEY	Uma chave de API pessoal, de espaço de trabalho ou de quadro.
KANERA_PUBLIC_API_URL	A origem da API pública Kanera, como https://api.kanera.app.

{
  "mcpServers": {
    "kanera": {
      "command": "npx",
      "args": ["-y", "@kanera/cli", "mcp"],
      "env": {
        "KANERA_API_KEY": "kanera_u_live_...",
        "KANERA_PUBLIC_API_URL": "https://api.kanera.app"
      }
    }
  }
}

Use o terminal HTTP hospedado quando não precisar executar o processo MCP localmente.

Recursos

Kanera fornece quatro modelos de recursos JSON estruturados:

Recurso	URI	Contém
Espaço de trabalho padrão	kanera://workspace/{workspaceId}	Configuração de espaço de trabalho limitado e listas compartilhadas, rótulos, campos, modelos, automações e associação visíveis para a credencial
Quadro	kanera://board/{boardId}	Metadados limitados e configuração visível para um espaço de trabalho padrão ou quadro autônoma, sem cartões
Cartão	kanera://card/{cardId}	Detalhes do cartão, incluindo etiquetas, responsáveis, listas de verificação, anexos e notas vinculadas
Nota	kanera://note/{noteId}	Uma nota pessoal ou de equipe visível

As notas pessoais são privadas para o usuário conectado. Não sugira que outro membro do espaço de trabalho ou uma credencial de serviço do espaço de trabalho possa lê-los.

Referências de cartão

Campos do cartão MCP nomeados cardId ou cardIds aceite qualquer uma destas referências:

• Uma chave de cartão humana, como PROJ-123, incluindo uma chave exata que usa um prefixo de espaço de trabalho anterior.
• Um URL canônico do cartão Kanera.
• O UUID do cartão retornado pela API pública.

Use a chave humana em prompts e respostas voltadas ao usuário. Kanera resolve isso para o UUID antes de chamar a operação de API pública existente, para que a autorização, a atividade e o comportamento de auditoria permaneçam os mesmos. Uma chave resolvida é lembrada para a conexão por alguns minutos, portanto, repeti-la em uma tarefa de várias etapas não repete a pesquisa. Se o usuário conectado puder ver a mesma chave em mais de uma organização, use o URL canônico do cartão para identificar a organização pretendida de forma inequívoca.

Os resultados do cartão incluem a chave legível atual. O kanera://card/{cardId} o URI do recurso continua a usar o UUID; chaves humanas e links se aplicam às entradas da ferramenta MCP.

Grupos de capacidade

Os esquemas de ferramentas ativas são a autoridade para nomes, entradas, anotações de segurança e limites. O servidor atualmente cobre:

Área	Operações disponíveis
Descoberta	Inspecionar a sessão de atuação, paginar espaços de trabalho padrão e quadros acessíveis, ler espaço de trabalho limitado ou configuração do quadro e paginar quadros e membros
Limite de configuração	Leia listas, rótulos, campos, opções, membros e permissões necessárias para direcionar o trabalho. Criar, editar, reordenar, reter e outras operações de administração de lista/espaço de trabalho permanecem na interface Kanera e não são ferramentas MCP
Pesquisar	Pesquise cartões ativos, notas, comentários e nomes de arquivos anexos ou pesquise a documentação oficial do Kanera
Cartões	Leia resumos ou conteúdo completo, busque conteúdo de checklist/comentário limitado para até 200 cartões selecionados, crie, atualize, mova, reordene, copie, mova entre quadros compatíveis, arquive, desarquive, complete, reabra e gerencie anexos e capas
Relacionamentos de cartão	Leia links individuais com cards.get, explore cadeias com cards.dependency_graphe adicione ou remova blocks, blocked_by, ou relates_to links com cards.set_relations
Anexos	Leia o conteúdo de um anexo com cards.get_attachment (imagens como imagens, arquivos de texto como texto paginado); anexe um arquivo do próprio disco do agente com cards.create_upload_link, que retorna um URL único para o qual o agente faz upload com curl -T
Separadores de quadro	Crie separadores intitulados e opcionalmente coloridos; atualize sua aparência; mova-os em relação aos cartões, separadores ou bordas da lista; coloque os cartões em relação aos separadores; e exclua separadores sem alterar os cartões
Trabalho com cartão em massa	Preencher, datar, rotular, atribuir, mover, arquivar, copiar ou definir campos personalizados em cartões selecionados, com limites de lote no nível do quadro expostos em cada esquema
Atribuições e campos	Substitua responsáveis ou rótulos e defina ou limpe valores de campos personalizados compatíveis
Comentários	Paginar, adicionar com anexos opcionais, editar, excluir um comentário qualificado e adicionar ou remover reações de forma idempotente
Listas de verificação	Leia as listas de verificação de um cartão como uma árvore aninhada com IDs; crie uma lista de verificação junto com seus itens, responsáveis, datas de vencimento e um nível de sublistas de verificação em uma chamada atômica; adicione um ou mais itens na posição escolhida; atualizar um ou mais itens com alterações diferentes por item; definir um responsável ou data de vencimento para cada item; renomear, reordenar, mover e excluir. Os lotes são validados por completo antes de qualquer coisa ser escrita e os erros nomeiam o campo exato
Próximas prioridades	Descubra filas legíveis de pessoas e colegas de equipe, leia a ordem exata de classificação e adicione, mova ou remova cartões ativos atribuídos quando a credencial e a autoridade do espaço de trabalho permitirem
Execuções do agente	Anuncie o trabalho durante o voo em um cartão com runs.start, relate o progresso e os batimentos cardíacos com runs.update, feche a execução com um status de terminal e verifique o que já está sendo executado com runs.list
Trabalho e relatórios	Consulte cartões de equipe pessoais ou visíveis limitados com filtros vencidos, não atribuídos, inatividade e últimos movimentos; leia o dia inteiro do usuário conectado em uma chamada com work.my_day; inspecionar programações de cronograma e rollups entre quadros com work.portfolio_summary; e gerar evidências pessoais em fóruns acessíveis
Atividade e trabalho concluído	Atividade do painel de páginas e histórico do cartão, histórico de conclusão de leitura e registros de trabalhos realizados
Notas	Paginar metadados de notas, ler o conteúdo completo, criar, atualizar, vincular, anexar pequenos arquivos, copiar e reordenar notas pessoais ou de equipe
Bloco de rascunho	Capture itens "lembre-me de…" para sua conta privada Bloco de rascunho Caixa de entrada sem escolher um quadro, liste e leia páginas e marque itens. Precisa de login no navegador ou chave pessoal

Veja o inventário de ferramentas MCP gerado para cada nome de ferramenta registrado.

Relacionamentos de cartão

cards.get inclui o cartão relations e hiddenBlockerCount. cards.set_relations adiciona ou remove relacionamentos no mesmo espaço de trabalho:

{
  "cardId": "WEB-18",
  "direction": "blocked_by",
  "otherCardIds": ["MKT-42", "MKT-43"],
  "remove": false
}

direction é blocks, blocked_by, ou relates_to, leia de cardIddo lado. otherCardIds aceita uma referência de cartão ou até 50; remove o padrão é falso. As adições são idempotentes e confirmadas por destino. Um sucesso parcial retorna failed entradas e qualquer notAttemptedCardIds além dos relacionamentos resultantes. Se a leitura final falhar, addedCardIds e relationsUnavailable relatar o que foi salvo. A chamada apresenta erros quando cada tentativa de alteração é recusada. Remoção de commits por alvo também: removedCardIds preserva remoções bem-sucedidas ao lado de qualquer failed, notAttemptedCardIds, ou relationsUnavailable detalhes. notFoundCardIds nomeia relacionamentos que não consegue ver ou encontrar; esses são deixados sozinhos.

Uma credencial com capacidade de gravação precisa de acesso de edição para cardId e qualquer cartão que fique bloqueado e acesso de leitura aos outros cartões. Ciclos, autolinks, links entre espaços de trabalho e cartões concluídos à medida que novos bloqueadores são rejeitados. As leituras omitem detalhes do cartão inacessíveis, mas contam bloqueadores ativos ocultos. Usar filters: { blockedOnly: true } com work.query_cards para cartões abertos bloqueados, ou atRiskOnly: true para cartões abertos cujo bloqueador visível está vencido ou vencido depois deles; work.portfolio_summary relata ambas as contagens; assinar card.blocked e card.unblocked para transições. Esses eventos funcionam independentemente das automações configuradas.

A conclusão por meio do MCP não mostra um aviso interativo de trabalho bloqueado. Leia primeiro os relacionamentos ao decidir se o trabalho está pronto. Uma execução de agente bloqueada (runs.update com status: "blocked") descreve essa execução e não cria uma dependência de cartão. Veja Relacionamentos e bloqueios de cartões.

Gráficos de dependência

cards.dependency_graph responde o que bloqueia um cartão, o que ele retém e qual trabalho está conectado em um quadro ou espaço de trabalho. Passe exatamente um dos cardId (chave, UUID ou URL canônico), boardId, ou workspaceId:

{ "cardId": "MKT-42" }

A ferramenta retorna expandida cards, edgese truncated. Os cartões incluem chave, título, URL, nomes de quadro/lista de origem, inScopee datas disponíveis, rótulos e responsáveis. openBlockerCount inclui bloqueadores ativos que o chamador não pode ver; offMapBlockerCount conta bloqueadores ativos ausentes neste mapa. Somente valores opcionais presentes e diferentes de zero são incluídos. Um blocks borda corre de sourceCardId para targetCardId.

Um escopo de cartão também retorna focus: blockedBy e blocks são conexões diretas; upstream e downstream são IDs de cartão transitivos na primeira ordem mais próxima; relatedTo lista links contextuais. onMap: false significa que o cartão solicitado foi preenchido, arquivado, não relacionado ou ausente do gráfico. A ausência não é prova de que um cartão não tenha relacionamentos.

O gráfico segue links de bloqueio em ambos os sentidos por meio de cartões abertos legíveis. Os pré-requisitos concluídos podem aparecer, mas a passagem não continua através deles. As cartas ocultas são contadas sem serem nomeadas ou usadas como ponte para outro trabalho. Vizinhos relacionados são incluídos a um salto das sementes abertas do osciloscópio. A resposta para em 400 cartas e conjuntos truncated; restringir o escopo para obter mais detalhes. Esta é uma ferramenta de leitura. Usar cards.set_relations para editar links e eventos de dependência para monitorar mudanças.

Datas

Entradas de data aceitas YYYY-MM-DD ou frases do dia a dia, resolvidas em seu próprio fuso horário a partir do seu perfil Kanera: today, tomorrow 1pm, friday (na próxima sexta-feira, inclusive hoje), next friday (uma semana depois disso), in 2 weeks, next month, end of week, end of month, ou oct 12. session.get retorna seu timeZone e today para que um agente possa mostrar a data em que tudo funcionou. As datas de vencimento do Kanera usam intervalos de tempo em vez de horários exatos, portanto, um horário escolhe o horário correspondente: até 09:00 é Manhã, até às 13:00 Tarde, até às 17:00 Fim do dia de trabalho, e qualquer coisa posterior, o horário do dia inteiro. Uma frase que Kanera não consegue ler é recusada nas formas aceitas, em vez de adivinhada.

Ordem de resultados

A descrição de cada ferramenta de lista indica a ordem em que seus resultados aparecem, por exemplo, "mais recente primeiro" para comentários e atividades, ordem de exibição para listas e listas de verificação e o mais próximo a ser entregue primeiro para work.query_cards por padrão.

Cronogramas e datas de início

Usar work.schedule com exatamente um boardId ou workspaceId. Ele lê o mesmo mecanismo de jornada de trabalho que o Visualização da linha do tempo, segue cadeias conectadas acessíveis em todos os tabuleiros e exclui cartões concluídos e inacessíveis. Os filtros de exibição não alteram o cálculo.

Resultado	Significado
cards[].plannedStart, plannedEnd, durationDays	O intervalo de datas planejado e sua duração inclusiva de segunda a sexta-feira.
earliestStart, earliestFinish, latestStart, latestFinish	Datas restritas por dependência e as datas mais recentes que preservam o final da cadeia.
slackDays, critical	Espaço para escorregar nos dias úteis e se o trabalho conectado não tem folga. Folga nula significa que o cálculo não tem âncora de data.
conflicts[]	Bloqueadores abertos conflitantes, com blockerId, edgeId, kind, e jornada de trabalho days.
criticalEdgeIds	Relacionamentos no caminho crítico do agendamento.
summary	Contagens programadas/não programadas, conflitos e críticas, intervalo de datas, projectedFinish, latestDue, e jornada de trabalho slipDays contra a última data de vencimento.

Passe startDateLocalDate para cards.create, cards.update dentro changes, ou cada entrada de cards.bulk_create. Usar YYYY-MM-DD ou uma frase de data relativa suportada resolvida na zona do usuário; null limpa um início existente. Um início não tem intervalo de tempo e não pode ser tardio. Essas gravações exigem acesso de edição e não movem automaticamente as datas dos sucessores.

Não há nenhuma entrada hipotética de cronograma: proponha uma alteração do cronograma atual e, em seguida, aplique-a e releia-a somente quando for pretendida uma alteração salva. Veja exemplos de planejamento trabalhados e agendar cargas úteis de eventos. Recursos de planejamento desativados retornam TIMELINE_DISABLED ou DEPENDENCIES_DISABLED para operações que os exijam.

Assinaturas de eventos

Um cliente no protocolo MCP atual pode assinar card.created, card.updated, card.movede comment.created em uma área de trabalho, quadro ou cartão, para priorities.changed para a próxima fila do usuário conectado e para my_day.ready para um ping de briefing nos dias úteis da manhã e receba cada ocorrência em um retorno de chamada HTTPS verificado que ele controla. As assinaturas pertencem à conexão, duram até 24 horas por atualização e são verificadas novamente em relação ao acesso atual da identidade antes de cada entrega. Veja Inscreva-se em eventos para catálogo, verificação, assinatura, novas tentativas e códigos de erro.

Prompts integrados

Alerta	Usar
summarize_board_status	Inspecione um quadro e resuma o progresso, os bloqueadores, o trabalho obsoleto e as próximas ações.
prepare_standup_update	Combine o trabalho pessoal atual e o histórico de trabalho paginado em quadros acessíveis para elaborar um stand-up.
draft_card_from_notes	Leia uma nota e esboce o título do cartão e a descrição do Markdown sem criar o cartão.

Os prompts de conversa normais funcionam mesmo quando um cliente de IA não expõe os modelos de prompt do MCP.

Segurança e operações destrutivas

• OAuth interativo e de código de dispositivo sempre concede kanera:read e kanera:write; offline_access permanece opcional. O cliente MCP controla a disponibilidade e as aprovações das ferramentas, e Kanera impõe funções no quadro. As ferramentas administrativas funcionam apenas onde o usuário possui a função de administrador correspondente: os administradores da organização podem criar espaços de trabalho e quadros independentes, e os administradores de espaços de trabalho podem adicionar quadros e gerenciar automações.
• Cada fluxo OAuth vincula sua autorização, código, família de atualização e token de acesso ao MCP canônico resource.
• Cru kanera_mcp_... tokens de acesso são aceitos apenas pelo endpoint MCP e são rejeitados por /api/v1; o serviço MCP usa uma credencial de delegação interna separada com duração de um minuto para chamadas de API públicas.
• A autorização do dispositivo usa os mesmos escopos e os mesmos limites. O código do dispositivo expira após dez minutos, pode ser trocado uma vez e só é aprovado por um usuário conectado que confirma o código mostrado pelo cliente.
• Agentes autônomos e chaves de espaço de trabalho são limitados ao escopo configurado.
• As chaves pessoais herdam as permissões atuais de seu proprietário e devem ser protegidas como a conta do usuário.
• As chaves de API com escopo de leitura e as credenciais de serviço autônomas não podem chamar mutações protegidas.
• A atividade da chave de API e do MCP é registrada com seu usuário atuante ou identidade de integração. Um agente OAuth interativo é registrado como o agente agindo para seu usuário: comentários e linhas de atividades carregam o nome do agente e são renderizados como via <agent>, e o usuário é notificado sobre o que seu agente fez, em vez de suprimi-lo como sua própria ação. Uma chave de API pessoal usada por um script ainda atua como seu proprietário.
• Desconectar o OAuth ou excluir um agente autônomo revoga suas credenciais ativas.
• Use uma credencial separada por cliente para que uma conexão possa ser revogada sem afetar outra.

Kanera MCP não pode excluir:

• Quadros
• Listas
• Rótulos ou campos personalizados
• Notas
• Anotar anexos

Exclua-os manualmente no Kanera. O MCP pode arquivar ou desarquivar cartões e arquivar os cartões ativos em uma lista.

A administração pelo MCP limita-se à criação de espaços de trabalho e quadros independentes (administradores da organização, usando uma concessão OAuth interativa ou uma chave pessoal com capacidade de gravação), adição de quadros a um espaço de trabalho e criação, edição, ativação e exclusão de automações (administradores de espaço de trabalho). O MCP não pode editar, reordenar ou excluir espaços de trabalho, quadros, listas, rótulos, campos, opções, membros ou configurações de retenção. Essas operações permanecem na interface Kanera; endpoints REST suportados permanecem disponíveis para integrações criadas deliberadamente.

O MCP pode excluir permanentemente:

• Um comentário de autoria do usuário atuante
• Uma lista de verificação e seus itens
• Um item da lista de verificação

Esses esquemas de ferramentas são marcados como destrutivos. Use-os somente após uma solicitação explícita e verifique o alvo antes de chamá-los.

Solução de problemas

Problema	O que verificar
O cliente não consegue se conectar	Use o exato /mcp URL do Kanera ao qual você está se conectando, conforme mostrado em Configurações de perfil -> Chaves de API.
O cliente pede um token em vez de abrir o Kanera	Ele não oferece suporte ao MCP OAuth remoto. Use uma chave de API ou um cliente compatível.
O cliente não tem navegador para redirecionar	Usar autorização do dispositivo se o cliente suportar, ou uma chave de API, se não.
A votação continua retornando slow_down	A pesquisa não é mais rápida que a interval retornado com o código do dispositivo e adote o intervalo mais longo após cada slow_down.
A página do dispositivo informa um código inválido ou expirado	Os códigos duram dez minutos e funcionam uma vez. Verifique o código, faça login primeiro e solicite um novo código ao cliente.
O ponto final do token retorna invalid_target	Envie o endereço MCP exato de Configurações de perfil -> Chaves de API como resource durante a autorização e cada troca de token.
A chave de API está ausente	Definir KANERA_API_KEY para stdio ou enviar Authorization: Bearer ... por HTTP.
Uma solicitação retorna 401	A credencial está ausente, malformada, expirou, revogada ou foi copiada incorretamente. Reinicie o OAuth ou substitua a chave API.
Uma solicitação retorna 403	Para OAuth pessoal, confirme se o usuário atuante é um Editor e não um Observador no quadro de destino. Para uma chave de API ou agente autônomo, confirme também se a credencial é compatível com gravação.
O agente pode ler, mas não editar	Permita a ação de gravação no cliente MCP e confirme se a identidade atuante tem acesso de Editor do quadro. Para conexões de serviço e chaves de API, use também uma credencial com capacidade de gravação. As conexões OAuth pessoais existentes não precisam ser reconectadas.
O agente não consegue encontrar um tabuleiro	Use a descoberta completa do quadro. Um quadro pode ser independente ou estar disponível apenas por meio de associação explícita de convidados.
O agente não pode administrar um espaço de trabalho	O MCP abrange apenas a criação de espaços de trabalho e quadros e o gerenciamento de automações, e somente quando a identidade atuante for um administrador; Credenciais com escopo de espaço de trabalho e somente leitura não podem criar espaços de trabalho. Para outra administração, use a interface Kanera ou um terminal REST público compatível.
Um agente de codificação possui ferramentas, mas as utiliza mal	Instale o oficial Habilidade do Agente Kanera.
Ferramentas novas ou alteradas não aparecem	Atualize ou verifique novamente o servidor MCP no cliente para que ele recupere os esquemas atuais. Reinicie o cliente se ele não tiver nenhuma ação de atualização; A reautorização do OAuth normalmente não é necessária.
O cliente não pode assinar eventos	Eventos precisam de hospedagem /mcp endpoint e um cliente no protocolo MCP atual; um estúdio kanera mcp o servidor nunca os oferece. Veja Inscreva-se em eventos para erros de retorno de chamada e escopo.

Páginas relacionadas

• Kanera CLI

• Conecte Kanera ao seu agente de IA

• Conecte-se ao OAuth ou a um agente autônomo

• Exemplos de como usar Kanera com IA

• Inscreva-se em eventos

• Inventário de ferramentas MCP

• API pública