Referencia técnica del MCP

Utilice esta página cuando necesite detalles de transporte, credenciales estáticas, límites de capacidad o solución de problemas de protocolo. Para la configuración personal más corta, comience con Conecte Kanera con su agente de IA.

Métodos de conexión

Conexión	Autenticación	Acceso efectivo
OAuth interactivo	Inicio de sesión y consentimiento del navegador	Actúa como usuario conectado con capacidad de herramienta de lectura y escritura. El cliente controla la disponibilidad y aprobación de las acciones; Kanera impone el rol del usuario en el tablero. Nunca recibe acceso de administración del espacio de trabajo.
Autorización del dispositivo	Un código de usuario corto aprobado en un navegador en cualquier dispositivo	Actúa como usuario aprobador, exactamente igual que OAuth interactivo. Nunca recibe acceso de administración del espacio de trabajo.
Agente desatendido	OAuth client_credentials	Utiliza una identidad de servicio de espacio de trabajo limitada al máximo de lectura, escritura o administración elegido por un administrador. Actualmente, el administrador no agrega herramientas al servidor MCP predeterminado; utilice una clave API de tablero o espacio de trabajo independiente para la administración REST directa.
Clave API personal	Token de portador estático	Actúa como su propietario en todos los foros accesibles. El MCP predeterminado sigue centrado en el trabajo; Las solicitudes REST directas heredan por separado los permisos admitidos por el propietario.
Clave API del espacio de trabajo o del tablero	Token de portador estático	Permanece anclado a su espacio de trabajo estándar o tablero independiente y su ámbito de lectura, escritura o administración. El administrador no agrega herramientas de configuración al MCP predeterminado.

Ver Conecte un agente de IA para OAuth interactivo, consentimiento, revocación, agentes desatendidos y flujo de autorización.

Puntos finales alojados

El punto final MCP alojado de Kanera es:

https://mcp.kanera.app/mcp

La verificación del estado del servicio es:

https://mcp.kanera.app/health

Los clientes compatibles con OAuth pueden agregar el punto final MCP directamente y completar la autenticación en el navegador. Un cliente que utiliza una clave API la envía como token al portador:

Authorization: Bearer kanera_live_...

Si su equipo ejecuta Kanera en su propia dirección, lo mismo /mcp y /health Los caminos se aplican allí. Copie la dirección MCP exacta que se muestra en Configuración de perfil -> Claves API en esa Kanera.

Versiones de protocolo

El punto final alojado sirve tanto al protocolo MCP actual como a las revisiones anteriores que Claude, Codex, Cursor, Copilot, Gemini CLI y OpenCode utilizan hoy en día, desde el mismo servidor. Los clientes mayores ven las mismas herramientas, recursos e indicaciones que antes; Los clientes con el protocolo actual también obtienen suscripciones a eventos. Los esquemas de herramientas se publican en el mismo dialecto de esquema JSON para ambos, por lo que ningún cliente ve un contrato diferente. kanera mcp over stdio también acepta ambos.

Seguridad del token OAuth

Los clientes compatibles con OAuth manejan los detalles de seguridad automáticamente. El token emitido para una conexión Kanera funciona sólo con la dirección MCP mostrada por Kanera; no se puede reutilizar como credencial API pública general.

Si está creando un cliente OAuth personalizado, envíe esa dirección MCP exacta como resource durante la autorización y cada intercambio de tokens. Los siguientes ejemplos de autorización de dispositivos muestran a dónde pertenece. Utilice una clave API personal, de espacio de trabajo o de tablero para una integración que llame directamente a la API REST.

Autorización de dispositivo para CLI y clientes sin cabeza

Un cliente que no puede recibir una redirección del navegador, como una herramienta de terminal, una sesión SSH o una máquina sin un navegador utilizable, puede conectarse con la concesión de autorización de dispositivo OAuth (RFC 8628). El cliente muestra un código corto, una persona lo aprueba en un navegador en cualquier dispositivo y el cliente sondea hasta recibir tokens.

