# Donnez à Cursor l'accès à Linear

> Vous copiez à la main les détails des tickets dans l'éditeur avant chaque tâche.

Cette configuration s'adresse aux développeurs qui planifient leur travail dans Linear et codent dans Cursor. L'agent de Cursor lit une issue Linear par son identifiant, planifie la modification à partir de la description et des commentaires, puis ouvre une pull request GitHub liée à l'issue. Vous ne copiez plus le texte des tickets à la main dans l'éditeur.

## Étapes

1. **Ajouter Linear à Cursor**: Ouvrez Cursor Settings > MCP (Tools & Integrations dans les versions récentes) et ajoutez un nouveau serveur. Utilisez l'URL du serveur distant de Linear, https://mcp.linear.app/mcp, dans votre mcp.json. Enregistrez le fichier et attendez que le serveur apparaisse comme connecté.
   Astuce: Placez-le dans le .cursor/mcp.json du projet si un seul dépôt a besoin de Linear, ou dans votre configuration globale pour tous les projets.
2. **Autoriser votre espace de travail**: Au premier appel de Cursor vers Linear, une fenêtre de navigateur s'ouvre pour l'OAuth. Connectez-vous et choisissez l'espace utilisé par votre équipe, puis revenez dans Cursor. Demandez à l'agent de lister les issues qui vous sont assignées pour vérifier qu'il voit le bon espace.
   Astuce: Si vous changez d'espace plus tard, supprimez puis ajoutez de nouveau le serveur pour refaire l'autorisation.
3. **Mentionner les issues dans vos prompts**: En mode Agent, demandez à Cursor de lire une issue par son identifiant, par exemple ENG-412, et de proposer un plan avant d'écrire du code. Comparez le plan avec les critères d'acceptation et les commentaires de l'issue. Laissez-le ensuite faire la modification dans votre branche.
   Astuce: Demandez à l'agent de publier un court commentaire d'avancement sur l'issue Linear quand il a terminé.
4. **Ouvrir la pull request**: Ajoutez le serveur MCP de GitHub avec un jeton fine-grained capable de créer des branches et des pull requests dans le dépôt. Demandez à Cursor d'ouvrir une PR avec l'identifiant de l'issue Linear dans le titre ou le nom de branche. L'intégration GitHub de Linear relie alors automatiquement la PR à l'issue.
   Astuce: L'intégration GitHub doit être activée dans les paramètres de Linear pour que le lien soit automatique.

## Prompts à essayer

- Lis ENG-412 et propose un plan pour la modification avant d'écrire du code.
- Implémente ENG-412 dans une nouvelle branche nommée eng-412-export-csv et lance les tests.
- Liste mes issues Linear du cycle en cours qui sont In Progress.
- Ouvre une pull request pour cette branche avec ENG-412 dans le titre et un résumé des modifications.
- Ajoute un commentaire sur ENG-412 indiquant que le correctif est en relecture, avec le lien de la PR.

## Ce qu'il vous faut

- Cursor avec le mode Agent
- Un compte Linear dans l'espace de travail à utiliser
- Un jeton GitHub fine-grained avec accès aux pull requests
- L'intégration GitHub de Linear activée pour lier automatiquement les PR

## Limites

- L'agent ne connaît que l'issue, ses commentaires et votre dépôt ; les décisions prises en réunion lui restent invisibles.
- L'accès OAuth utilise vos permissions Linear : l'agent voit donc toutes les équipes que vous voyez.
- Les longs fils de discussion occupent de l'espace de contexte ; sur les grosses issues, demandez d'abord un résumé.

## Notes de sécurité

- Utilisez OAuth plutôt qu'une clé API personnelle quand c'est possible.
- Vérifiez toute mise à jour d'issue proposée par Cursor.

## Serveurs MCP

- [Linear MCP Server](https://linear.app/docs/mcp): issue-read, issue-write, project-read
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Questions fréquentes

**De quelle offre Cursor ai-je besoin ?**

Les serveurs MCP fonctionnent dans le mode Agent de Cursor, disponible sur les offres gratuite et payantes avec des limites d'usage différentes. Consultez la page tarifs de Cursor pour les limites actuelles.

**Cursor peut-il modifier les issues Linear ?**

Oui. Le serveur MCP de Linear peut créer et mettre à jour des issues et des commentaires avec les permissions de votre compte. Cursor demande avant d'exécuter des appels d'outils, sauf si vous activez l'exécution automatique.

**Est-ce que cela fonctionne dans d'autres éditeurs ?**

Le serveur de Linear fonctionne avec n'importe quel hôte MCP, dont Claude Code, VS Code et Windsurf. Ce guide utilise Cursor parce que les étapes et les chemins de paramètres correspondent à son interface.

**Et si la description de l'issue est maigre ?**

L'agent planifie à partir de ce que dit l'issue. Ajoutez d'abord des critères d'acceptation et des liens vers les maquettes dans Linear, ou donnez les détails manquants dans votre prompt.

## Outils

- **[Linear](https://suiteintent.com/t/linear?m=FR)**: Suivi de tickets rapide, pensé pour le clavier. · Idéal pour: Startups qui planifient par cycles · Offre gratuite · Gratuit pour les startups
- **[GitHub](https://suiteintent.com/t/github?m=FR)**: Hébergement de code, tickets et pull requests. · Idéal pour: Équipes qui relisent le code par pull request · Offre gratuite · 10000
