Aller au contenu

Connecter Claude Code à Stellary

Lisez vos cartes et documents dans Claude Code grâce à MCP. Pour une mission de code lancée depuis Stellary, connectez Desktop au dépôt local et suivez le résultat dans la carte.

Claude Code · exécution locale ou client MCP

Claude Code

Connecté

Stellary

Projet de lancement

Prêt
Contexte projet
Préparer la mission de livraison
Activité
Identité, projet et outils restent cadrés

Du contexte projet à une première mission Claude Code

MCP donne au client accès au projet. Desktop permet à Stellary de lancer une mission dans le dépôt lié. Choisissez le parcours correspondant à votre besoin.

  1. 01

    Installer

    Installez et authentifiez Claude Code sur la machine qui possède le dépôt.

  2. 02

    Connecter

    Ouvrez Stellary Desktop et actualisez les moteurs disponibles.

  3. 03

    Lier

    Rattachez le dossier Git local au projet Stellary correspondant.

  4. 04

    Affecter

    Choisissez Claude Code comme cible puis lancez la mission depuis la carte.

  5. 05

    Relire

    Suivez la progression, les questions, le résultat ou l’échec dans le journal d’activité.

Mission STL-128

Installez et authentifiez Claude Code sur la machine qui possède le dépôt.

En cours

Liste de contrôle

Connecter
Lier
Affecter

Contexte lié

project-brief.md

Claude Code travaille sur la machine connectée dans le dépôt lié au projet.

Lancer la mission

Claude Code part de la carte, pas d’une consigne copiée

Le moteur local reçoit la mission et le dépôt lié. MCP offre un second chemin pour agir sur les objets de l’espace de travail.

Exécution dans le dépôt local

Claude Code travaille sur la machine connectée dans le dépôt lié au projet.

Contexte de mission

Carte, liste de contrôle, documents, règles et résultat attendu restent attachés à l’exécution.

Retour visible

Progression, questions, annulation, échec et résultat reviennent dans le journal d’activité.

Connexion MCP Claude Code avec OAuth

Shell

Dans Claude Code, ouvrez /mcp puis authentifiez Stellary dans le navigateur. Sélectionnez votre espace de travail et les accès nécessaires.

claude mcp add --transport http stellary https://api.stellary.co/mcp
claude mcp list

Alternative : jeton MCP

JSON

Configuration .mcp.json du projet. Définissez STELLARY_MCP_TOKEN dans l’environnement du client avant son lancement. Pour découvrir le projet en votre nom, un PAT projects:read suffit ; une mission d’agent demande une identité et des permissions adaptées.

{
  "mcpServers": {
    "stellary": {
      "type": "http",
      "url": "https://api.stellary.co/mcp",
      "headers": {
        "Authorization": "Bearer ${STELLARY_MCP_TOKEN}"
      }
    }
  }
}

Documentation de configuration vérifiée le .

Préparer le client et le projet

Installez une version récente de Claude Code et vérifiez que son aide propose les commandes MCP ci-dessus. Le compte du fournisseur IA et la connexion à Stellary sont deux accès distincts.

Créez un projet Stellary avec une carte de test, un objectif précis et un document de contexte. Pour lire ces données par MCP, aucun dépôt local ni Desktop n’est nécessaire.

Vérifier la connexion MCP en lecture

Après le consentement OAuth, ouvrez /mcp dans le client et vérifiez que Stellary est disponible. Demandez ensuite : « Appelle stellary_init, liste les projets auxquels j’ai accès, puis résume les critères de la carte de test. Ne modifie aucun objet. »

La vérification réussit quand le client retrouve le bon projet et les critères réellement écrits dans la carte. Utilisez les identifiants retournés par list_projects pour les appels suivants. Un serveur ajouté à la configuration ne prouve pas encore cet accès.

Préparer une première mission avec Desktop

Pour lancer Claude Code depuis une carte, installez et authentifiez sa CLI sur la machine du dépôt. Dans Stellary Desktop, actualisez les moteurs, partagez le moteur disponible avec l’espace de travail, puis liez le dossier Git exact au projet.

Configurez un agent en exécution locale avec Claude Code. Préparez une carte : « Lis le README et les scripts du dépôt. Propose un plan de vérification avec les commandes pertinentes, sans modifier de fichier. » Lancez la mission et attendez son retour dans l’activité de la carte.

  • La machine est connectée et le moteur est prêt.
  • La trace indique le projet et le dépôt attendus.
  • Le résultat cite les fichiers consultés et sépare les commandes proposées des tests exécutés.
  • Une personne relit le résultat avant de lancer une modification de code.

Corriger une connexion qui échoue

Une réponse 401 indique un accès absent, expiré ou révoqué. Reconnectez OAuth, ou vérifiez le jeton et la variable d’environnement dans le processus du client.

Une réponse 403 demande de vérifier les scopes, le rôle et l’accès au projet. Si un outil n’est pas annoncé, vérifiez aussi l’identité choisie et la politique de l’agent.

  • Pour Claude Code, utilisez --transport http dans la commande ; dans le JSON, indiquez type: http.
  • Si Desktop ne voit pas le moteur, vérifiez son installation et sa connexion sur la machine concernée, puis actualisez.
  • Si la mission reste en attente, vérifiez la machine, le partage du moteur, le dépôt lié et la cible de l’agent.

Savoir où s’exécute le travail

Une connexion MCP distante donne accès au projet hébergé. Une mission Desktop s’exécute sur la machine connectée ; cela ne signifie pas que le modèle IA tourne localement.

Le fournisseur du modèle peut recevoir le contexte nécessaire à la demande et appliquer ses propres conditions d’accès ou de facturation. Vérifiez le modèle choisi et les données autorisées avant d’envoyer un document sensible.

Quelle connexion Claude Code choisir ?

Rôle principal

Runner local

Travailler dans le dépôt lié.

MCP distant

Agir sur les données projet Stellary.

Lieu d’exécution

Runner local

Machine Desktop connectée.

MCP distant

Environnement client MCP compatible.

Identité

Runner local

Agent et machine configurés dans l’espace de travail.

MCP distant

Identité OAuth, PAT ou jeton d’agent.

Point de départ

Runner local

Mission de code depuis une carte.

MCP distant

Découverte du projet ou boucle d’agent externe.

Questions sur Claude Code et Stellary

Claude Code peut-il modifier un dépôt depuis Stellary ?

Oui, via Stellary Desktop lorsque le projet possède un dépôt local lié et que l’agent utilise l’exécution locale.

Claude Code a-t-il besoin de MCP pour les missions locales ?

Vous n’avez pas à ajouter manuellement le serveur distant pour lancer une mission avec Desktop. La configuration MCP ci-dessus sert à connecter votre propre session Claude Code aux outils Stellary.

Que se passe-t-il si la machine est hors ligne ?

Une machine hors ligne, en pause ou déconnectée ne peut pas prendre de nouvelle mission locale. L’état reste visible dans l’espace de travail.

Les écritures Claude Code peuvent-elles demander une validation ?

Oui. Les écritures effectuées avec un jeton d’agent suivent sa politique. En mode approbation, elles deviennent des propositions.

Lancez une mission Claude Code depuis une vraie carte

Connectez la machine, liez le dépôt et conservez le résultat dans le journal d’activité.

Créer un projet Stellary