El resultado es la misma identidad que OAuth interactivo. La conexión actúa como el usuario que aprueba con la capacidad de la herramienta de lectura y escritura, mientras que Kanera continúa imponiendo el rol de ese usuario en cada tablero. Nunca recibe acceso de administración del espacio de trabajo. Para aprobar una solicitud de dispositivo se necesita un plan que permita conexiones de agentes, el mismo requisito que cualquier otra conexión de agente.

Kanera anuncia el flujo en /.well-known/oauth-authorization-server:

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

Registrar un cliente de dispositivo

Registra al cliente en /oauth/register con el tipo de concesión del dispositivo. Un cliente de solo dispositivo no necesita un URI de redireccionamiento; redirect_uris se requiere solo cuando el cliente también 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 rechaza el flujo de dispositivos para cualquier cliente que no esté registrado con el tipo de concesión de dispositivo.

Solicitar un 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 es obligatorio y debe coincidir con la dirección MCP. Kanera normaliza cada solicitud de dispositivo autorizado por el usuario para kanera:read kanera:write, incluidos los clientes que omiten scope o solicitar sólo Leer. Kanera emite un token de actualización cuando el cliente registró el refresh_token tipo de subvención; offline_access Se acepta pero no es obligatorio. Sólo kanera:read, kanera:write, y offline_access son aceptados.

Campo de respuesta	Significado
device_code	El secreto que el cliente envía al realizar la encuesta.
user_code	El código corto que escribe la persona, formateado como ABCD-2345.
verification_uri	el /oauth/device página en su dirección web de Kanera.
verification_uri_complete	La misma página con el código precargado en la cadena de consulta.
expires_in	600. La solicitud caduca diez minutos después de su emisión.
interval	5. El número mínimo de segundos entre encuestas.

Aprobar la solicitud

1. El cliente muestra el user_code y el verification_uri, o abre verification_uri_complete directamente.
2. La persona abre esa dirección e inicia sesión en Kanera si aún no lo ha hecho.
3. La página nombra al cliente, muestra el código para que pueda compararse con el terminal y enumera lo que el cliente podrá hacer.
4. Eligiendo Permitir acceso aprueba la conexión. Eligiendo Negar lo rechaza.

Encuesta 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

Encuesta no más rápido que interval. Hasta que se complete la solicitud, el punto final del token regresa 400 con un error estándar de OAuth:

error	Significado	Qué debe hacer el cliente
authorization_pending	Nadie ha aprobado ni rechazado la solicitud todavía.	Siga sondeando en el intervalo actual.
slow_down	El cliente encuestó más rápido que el intervalo.	Kanera añade cinco segundos al intervalo. Utilice el intervalo más largo a partir de ahora.
access_denied	La persona negó la solicitud.	Deje de sondear y comience una nueva solicitud.
expired_token	El código expiró o sus tokens ya fueron emitidos.	Iniciar una nueva solicitud.
invalid_grant	El código del dispositivo es desconocido o pertenece a otro cliente.	Iniciar una nueva solicitud.

Después de la aprobación, el punto final devuelve la misma carga útil que cualquier otra concesión: un destino vinculado a la audiencia. kanera_mcp_... token de acceso válido por quince minutos, más un token de actualización cuando el cliente registró el refresh_token tipo de subvención. Un código de dispositivo es de un solo uso, por lo que un intercambio repetido regresa expired_token. Las solicitudes de actualización deben incluir lo mismo resource.

Administrar o revocar una conexión de dispositivo donde se administran todas las demás conexiones de agente, en Configuración de perfil -> Claves API.

Crear una clave API

Utilice claves API para stdio local, clientes que solo aceptan tokens de portador estáticos o integraciones personalizadas del lado del servidor.

Clave API personal

