Accéder à GitHub
Connectez votre agent aux dépôts GitHub pour cloner, lire et créer des pull requests.
Vous pouvez monter un dépôt GitHub dans le sandbox de votre session et vous connecter au MCP GitHub pour créer des pull requests.
Les dépôts GitHub sont mis en cache, de sorte que les futures sessions utilisant le même dépôt démarrent plus rapidement.
MCP GitHub et ressources de session
Tout d’abord, créez un agent qui déclare le serveur MCP GitHub. La définition de l’agent contient l’URL du serveur mais aucun jeton d’authentification :
ant apply code-reviewer.md---
name: Code Reviewer
model: claude-opus-5-5
mcp_servers:
- type: url
name: github
url: https://api.githubcopilot.com/mcp/
tools:
- type: agent_toolset_20260401
configs:
- name: web_search
enabled: false
- name: web_fetch
enabled: false
- type: mcp_toolset
mcp_server_name: github
---
You are a code review assistant with access to GitHub.Créez ensuite une session qui monte le dépôt GitHub. Avec un environnement limited, la création de la session échoue avec une erreur 400 lorsque l’agent déclare un serveur MCP dont l’hôte ne figure pas dans allowed_hosts. Définir allow_mcp_servers sur true dans la configuration réseau de l’environnement désactive cette vérification.
session = client.beta.sessions.create(
agent=agent.id,
environment_id=environment.id,
resources=[
{
"type": "github_repository",
"url": "https://github.com/org/repo",
"mount_path": "/workspace/repo",
"authorization_token": "ghp_your_github_token",
},
],
)Une ressource github_repository accepte les champs suivants :
| Champ | Description |
|---|---|
type | Requis. Doit être "github_repository". |
url | Requis. L’URL HTTPS du dépôt sous la forme https://github.com/<owner>/<repo>, sans suffixe .git. Les autres formes, y compris les URL SSH, sont rejetées avec une invalid_request_error. |
authorization_token | Facultatif. Le jeton GitHub utilisé pour cloner le dépôt et y pousser des modifications. Sans jeton, le clonage d’un dépôt privé échoue après la création de la session. Un dépôt public se clone sans jeton, et l’agent peut effectuer des commits dans son clone, mais git push échoue. Il n’est pas renvoyé dans les réponses de l’API. Consultez Permissions du jeton. |
mount_path | Optionnel. Le répertoire sous /workspace dans lequel cloner le dépôt. Par défaut /workspace/<repo-name>. |
checkout | Optionnel. Une branche ({"type": "branch", "name": "main"}) ou un commit ({"type": "commit", "sha": "..."}) à extraire. Par défaut, la branche par défaut du dépôt. |
Le montage d’un dépôt charge également les skills stockées dans son répertoire racine .claude/skills. Les skills sont découvertes une seule fois par session, à partir de l’état du dépôt extrait au démarrage de la session. Consultez Charger des skills depuis un dépôt GitHub.
Autorisations des jetons
Lorsque vous fournissez un jeton GitHub, utilisez les autorisations minimales requises :
| Action | Portées requises |
|---|---|
| Cloner des dépôts privés | repo |
| Créer des PR | repo |
| Lire des issues | repo (privé) ou public_repo |
| Créer des issues | repo (privé) ou public_repo |
Plusieurs dépôts
Montez plusieurs dépôts en ajoutant des entrées au tableau resources :
resources = [
{
"type": "github_repository",
"url": "https://github.com/org/frontend",
"mount_path": "/workspace/frontend",
"authorization_token": "ghp_your_github_token",
},
{
"type": "github_repository",
"url": "https://github.com/org/backend",
"mount_path": "/workspace/backend",
"authorization_token": "ghp_your_github_token",
},
]Gérer les dépôts sur une session en cours d’exécution
Une fois une session créée, vous pouvez lister ses ressources de dépôt et renouveler leurs jetons d’autorisation. Chaque ressource possède un id renvoyé lors de la création de la session (ou via client.beta.sessions.resources.list()) que vous utilisez pour les mises à jour. Les dépôts sont attachés pendant toute la durée de vie de la session ; pour modifier les dépôts montés, créez une nouvelle session.
# Lister les ressources de la session
listed = client.beta.sessions.resources.list(session.id)
repo_resource_id = listed.data[0].id
print(repo_resource_id) # "sesrsc_01ABC..."
# Effectuer la rotation du jeton d'autorisation
client.beta.sessions.resources.update(
repo_resource_id,
session_id=session.id,
authorization_token="ghp_your_new_github_token",
)Créer des pull requests
Avec le serveur MCP GitHub, l’agent peut créer des branches, valider des modifications et les pousser :
client.beta.sessions.events.send(
session.id,
events=[
{
"type": "user.message",
"content": [
{
"type": "text",
"text": "Fix the type error in src/utils.ts, commit it to a new branch, and push it.",
},
],
},
],
)Prochaines étapes
Diffusez les événements en streaming et pilotez l’agent pendant qu’il ouvre la pull request
Connectez davantage de serveurs MCP pour donner à l’agent des outils supplémentaires
Montez des fichiers dans le sandbox aux côtés de vos dépôts
Disponibilité
Claude API
- Statut
- Bêta
- API
- Managed Agents
- En-tête bêta
- Nécessite
- Modèles
- Tous les modèles
Claude Platform on AWS
- Statut
- Bêta
- API
- Managed Agents
- En-tête bêta
- Nécessite
- Modèles
- Tous les modèles
Claude Models on Google Cloud (Anthropic managed)
- Statut
- Bêta
- API
- Managed Agents
- En-tête bêta
- Nécessite
- Modèles
- Tous les modèles
Traitement des données
Présentation du traitement des donnéesPoints de terminaison concernés
/v1/agents/v1/sessions/v1/environments
Non éligible à la ZDR, sauf pour Managed Agents auto-hébergé. Les sessions sont des ressources avec état ; les transcriptions persistent jusqu’à ce que vous les supprimiez. En savoir plus
Non éligible à HIPAA. S’applique à toutes les sous-fonctionnalités de Managed Agents.
Cette page vous a-t-elle été utile ?