Créer un compte

API et agents MCP

Vos agents lisent et mettent à jour vos cartes. Vos outils parlent à 2T Bug par une API documentée.

Créer un compteDescription OpenAPI

Brancher un agent

2T Bug parle le protocole MCP : Claude, Cursor ou votre agent maison travaillent sur vos cartes, avec des droits projet par projet.

  1. Créez un jeton

    Mon compte, rubrique Accès développeurs. Choisissez la portée « Assistants IA », et une durée de validité. Le jeton ne s’affiche qu’une fois.

  2. Déclarez le serveur

    Remplacez VOTRE_JETON par le vôtre.

    Terminal
    claude mcp add --transport http 2t-bug https://api.2tbug.com/api/mcp \
  --header "Authorization: Bearer VOTRE_JETON"

  3. Ouvrez vos projets à l’agent

    Dans les réglages de chaque projet, autorisez la lecture, et l’écriture si l’agent doit créer ou modifier des cartes. Un projet fermé reste invisible pour lui.

Ce que l’agent peut faire

  • list_projectsLes projets ouverts à l’agent : colonnes, étiquettes, personnes, et si l’écriture est permise.
  • list_ticketsLes cartes d’un projet, filtrées par statut, type, epic, sprint, étiquette, urgence ou personne ; la corbeille aussi.
  • get_ticketTout d’une carte : description en Markdown, checklist, dépendances, pièces jointes, temps passé, commentaires.
  • get_ticket_historyL’historique d’une carte : qui a fait quoi, et quand.
  • searchLa recherche de l’application, filtres compris : « assigné:moi urgence:4+ ».
  • list_sprintsLes sprints d’un projet Scrum et leur périmètre.
  • create_ticketCrée une carte complète en une fois : champs, epic, sprint, personnes, étiquettes, checklist, dépendances.
  • update_ticketModifie les champs fournis ; ajoute ou retire une personne ou une étiquette sans tout remplacer.
  • move_ticketChange une carte de colonne, de place ou de sprint.
  • update_checklistAjoute, coche, décoche, renomme ou retire des éléments de checklist, en un appel.
  • link_ticketsPose une dépendance : bloque, bloquée par, liée à, doublon de.
  • unlink_ticketsRetire une dépendance entre deux cartes.
  • add_commentCommente ou répond ; les @mentions préviennent les personnes citées.
  • update_commentModifie un de ses commentaires.
  • delete_commentSupprime un commentaire (le sien, ou tout commentaire pour un administrateur).
  • add_attachmentJoint un fichier (10 Mo au plus) ou un texte : capture, journal, compte rendu.
  • remove_attachmentRetire une pièce jointe.
  • log_timeNote du temps passé : « 1h30 ».
  • delete_time_entrySupprime une saisie de temps.
  • merge_duplicateFusionne un doublon dans la carte originale.
  • delete_ticketMet une carte à la corbeille, restaurable 30 jours.
  • restore_ticketSort une carte de la corbeille.

L’API REST

Toutes les fonctions de l’application, en JSON. La description OpenAPI fait foi : générez votre client, ou lisez-la dans votre outil préféré.

Adresse
https://api.2tbug.com/api/v2
Authentification
En-tête Authorization: Bearer, avec un jeton de portée « API »
Format
JSON, dates ISO 8601, identifiants UUID
Description
openapi.json
Lister vos projets
curl https://api.2tbug.com/api/v2/projects \
  -H "Authorization: Bearer VOTRE_JETON"

Bonnes pratiques

  • Un jeton par usage, avec la portée la plus étroite possible et une date d’expiration.
  • Ne le collez jamais dans un dépôt de code : utilisez une variable d’environnement.
  • Un jeton exposé se révoque d’un clic, dans Mon compte. Il cesse aussitôt de fonctionner.