1. Abierto Configuración de perfil.
2. Ir a Claves API.
3. Cree una clave API personal.
4. Elige Sólo lectura o leer y escribir. El modo de solo lectura es el valor predeterminado correcto para un agente desatendido: Kanera rechaza todas las mutaciones en la API, por lo que los permisos de la herramienta del cliente no son lo único que se interpone entre un agente y su trabajo. A un cliente conectado con una clave de solo lectura solo se le ofrecen las herramientas de lectura, por lo que nunca planifica un cambio que no pueda realizar.
5. Agregue una etiqueta privada opcional que identifique al cliente.
6. Copie el secreto cuando se muestre.

Una clave personal tiene un prefijo como kanera_u_live_.... Se muestra una vez y actúa como su propietario, limitado por el alcance que elijas. Guárdelo únicamente en el almacén de credenciales del cliente de IA o en el administrador secreto de su servidor.

Clave API del espacio de trabajo o del tablero

1. Abra el espacio de trabajo estándar o el tablero independiente.
2. Ir a Configuración -> API.
3. Cree una clave API.
4. Elija el alcance más pequeño que se ajuste al flujo de trabajo.
5. Copie el secreto cuando se muestre.

Alcance	Subvenciones
leer	Inspeccione, busque, resuma e informe sin cambiar Kanera.
escribir	Cree y actualice el contenido del tablero, incluidas tarjetas, listas de verificación, comentarios, tareas, etiquetas, valores de campos personalizados y notas.
Administrador	Realice la administración de API pública directa compatible. El servidor MCP predeterminado permanece centrado en el trabajo y no expone herramientas de administración de espacios de trabajo, tableros, listas, etiquetas, campos, opciones, retención o pedidos.

Conecte un cliente stdio local

El servidor stdio local más simple es el Kanera CLI. Instálelo, inicie sesión una vez y apunte al cliente a kanera mcp; sirve la misma capa de herramientas sobre stdio usando la credencial almacenada, por lo que no hay una segunda clave para configurar en un segundo lugar.

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

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

uso npx @kanera/cli mcp en lugar de una instalación global cuando preferirías no instalar nada, y agregar "args": ["mcp", "--profile", "agent"] para elegir un perfil con nombre.

Para proporcionar la credencial a través del entorno en lugar de un perfil almacenado (la opción habitual en CI o un agente de espacio aislado), tanto la CLI como el paquete MCP independiente dicen:

variable de entorno	Propósito
KANERA_API_KEY	Una clave API personal, de espacio de trabajo o de tablero.
KANERA_PUBLIC_API_URL	El origen de la API pública de 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"
      }
    }
  }
}

Utilice el punto final HTTP alojado cuando no necesite ejecutar el proceso MCP localmente.

Recursos

Kanera proporciona cuatro plantillas de recursos JSON estructuradas:

Recurso	URI	Contiene
Espacio de trabajo estándar	kanera://workspace/{workspaceId}	Configuración del espacio de trabajo delimitado y listas compartidas, etiquetas, campos, plantillas, automatizaciones y membresías visibles para la credencial
Tablero	kanera://board/{boardId}	Metadatos delimitados y configuración visible para un espacio de trabajo estándar o un tablero independiente, sin tarjetas
Tarjeta	kanera://card/{cardId}	Detalles de la tarjeta, incluidas etiquetas, asignados, listas de verificación, archivos adjuntos y notas vinculadas
Nota	kanera://note/{noteId}	Una nota personal o de equipo visible

Las notas personales son privadas para el usuario conectado. No dé a entender que otro miembro del espacio de trabajo o una credencial de servicio del espacio de trabajo pueda leerlos.

Referencias de tarjetas

Campos de tarjeta MCP nombrados cardId o cardIds aceptar cualquiera de estas referencias:

• Una clave de tarjeta humana como PROJ-123, incluida una clave exacta que utiliza un prefijo de espacio de trabajo anterior.
• Una URL canónica de tarjeta Kanera.
• El UUID de la tarjeta devuelto por la API pública.

