Manual

Integración con Claude

Integración con Claude

v1.11.0+

La Integración con Claude agrega una extensión a la app de escritorio de Claude (Windows y macOS) para manejar GeckoFlag desde una conversación con Claude. Permite buscar, consultar, crear y actualizar tareas, proyectos, páginas Wiki y notas, y exportar el diagrama de Gantt a Excel. La extensión funciona en la computadora del usuario y se comunica directamente solo con su GeckoFlag. Todas las operaciones se hacen con los permisos del dueño del token de API.

Configuración del administrador

  1. 1Abre Configuración en el menú lateral y haz clic en Editar en la tarjeta Integración con Claude.Pantalla de configuración con la tarjeta «Claude Integration» marcada en rojo
  2. 2Activa Activar la Integración con Claude (desactivada de forma predeterminada). Si también quieres que Claude cree y modifique datos, activa además Permitir escritura y guarda. Si no permites la escritura, todos los tokens pasan a ser de solo lectura.Pantalla de configuración de la Integración con Claude con las casillas «Enable Claude integration» y «Allow writing» marcadas en rojo y, debajo, el número de usuarios con permiso y de tokens de API
  3. 3En Usuarios, abre Editar en el usuario correspondiente, activa Permitir la Integración con Claude (API) y haz clic en Actualizar. Es una opción distinta de «Permitir registro asistido por IA». Si quitas el permiso, se eliminan todos los tokens de API de ese usuario.Pantalla de edición de usuario con «Users» en el menú lateral y la casilla «Allow Claude integration (API)» marcados en rojo

Cómo crear un token de API

  1. 1Abre Perfil en el menú lateral y, en la sección Tokens de API, indica el nombre del token, la caducidad (30, 90 o 365 días, o sin caducidad; el valor predeterminado es 90 días) y el permiso (Solo lectura o Lectura y escritura), y crea el token.Sección «API Tokens (Claude Integration)» de la pantalla de perfil con los campos Token name, Expires in y Permission marcados en rojo
  2. 2Copia el token que aparece (una cadena que empieza por gfk_). El token solo se muestra una vez, justo después de crearlo. Anota también la «URL para la extensión» que aparece en la misma sección.
  • Cada persona puede crear hasta 5 tokens y eliminar en cualquier momento desde su perfil los que ya no use.
  • Al crear un token, el usuario recibe un correo de aviso. Si cambia su contraseña, se eliminan todos sus tokens.

Cómo configurar la app de escritorio de Claude

  1. 1En la app de escritorio de Claude, abre Configuración (Settings) → Extensiones (Extensions), arrastra y suelta el archivo de la extensión de GeckoFlag (.mcpb) y haz clic en Instalar (Install). También puedes instalarla haciendo doble clic en el archivo o desde Configuración avanzada (Advanced settings). El archivo de la extensión viene incluido en la descarga que obtienes al comprar GeckoFlag.
  2. 2En la pantalla de configuración, completa los siguientes campos y haz clic en Guardar (Save).
    • GeckoFlag URL (obligatorio): la URL que anotaste. Debe usar https:// (http:// solo se admite para localhost, *.test y *.local).
    • API token (obligatorio): el token que copiaste. Se guarda enmascarado.
    • Export folder (opcional): la carpeta donde se guardan los archivos de Excel del diagrama de Gantt. Si la dejas vacía, se guardan en la carpeta Descargas.
    Pantalla de configuración de la extensión de GeckoFlag con los campos GeckoFlag URL, API token y Export folder
  3. 3Pídele a Claude «Comprueba si estás conectado a GeckoFlag». Si aparecen el dueño del token, la versión de GeckoFlag y si puede escribir o no, la configuración está completa.

Para ver los pasos detallados con capturas de pantalla, consulta la guía de configuración de la Integración con Claude. Te recomendamos dejar las operaciones de escritura en «pedir confirmación siempre» en la configuración de la extensión en Claude.

