Configuration de Claude Code

TeeckIn s'intègre à Claude Code pour suivre automatiquement votre temps de développement. La configuration prend moins d'une minute avec notre paquet NPM.

Une seule commande pour démarrer :

# Run in your project directory
npx @teeckin/agent init --claude

La commande de configuration crée ces fichiers dans votre projet :

Par défaut, Claude Code s'authentifie une fois et utilise le même agent pour tous les projets. Si vous souhaitez des agents différents pour des projets différents (par exemple un suivi du temps distinct pour le travail client), vous avez deux options.

Option 1 : portée locale (recommandé)

Utilisez la portée « locale » de Claude Code pour configurer TeeckIn par projet sans modifier le .mcp.json du projet. C'est idéal lorsque vous travaillez sur des bases de code clientes où vous ne voulez pas ajouter vos propres fichiers de configuration.

Ajoutez un paramètre de requête unique pour différencier l'URL de chaque projet :

# In project A
cd ~/projects/project-a
claude mcp add teeckin -s http -t streamable-http \
  --url "https://api.teeckin.com/api/mcp?project=project-a"

# In project B
cd ~/projects/project-b
claude mcp add teeckin -s http -t streamable-http \
  --url "https://api.teeckin.com/api/mcp?project=project-b"

Le paramètre de requête (?project=...) amène Claude Code à traiter chaque URL comme un serveur MCP distinct, déclenchant des flux OAuth séparés. Le serveur ignore le paramètre : la sélection de l'agent se fait lors de l'autorisation dans le navigateur.

Option 2 : configuration au niveau du projet

Si vous maîtrisez le projet, exécutez la commande de configuration avec une URL unique :

# Creates .mcp.json in the project
TEECKIN_API_URL="https://api.teeckin.com/api/mcp?project=my-project" \
  npx @teeckin/agent init --claude

Cela crée un fichier .mcp.json qui peut être committé dans le gestionnaire de versions. Chaque membre de l'équipe s'authentifiera avec son propre agent lors du flux dans le navigateur.

Lorsque vous avez fini de travailler, demandez à Claude d'arrêter le Timer :

Claude Code utilise OAuth PKCE (Proof Key for Code Exchange) pour une authentification sécurisée :

• +Aucun identifiant stocké dans les fichiers du projet
• +L'authentification se fait dans votre navigateur
• +Les jetons sont stockés en toute sécurité par Claude Code
• +Vous pouvez révoquer l'accès à tout moment depuis Paramètres > Agents

Le paquet fournit des commandes pour la configuration et le contrôle manuel du Timer :

Commandes de configuration

Commandes du Timer

Une fois configuré, Claude a accès à ces outils MCP :

Contrôle du Timer

Suivi de la liste de tâches

Notes et tags

Les tâches sont rattachées aux Topics, et non aux pointages individuels. Cela signifie que les tâches inachevées persistent d'une session à l'autre jusqu'à ce que vous les terminiez ou les écartiez. Le temps passé sur chaque tâche est suivi dès que vous commencez à y travailler.

Lorsque vous vérifiez l'état, la liste affiche les statuts et le temps :

Si vous effacez une conversation ou démarrez une nouvelle session dans les 10 minutes suivant l'arrêt, Claude le détecte et propose de reprendre votre session précédente.

Les tâches persistent automatiquement sur les Topics. Lorsque vous démarrez une nouvelle session sur le même Topic, les tâches en attente sont toujours là : nul besoin de les « reporter » ou d'accepter quoi que ce soit.