Utilice la clave humana en indicaciones y respuestas de cara al usuario. Kanera lo resuelve en el UUID antes de llamar a la operación API pública existente, por lo que la autorización, la actividad y el comportamiento de auditoría siguen siendo los mismos. Una clave resuelta se recuerda para la conexión durante unos minutos, por lo que repetirla en una tarea de varios pasos no repite la búsqueda. Si el usuario conectado puede ver la misma clave en más de una organización, utilice la URL de la tarjeta canónica para identificar la organización deseada sin ambigüedades.

Los resultados de la tarjeta incluyen la clave actual legible por humanos. el kanera://card/{cardId} el URI del recurso continúa usando el UUID; Las claves humanas y los enlaces se aplican a las entradas de la herramienta MCP.

Grupos de capacidad

Los esquemas de herramientas en vivo son la autoridad para nombres, entradas, anotaciones de seguridad y límites. El servidor cubre actualmente:

Área	Operaciones disponibles
Descubrimiento	Inspeccionar la sesión de actuación, localizar espacios de trabajo estándar y tableros accesibles, leer el espacio de trabajo delimitado o la configuración del tablero, y localizar tableros y miembros.
Límite de configuración	Lea listas, etiquetas, campos, opciones, miembros y permisos necesarios para orientar el trabajo. Crear, editar, reordenar, retener y otras operaciones de administración de listas/espacios de trabajo permanecen en la interfaz de Kanera y no son herramientas MCP.
Buscar	Busque tarjetas activas, notas, comentarios y nombres de archivos adjuntos, o busque la documentación oficial de Kanera
Tarjetas	Lea resúmenes o contenido completo, obtenga lista de verificación delimitada/contenido de comentarios para hasta 200 tarjetas seleccionadas, cree, actualice, mueva, reordene, copie, mueva entre tableros compatibles, archive, desarchive, complete, vuelva a abrir y administre archivos adjuntos y portadas.
Relaciones de tarjetas	Leer enlaces individuales con cards.get, explorar cadenas con cards.dependency_graphy agregar o eliminar blocks, blocked_by, o relates_to enlaces con cards.set_relations
Adjuntos	Leer el contenido de un archivo adjunto con cards.get_attachment (imágenes como imágenes, archivos de texto como texto paginado); adjuntar un archivo del propio disco del agente con cards.create_upload_link, que devuelve una URL única a la que el agente carga curl -T
Separadores de tableros	Cree separadores titulados, opcionalmente coloreados; actualizar su apariencia; moverlos en relación con tarjetas, separadores o bordes de listas; colocar tarjetas en relación con los separadores; y eliminar separadores sin cambiar tarjetas
trabajo con tarjeta a granel	Complete, feche, etiquete, asigne, mueva, archive, copie o establezca campos personalizados en tarjetas seleccionadas, con límites de lotes a nivel de tablero expuestos en cada esquema
Asignaciones y campos	Reemplazar asignados o etiquetas y establecer o borrar valores de campos personalizados admitidos
Comentarios	Página, agregar con archivos adjuntos opcionales, editar, eliminar un comentario elegible y agregar o eliminar reacciones de manera idempotente
Listas de verificación	Lea las listas de verificación de una tarjeta como un árbol anidado con identificaciones; cree una lista de verificación junto con sus elementos, asignatarios, fechas de vencimiento y un nivel de sublistas de verificación en una llamada atómica; agregar uno o más elementos en una posición elegida; actualizar uno o más artículos con diferentes cambios por artículo; establecer un cesionario o fecha de vencimiento para cada artículo; cambiar el nombre, reordenar, mover y eliminar. Los lotes se validan en su totalidad antes de escribir algo y los errores nombran el campo exacto
Hasta las próximas prioridades	Descubra colas personales y de compañeros de equipo legibles, lea el orden de clasificación exacto y agregue, mueva o elimine tarjetas activas asignadas cuando la autoridad de credenciales y espacio de trabajo lo permita.
El agente se ejecuta	Anuncie el trabajo a bordo en una tarjeta con runs.start, informar el progreso y los latidos del corazón con runs.update, cierre la ejecución con un estado de terminal y verifique lo que ya se está ejecutando con runs.list
Trabajo y presentación de informes.	Consultar tarjetas de equipo personales o visibles delimitadas con filtros vencidos, no asignados, inactividad y último movimiento; leer todo el día del usuario conectado en una sola llamada con work.my_day; inspeccionar cronogramas de cronograma y resúmenes cruzados con work.portfolio_summary; y generar evidencia personal en foros accesibles
Actividad y trabajo completado.	Página de actividad del tablero e historial de tarjetas, y lectura del historial de finalización y registros de trabajo realizado
Notas	Metadatos de notas de página, lea contenido completo, cree, actualice, vincule, adjunte archivos pequeños, copie y reordene notas personales o de equipo
Bloc de notas	Captura elementos "recuérdame..." en tu cuenta privada Bloc de notas Bandeja de entrada sin elegir un tablero, enumerar y leer páginas, y marcar elementos. Necesita un inicio de sesión en el navegador o una clave personal