Qué puede hacer

  • Tareas: buscar (por proyecto, estado, responsable, creador, prioridad, palabra clave, fecha de vencimiento o tarea padre), consultar detalles y comentarios, crear (también con tarea padre y destinatarios de notificación), cambiar campos, publicar comentarios y cambiar el estado.
  • Proyectos: consultar la lista y los detalles, crear (todos salvo los invitados), cambiar el nombre, la descripción, el propietario y el periodo, marcar como completado o no completado, y agregar o quitar miembros (propietario y administradores).
  • Wiki: consultar, reescribir el título y el contenido, y agregar texto al final (miembros del proyecto y administradores).
  • Notas: listar, buscar, consultar, crear, reescribir y ampliar tus propias notas.
  • Catálogos: agregar tipos de tarea, estados, prioridades, y cargos y departamentos, y cambiar sus nombres y colores (administradores).
  • Diagrama de Gantt: guarda en tu computadora las tareas de un proyecto (hasta 5.000) como archivo de Excel. Si el periodo supera los 120 días, cada columna equivale a 1 semana.
  • Búsqueda de usuarios: busca usuarios por nombre (solo devuelve el ID y el rol, nunca la dirección de correo).

Puedes indicar una tarea por su clave, como «WEB-12». Para escribir se necesitan tanto un token de «Lectura y escritura» como «Permitir escritura» en el sitio.

Qué no puede hacer y límites

  • No puede eliminar (proyectos, tareas, comentarios, catálogos, páginas Wiki ni notas), editar comentarios, adjuntar ni ver imágenes y archivos, cambiar la clave de un proyecto ni reordenar los catálogos.
  • No puede agregar ni editar usuarios, cambiar la configuración del sitio, operar el tablero Kanban, los marcadores o la configuración de notificaciones, ni ver las notas de otros usuarios (ni siquiera siendo administrador).
  • Escribe un elemento a la vez. Si hay varios, Claude los procesa uno por uno. Espera la respuesta hasta 30 segundos, y las escrituras no se reintentan automáticamente para evitar registros duplicados.
  • El título de una tarea admite hasta 50 caracteres y el nombre de un elemento de catálogo, hasta 20 (hasta 10 elementos por catálogo, con 8 colores para elegir). El contenido de una página Wiki admite hasta 65.535 bytes en total, y el de una nota, hasta 1.000.000 de bytes.
  • Cuando Claude lee descripciones, páginas Wiki o notas de más de 8.000 caracteres, o comentarios de más de 2.000, el texto se recorta. Claude no reescribe un texto recortado; en su lugar, propone agregar contenido al final.
  • Las búsquedas y listas devuelven hasta 50 resultados por página. El límite de solicitudes es de 60 por minuto por token.
  • Solo funciona mientras la app de escritorio de Claude está abierta en la computadora.

Historial y correos de notificación

  • Al cambiar los campos de una tarea, igual que al editarla en pantalla, no se agrega un comentario de historial ni se envían correos. Si quieres dejar historial, pide «haz el cambio como comentario».
  • Si cambias el estado u otros campos mediante un comentario, igual que en pantalla, se agrega el historial y los miembros que reciben notificaciones de todos los comentarios reciben un correo.
  • Al crear una tarea, solo reciben correo los miembros indicados como destinatarios de notificación. Al crear un proyecto, los miembros reciben un correo de invitación (no se envía al agregarlos después).
  • Las operaciones se registran como hechas por el dueño del token, sin indicar que se hicieron «a través de Claude».

Seguridad y tratamiento de los datos

Cuando la Integración con Claude está desactivada, la API se trata como una URL inexistente (404). Los proyectos y tareas sin permiso también se tratan como si «no existieran». En el servidor solo se guarda el hash de los tokens, y la restricción de acceso por dirección IP de GeckoFlag también se aplica a la API. El contenido de tareas, páginas Wiki y notas que Claude lee se envía a Anthropic como parte de la conversación. Antes de empezar a usarla, verifica que tus normas internas y los contratos con tus clientes no restrinjan el envío de información a servicios externos. Si no logras conectarte, consulta Si algo no funciona.