Aplicación lineal MCP

Protocolo de Contexto de Modelo (MCP) para la integración con Linear como herramienta de IA. Esta herramienta permite que su IA interactúe con Linear a través del Protocolo de Contexto de Modelo.

Características

• Integración lineal completa :
  • Problemas de búsqueda
  • Crear nuevos problemas
  • Problemas de actualización
  • Añadir comentarios
  • Actualizar comentarios
  • Obtener perfiles de usuario
  • Obtener información del equipo

Prerrequisitos

• Node.js 18 o más reciente
• Clave API lineal

Cómo obtener una clave API lineal

Para usar esta aplicación, necesita una clave API de Linear. Estos son los pasos para obtenerla:

1. Iniciar sesión o crear una cuenta lineal
   • Visita Linear e inicia sesión en tu cuenta existente o regístrate para crear una nueva cuenta
2. Acceder a la configuración del espacio de trabajo
   • Desde la página principal, haga clic en su nombre de usuario en la esquina superior izquierda
   • Seleccione la opción "Configuración del espacio de trabajo"
3. Abrir configuración de API
   • En la columna "Configuración" del lado izquierdo, desplácese hacia abajo hasta encontrar "API".
   • Haga clic en la opción “API”
4. Crear una nueva clave API
   • Ingrese una etiqueta para su clave API (por ejemplo, "Aplicación lineal MCP")
   • Haga clic en el botón "Crear nueva clave API"
5. Almacenar la clave API de forma segura
   • La clave API se mostrará solo una vez
   • Cópielo y guárdelo en una ubicación segura porque Linear no lo volverá a mostrar.

Nota importante : Linear tiene un límite de 1500 solicitudes de claves API por hora. Asegúrese de que su aplicación respete este límite para evitar errores 429 "Demasiadas solicitudes".

Para obtener información más detallada sobre cómo obtener y utilizar claves de API lineales, puede visitar esta guía en Merge.dev .

Cómo utilizar la herramienta

1. Configuración inicial

1. Clonar este repositorio:

2. Instalar dependencias:

3. Cree un archivo .env en el directorio raíz:

4. Construir el proyecto:

5. La carpeta dist ahora está lista para usarse para la configuración en varias plataformas de IA.

2. Configuración del cursor

1. Encuentre su archivo de configuración de Cursor MCP:
   • Windows: C:\Users\<username>\.cursor\mcp.json
   • macOS: ~/.cursor/mcp.json
   • Linux: ~/.cursor/mcp.json
2. Edite el archivo para agregar la configuración del servidor Linear MCP:
   { "mcpServers": { "linear": { "command": "<path-to-node>", "args": [ "<path-to-project>/dist/index.js" ], "env": { "LINEAR_API_KEY": "your_linear_api_key_here" } } } }
3. Reemplace los marcadores de posición:
   • <path-to-node> : Ruta a su ejecutable Node.js
   • <path-to-project> : Ruta absoluta al directorio del proyecto de su aplicación lineal MCP
   • your_linear_api_key_here : Su clave de API lineal

Ejemplo de configuración:

4. Guarde el archivo y reinicie Cursor para que los cambios surtan efecto.

3. Configuración de Claude

Para usar MCP Linear Tools con Claude, debe agregar la configuración al archivo de configuración de Claude. Siga estos pasos:

1. Abra la configuración de la aplicación de escritorio Claude AI
2. Vaya a la sección "Desarrollador"
3. Busque la sección de configuración "Herramientas"
4. Agregue configuración para MCP lineal de la siguiente manera:

5. Reemplace los marcadores de posición:
   • <path-to-node> : Ruta a su ejecutable Node.js
   • <path-to-project> : Ruta absoluta al directorio del proyecto de su aplicación lineal MCP
   • your_linear_api_key_here : Su clave de API lineal

Ejemplo de configuración:

4. Configuración en otras plataformas

El principio básico es el mismo para otras plataformas de IA que admiten MCP:

1. Encuentre el área de configuración para herramientas externas o MCP
2. Configúrelo para ejecutar Node.js con el archivo dist/index.js de este repositorio
3. Incluya su LINEAR_API_KEY en la configuración del entorno

Herramientas disponibles

Después de la configuración, su IA tendrá acceso a las siguientes herramientas lineales:

• search_issues - Busque problemas por palabra clave, estado o prioridad
• create_issue - Crea un nuevo problema
• get_issue - Obtener detalles del problema
• update_issue - Actualizar un problema existente
• create_comment - Agregar un comentario a un problema
• get_comment - Obtener comentarios de un problema
• update_comment - Actualizar o eliminar un comentario
• get_profile - Obtener el perfil de usuario lineal actual
• get_team_id - Obtener una lista de equipos y sus ID

Soporte y ayuda

Si tiene problemas al utilizar esta herramienta, por favor:

1. Comprueba que tu clave API lineal sea válida y tenga permisos suficientes
2. Asegúrese de que Node.js esté instalado correctamente
3. Verifique la configuración de su MCP en su plataforma de IA
4. Revise los archivos de registro para ver si aparecen mensajes de error

Uso de herramientas lineales en entornos de IA

Una vez configuradas las herramientas lineales en tu entorno de IA, puedes empezar a usarlas indicándole a la IA. Aquí tienes algunos ejemplos:

Uso de herramientas lineales en el cursor

En Cursor, puedes simplemente pedirle a Claude que realice tareas relacionadas con Linear:

Ejemplo de flujo de trabajo: creación y gestión de problemas

A continuación se muestra un ejemplo de flujo de trabajo que muestra cómo puede utilizar estas herramientas:

1. Encontrar el ID de tu equipo :
   What's my Linear team ID?
   Claude utilizará la herramienta get_team_id para obtener la información de su equipo.
2. Creando un nuevo problema :
   Create a new Linear issue titled "Implement password reset feature" for the Engineering team with a high priority. The description should be "Users need a way to reset their passwords when they forget them."
   Claude utilizará la herramienta create_issue con los parámetros necesarios.
3. Buscando problemas :
   Find all high priority issues assigned to me that are currently in progress.
   Claude utilizará la herramienta search_issues con los filtros apropiados.
4. Actualizando un problema :
   Update issue LIN-456 to add the description "This issue has been verified and tested on all browsers."
   Claude utilizará la herramienta update_issue para modificar el problema.
5. Añadiendo comentarios :
   Add a comment to issue LIN-789 asking "Is this still a priority for this sprint?"
   Claude usará la herramienta create_comment para agregar el comentario.
6. Recuperando comentarios :
   Show me all the comments on issue LIN-321
   Claude utilizará la herramienta get_comment para obtener los comentarios.

Estos ejemplos demuestran con qué naturalidad puedes interactuar con Linear a través de tu asistente de IA una vez que las herramientas estén configuradas correctamente.

Actualizaciones recientes

Este proyecto se ha mejorado recientemente con documentación mejorada y herramientas lineales. Las mejoras incluyen:

• README actualizado con instrucciones de instalación y configuración más claras
• Documentación mejorada con ejemplos para varias plataformas de IA
• Herramientas lineales mejoradas con mejor manejo de errores y formato de respuesta
• Se agregó soporte para administrar comentarios (crear, obtener, actualizar, eliminar)
• Capacidad de búsqueda mejorada con filtrado por estado y prioridad

Licencia

Este proyecto está licenciado bajo la licencia MIT.

https://kelasinovatif.com/