Ver el inventario de herramientas MCP generado para cada nombre de herramienta registrado.

Relaciones de tarjetas

cards.get incluye la tarjeta relations y hiddenBlockerCount. cards.set_relations agrega o elimina relaciones en el mismo espacio de trabajo:

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

direction es blocks, blocked_by, o relates_to, leer de cardIddel lado. otherCardIds acepta una referencia de tarjeta o hasta 50; remove El valor predeterminado es falso. Las adiciones son idempotentes y se comprometen por objetivo. Vuelve un éxito parcial failed entradas y cualquier notAttemptedCardIds además de las relaciones resultantes. Si la lectura final falla, addedCardIds y relationsUnavailable reportar lo que se salvó. La llamada falla cuando se rechaza cada intento de cambio. Confirmaciones de eliminación por objetivo también: removedCardIds conserva las eliminaciones exitosas junto a cualquier failed, notAttemptedCardIds, o relationsUnavailable detalles. notFoundCardIds nombra relaciones que no puede ver ni encontrar; esos se quedan solos.

Una credencial con capacidad de escritura necesita acceso de edición cardId y cualquier tarjeta que se bloquee, y acceso de lectura a las otras tarjetas. Se rechazan los ciclos, los autoenlaces, los enlaces entre espacios de trabajo y las tarjetas completadas como nuevos bloqueadores. Las lecturas omiten los detalles de la tarjeta inaccesibles pero cuentan los bloqueadores activos ocultos. uso filters: { blockedOnly: true } con work.query_cards para tarjetas abiertas bloqueadas, o atRiskOnly: true para tarjetas abiertas cuyo bloqueador visible esté vencido o vencido después de ellas; work.portfolio_summary informa ambos cargos; suscríbete a card.blocked y card.unblocked para transiciones. Estos eventos funcionan independientemente de las automatizaciones configuradas.

Completar a través de MCP no muestra una advertencia interactiva de trabajo bloqueado. Lea primero las relaciones cuando decida si el trabajo está listo. Una ejecución de agente bloqueada (runs.update con status: "blocked") describe esa ejecución y no crea una dependencia de tarjeta. Ver Relaciones de tarjetas y bloqueo.

Gráficos de dependencia

cards.dependency_graph responde qué bloquea una tarjeta, qué sostiene y qué trabajo está conectado a través de un tablero o espacio de trabajo. Pase exactamente uno de cardId (clave, UUID o URL canónica), boardId, o workspaceId:

{ "cardId": "MKT-42" }

La herramienta vuelve ampliada cards, edges, y truncated. Las tarjetas incluyen su clave, título, URL, nombres del tablero/lista de origen, inScopey fechas disponibles, etiquetas y asignados. openBlockerCount incluye bloqueadores activos que la persona que llama no puede ver; offMapBlockerCount cuenta los bloqueadores activos ausentes de este mapa. Sólo se incluyen valores opcionales presentes distintos de cero. un blocks El borde va desde sourceCardId a targetCardId.

