Qu’est-ce que la triple connexion MCP ?
Claude Code MCP utilise le protocole MCP pour amener GitHub (issues et intention), CodeGraph (structure du dépôt et rayon d’impact) et les API (environnement et vérité terrain) dans Claude Code, afin que l’agent voie quoi faire, quoi modifier et si c’est correct — nous appelons cela la triple connexion.
Cette page est la vue d’ensemble MCP du Cloud Mac AI Stack : un schéma pour la vision globale, puis des liens vers l’installation, l’architecture ou CodeGraph. Commandes et dépannage restent dans les articles dédiés. Article L2 précédent : ordonnancement mémoire parallèle.
Pourquoi plusieurs articles plutôt qu’un seul long
Les lecteurs n’arrivent pas dans le même état d’esprit : certains veulent l’environnement opérationnel tout de suite ; d’autres comprendre pourquoi GitHub et CodeGraph vont ensemble ; d’autres surtout resserrer tokens et permissions. Mettre installation, théorie et listes de droits dans une seule URL oblige ceux qui cherchent du JSON à défiler de longs blocs mcpServers, et coupe la lecture de ceux qui veulent d’abord la carte.
Nous avons donc séparé par tâche : cette page montre le rôle de chaque brique en un schéma ; ouvrez le guide d’installation pour câbler ; l’article d’architecture pour expliquer le design à l’équipe. Traitez ceci comme l’entrée — choisissez la suite d’ici.
Rôle dans la série
Pensez-y comme au sommaire de la triple connexion MCP : voir comment les pièces s’assemblent, puis ouvrir l’article qui correspond à votre besoin. Pas d’installation à votre place, pas de substitut aux guides CodeGraph ou Runner.
Cette page ne contient pas :
- Installation pas à pas de Claude Code MCP (pas de liste de commandes à copier-coller)
- Longues dérivations d’architecture ou théorie Context Engineering
- Déploiement ou exploitation de CodeGraph seul (voir CodeGraph en cinq minutes)
Cette page vous aide à choisir la prochaine lecture selon votre objectif ou symptôme — installation, architecture, graphe, Runner, exécution ou permissions.
Pas ici — le bon article
Si vous cherchez ce qui est dans la colonne de gauche, utilisez « Lire » — ne cherchez pas les étapes sur cette vue d’ensemble.
| Vous cherchez peut-être… | Pas sur cette page | Lire |
|---|---|---|
Commandes d’installation et exemples mcpServers |
Pas de tutoriel pas à pas | Guide d’installation |
Exemples complets ~/.claude.json et PAT GitHub |
Pas de walkthrough config complet | Guide d’installation |
Erreurs outils MCP ou codegraph_impact vide |
Pas d’étapes de dépannage | Guide d’installation · tableau par symptôme |
| Pourquoi Context → Diff → Fact est structuré ainsi | Pas d’article théorique long | Article d’architecture |
| CI verte après push et enregistrement Runner | Hors périmètre installation MCP | Guide GitHub Runner |
Navigation rapide : quoi lire ensuite
Choisissez un sujet selon votre objectif ; des tableaux par scénario et symptôme suivent plus bas.
| Je veux… | Lire | Contenu |
|---|---|---|
| Faire tourner MCP dans le chat | Guide d’installation | Config · vérif · erreurs courantes |
| Comprendre GitHub / graphe / API ensemble | Article d’architecture | Couches · flux · compromis |
| Déployer seulement le graphe de dépôt (CodeGraph) | CodeGraph en cinq minutes | MCP graphe seul |
| Reserrer tokens, API lecture seule, limites | Guide des permissions | Moindre privilège · isolement |
Besoin de checks CI verts après un push ? Voir guide GitHub Runner. Couvercle fermé et MCP coupe ou index périmé ? Cloud Mac vs Mac local
Que voulez-vous faire ?
Les mots-clés varient, mais les buts tombent en général dans quatre cases. Choisissez la vôtre pour gagner du temps.
① Mettre l’environnement en route
Ex. : Claude Code MCP setup · install MCP server · configure GitHub MCP · connect Claude Code to GitHub
Objectif : Faire tourner la chaîne d’outils et voir les outils mcp__* dans Claude Code.
Suggestion Guide d’installation
② Comprendre la conception globale
Ex. : MCP architecture explained · Context Diff Fact · why MCP needed
Objectif : Comprendre les couches et aligner l’équipe.
Suggestion Article d’architecture
③ Graphe de dépôt / analyse d’impact seulement
Ex. : CodeGraph MCP · codegraph_impact · repo graph Claude Code
Objectif : Brancher le graphe d’abord ; le flux issues GitHub peut attendre.
Suggestion CodeGraph en cinq minutes ; pour la triple connexion complète plus tard Guide d’installation
④ Permissions et sécurité
Ex. : MCP permissions · token scope · read-only API MCP
Objectif : Contrôler le scope des tokens, isoler les outils en écriture, staging en lecture seule.
Suggestion Guide des permissions ; pour un minimum viable d’abord, suivez le guide d’installation puis resserrez les permissions
Pas sûr ? Navigation rapide ou le tableau par symptôme ci-dessous.
Scénarios courants — par ici
Même triple connexion, entrées différentes — choisissez la ligne qui vous ressemble.
- Première fois avec MCP : parcourir ce schéma → guide d’installation
- CodeGraph OK, ajouter GitHub → guide d’installation (section GitHub) ; graphe dans CodeGraph en cinq minutes
- CI : checks verts après push → guide GitHub Runner ; MCP vs Runner → article d’architecture
- Reserrer tokens, variables d’env, API lecture seule → Guide des permissions ; branchement minimal via guide d’installation
- Installé mais outils absents ou instables → guide d’installation · dépannage
- Architecture seulement, pas encore d’install → article d’architecture
Un souci ? Repérez votre symptôme
Chaque symptôme pointe vers l’article qui aide en général. Causes et commandes sont là-bas — pas sur cette vue d’ensemble.
| Ce que vous voyez | Concerne souvent | Suggestion |
|---|---|---|
Claude Code ne voit pas les issues GitHub / pas de mcp__github__* |
Contexte GitHub non branché | Guide d’installation |
codegraph_impact vide / pas de CodeGraph dans les outils MCP |
Index graphe ou répertoire de travail | Guide d’installation · CodeGraph en cinq minutes |
| Code modifié mais CI rouge / pas de checks verts | CI / vérification | Guide GitHub Runner |
| Fichiers à modifier flous / l’agent grep tout le dépôt | Contexte code manquant | CodeGraph en cinq minutes → Guide d’installation |
staging / API ne correspondent pas ; deviner .env |
Environnement / vérité terrain (API) | Article d’architecture · branchement via Guide d’installation |
| MCP toujours inutilisable après install | Config / dépannage | Guide d’installation |
| Couvercle fermé : MCP coupe / index invalide | Exécution (local vs cloud) | Cloud Mac vs Mac local |
| MCP trop permissif / fuite token / risque API en écriture | Permissions / sécurité | Guide des permissions |
| MCP sans GitHub Runner ? | Rôles MCP vs CI | Article d’architecture + Guide Runner |
Trois parcours de lecture courants
Premier contact avec MCP
Ouvrir Claude Code → cette vue (triple connexion) → guide d’installation pour mcpServers et vérifier les outils dans le chat → pour les checks après push, guide GitHub Runner.
Graphe fait — GitHub seulement
CodeGraph en cinq minutes terminé → revenir ici pour placer GitHub → GitHub MCP dans le guide d’installation → limites optionnelles dans l’article d’architecture.
Déploiement équipe : CI assistée par IA
Cette vue → guide d’installation (triple) → guide Runner (checks auto) → article d’architecture (alignement) → Guide des permissions pour resserrer les tokens.
Un schéma, des rôles clairs
GitHub = intent CodeGraph = context API = truth Claude Code = diff Runner = fact
FAQ
| Question | Lire |
|---|---|
| MCP ne marche pas après installation ? | Guide d’installation |
Pourquoi codegraph_impact est vide ? |
Guide d’installation |
| MCP sans GitHub Runner ? | Article d’architecture |
| Comment connecter GitHub à Claude Code ? | Guide d’installation |
| Comment voir l’architecture MCP globale ? | Article d’architecture |
| Comment resserrer les permissions des tokens ? | Guide des permissions |
Mettez cette page en favori comme point d’entrée MCP triple connexion. Slug anglais : claude-code-mcp-github-files-api-chain.
Cloud Mac AI Stack · Triple connexion MCP
Prochaine lecture
Guide d’installation · Article d’architecture · CodeGraph en cinq minutes · Tarifs Cloud Mac
Retour au blog · série Cloud Mac AI Stack