También regresa un alcance de tarjeta focus: blockedBy y blocks son conexiones directas; upstream y downstream son identificaciones de tarjetas transitivas en primer orden más cercano; relatedTo enumera enlaces contextuales. onMap: false significa que la tarjeta solicitada fue completada, archivada, no relacionada o ausente del gráfico. La ausencia no es prueba de que una tarjeta no tenga relaciones.

El gráfico sigue el bloqueo de enlaces en ambos sentidos a través de tarjetas abiertas legibles. Pueden aparecer requisitos previos completados, pero el recorrido no continúa a través de ellos. Las cartas ocultas se cuentan sin nombrarlas ni utilizarlas como puente hacia otros trabajos. Los vecinos relacionados se incluyen a un salto de las semillas abiertas del alcance. La respuesta se detiene en 400 cartas y conjuntos. truncated; reduzca el alcance para obtener más detalles. Esta es una herramienta de lectura. uso cards.set_relations para editar enlaces y eventos de dependencia para monitorear los cambios.

Fechas

Se aceptan entradas de fecha YYYY-MM-DD o frases cotidianas, resueltas en tu propio huso horario desde tu perfil de Kanera: today, tomorrow 1pm, friday (el próximo viernes, hoy incluido), next friday (una semana después de eso), in 2 weeks, next month, end of week, end of month, o oct 12. session.get te devuelve tu timeZone y today para que un agente pueda mostrarte la fecha en que funcionó. Las fechas de vencimiento de Kanera utilizan franjas horarias en lugar de horas exactas, por lo que una hora elige la franja horaria coincidente: hasta las 09:00 es mañana, hasta las 13:00 tarde, hasta las 17:00 Fin de la jornada laboral, y cualquier cosa posterior, el horario de todo el día. Una frase que Kanera no puede leer se rechaza con las formas aceptadas en lugar de adivinarse.

Orden de resultados

La descripción de cada herramienta de lista indica el orden en que aparecen los resultados, por ejemplo, "los más recientes primero" para comentarios y actividades, orden de visualización para listas y listas de verificación, y lo más pronto posible primero para work.query_cards por defecto.

Cronogramas y fechas de inicio

uso work.schedule con exactamente uno boardId o workspaceId. Lee el mismo motor de día laborable que el Vista de línea de tiempo, sigue cadenas conectadas accesibles en todos los ámbitos y excluye tarjetas completas e inaccesibles. Los filtros de visualización no cambian el cálculo.

Resultado	Significado
cards[].plannedStart, plannedEnd, durationDays	El intervalo de fechas planificado y su duración inclusiva de lunes a viernes.
earliestStart, earliestFinish, latestStart, latestFinish	Fechas restringidas por dependencia y las últimas fechas que preservan el fin de la cadena.
slackDays, critical	Hay margen para disminuir las jornadas laborales y si el trabajo conectado no tiene holgura. La holgura nula significa que el cálculo no tiene un anclaje de fecha.
conflicts[]	Bloqueadores abiertos en conflicto, con blockerId, edgeId, kind, y jornada laboral days.
criticalEdgeIds	Relaciones en la ruta crítica de programación.
summary	Programado/no programado, recuentos críticos y de conflictos, rango de fechas, projectedFinish, latestDue, y jornada laboral slipDays contra la última fecha de vencimiento.

Pase startDateLocalDate a cards.create, cards.update dentro changes, o cada entrada de cards.bulk_create. uso YYYY-MM-DD o una frase de fecha relativa compatible resuelta en la zona del usuario; null borra un inicio existente. Una salida no tiene franja horaria y no puede realizarse fuera de plazo. Estas escrituras requieren acceso de edición y no mueven automáticamente las fechas sucesoras.

No hay entradas de programación hipotéticas: proponga un cambio a partir de la programación actual, luego aplíquelo y vuelva a leerlo solo cuando se desee guardar un cambio. Ver ejemplos de planificación trabajados y programar cargas útiles de eventos. Vuelven las funciones de planificación deshabilitadas TIMELINE_DISABLED o DEPENDENCIES_DISABLED para operaciones que los requieran.

Suscripciones a eventos

Un cliente en el protocolo MCP actual puede suscribirse a card.created, card.updated, card.moved, y comment.created en un espacio de trabajo, tablero o tarjeta, para priorities.changed para la cola Siguiente del usuario conectado y para my_day.ready para un ping informativo por la mañana entre semana y reciba cada ocurrencia en una devolución de llamada HTTPS verificada que controle. Las suscripciones pertenecen a la conexión, duran hasta 24 horas por actualización y se vuelven a verificar con el acceso actual de la identidad antes de cada entrega. Ver Suscríbete a eventos para el catálogo, verificación, firma, reintentos y códigos de error.

Avisos incorporados

rápido	uso
summarize_board_status	Inspeccione un tablero y resuma el progreso, los obstáculos, el trabajo obsoleto y las próximas acciones.
prepare_standup_update	Combine el trabajo personal actual y el historial laboral paginado en tableros accesibles para redactar un standup.
draft_card_from_notes	Lea una nota y redacte el título de una tarjeta y una descripción de Markdown sin crear la tarjeta.

Los mensajes de conversación normales funcionan incluso cuando un cliente de IA no expone las plantillas de mensajes de MCP.

Seguridad y operaciones destructivas.

• OAuth interactivo y de código de dispositivo siempre otorga kanera:read y kanera:write; offline_access sigue siendo opcional. El cliente MCP controla la disponibilidad y las aprobaciones de las herramientas, y Kanera hace cumplir las funciones de el tablero. Las herramientas de administración funcionan solo cuando el usuario tiene la función de administrador correspondiente: los administradores de la organización pueden crear espacios de trabajo y tableros independientes, y los administradores del espacio de trabajo pueden agregar tableros y administrar automatizaciones.
• Cada flujo de OAuth vincula su autorización, código, familia de actualización y token de acceso al MCP canónico. resource.
• crudo kanera_mcp_... Los tokens de acceso son aceptados solo por el punto final MCP y son rechazados por /api/v1; El servicio MCP utiliza una credencial de delegación interna de duración de minutos separada para llamadas API públicas.
• La autorización del dispositivo utiliza los mismos alcances y los mismos límites. Un código de dispositivo caduca después de diez minutos, se puede intercambiar una vez y solo lo aprueba un usuario que haya iniciado sesión y confirme el código mostrado por el cliente.
• Los agentes desatendidos y las claves del espacio de trabajo tienen un límite en su alcance configurado.
• Las claves personales heredan los permisos actuales de su propietario y deben protegerse como la cuenta del usuario.
• Las claves de API con alcance de lectura y las credenciales de servicio desatendidas no pueden llamar a mutaciones protegidas.
• La actividad de la clave API y MCP se registra con su usuario activo o identidad de integración. Un agente OAuth interactivo se registra como el agente que actúa en nombre de su usuario: los comentarios y las filas de actividad llevan el nombre del agente y se representan como via <agent>, y se notifica al usuario sobre lo que hizo su agente en lugar de suprimirlo como su propia acción. Una clave API personal utilizada por un script sigue actuando como su propietario.
• Desconectar OAuth o eliminar un agente desatendido revoca sus credenciales activas.
• Utilice una credencial separada por cliente para que una conexión pueda revocarse sin afectar a otra.

Kanera MCP no puede eliminar:

• Tableros
• Listas
• Etiquetas o campos personalizados
• Notas
• Notas adjuntas

Elimínelos manualmente en Kanera. MCP puede archivar o desarchivar tarjetas y puede archivar las tarjetas activas en una lista.

La administración sobre MCP se limita a crear espacios de trabajo y tableros independientes (administradores de la organización, utilizando una concesión OAuth interactiva o una clave personal con capacidad de escritura), agregar tableros a un espacio de trabajo y crear, editar, habilitar y eliminar automatizaciones (administradores del espacio de trabajo). MCP no puede editar, reordenar ni eliminar espacios de trabajo, tableros, listas, etiquetas, campos, opciones, miembros o configuraciones de retención. Esas operaciones permanecen en la interfaz de Kanera; Los puntos finales REST compatibles siguen estando disponibles para integraciones creadas deliberadamente.

MCP puede eliminar permanentemente:

• Un comentario escrito por el usuario activo.
• Una lista de verificación y sus elementos.
• Un elemento de la lista de verificación

Esos esquemas de herramientas están marcados como destructivos. Úselos sólo después de una solicitud explícita y verifique el objetivo antes de llamarlos.

Solución de problemas

problema	Que comprobar
El cliente no puede conectarse	Usa el exacto /mcp URL de la Kanera a la que se está conectando, como se muestra a continuación Configuración de perfil -> Claves API.
El cliente pide una ficha en lugar de abrir Kanera	No es compatible con MCP OAuth remoto. Utilice una clave API o un cliente compatible.
El cliente no tiene un navegador al que redirigir	uso autorización del dispositivo si el cliente lo admite, o una clave API si no lo admite.
Las encuestas siguen regresando slow_down	Encuesta no más rápido que el interval devuelto con el código del dispositivo y adopte el intervalo más largo después de cada slow_down.
La página del dispositivo informa un código no válido o caducado	Los códigos duran diez minutos y funcionan una vez. Verifique el código, inicie sesión primero y luego solicite un nuevo código al cliente.
El punto final del token regresa invalid_target	Envíe la dirección MCP exacta desde Configuración de perfil -> Claves API como resource durante la autorización y cada intercambio de tokens.
Se informa que falta la clave API	conjunto KANERA_API_KEY para stdio o enviar Authorization: Bearer ... a través de HTTP.
Una solicitud regresa 401	La credencial falta, está mal formada, ha caducado, está revocada o se ha copiado incorrectamente. Reinicie OAuth o reemplace la clave API.
Una solicitud regresa 403	Para OAuth personal, confirme que el usuario activo sea un editor en lugar de un observador en el tablero de destino. Para una clave API o un agente desatendido, confirme también que la credencial tenga capacidad de escritura.
El agente puede leer pero no editar.	Permita la acción de escritura en el cliente MCP y confirme que la identidad actuante tenga acceso al editor de el tablero. Para conexiones de servicio y claves API, utilice también una credencial con capacidad de escritura. No es necesario volver a conectar las conexiones OAuth personales existentes.
El agente no puede encontrar un tablero.	Utilice el descubrimiento completo del tablero. Un tablero puede ser independiente o estar disponible solo a través de una membresía invitada explícita.
El agente no puede administrar un espacio de trabajo.	MCP cubre solo la creación de espacios de trabajo y tableros y la gestión de automatizaciones, y solo cuando la identidad actuante es un administrador; Las credenciales de solo lectura y con ámbito de espacio de trabajo no pueden crear espacios de trabajo. Para otra administración, utilice la interfaz Kanera o un punto final REST público compatible.
Un agente de codificación tiene herramientas pero las usa mal	instalar el oficial Habilidad del agente Kanera.
No aparecen herramientas nuevas o modificadas	Actualice o vuelva a escanear el servidor MCP en el cliente para que recupere los esquemas actuales. Reinicie el cliente si no tiene ninguna acción de actualización; Normalmente no se requiere la reautorización de OAuth.
El cliente no puede suscribirse a eventos.	Los eventos necesitan el anfitrión /mcp punto final y un cliente en el protocolo MCP actual; un estéreo kanera mcp El servidor nunca los ofrece. Ver Suscríbete a eventos para errores de alcance y devolución de llamada.

Páginas relacionadas

• Kanera CLI

• Conecte Kanera con su agente de IA

• Conéctese con OAuth o un agente desatendido

• Ejemplos de cómo utilizar Kanera con IA

• Suscríbete a eventos

• Inventario de herramientas MCP

• API pública