Connectez GitHub à votre agent IA

Méthodes d’authentification

• OAuth 2.0
• Clé API

Ouvrez la console locale, sélectionnez un fournisseur et configurez ses identifiants. Les fournisseurs OAuth nécessitent une application OAuth que vous enregistrez auprès du service.

Points à vérifier pour ce connecteur

Cet exemple lit le profil de l’utilisateur GitHub authentifié. Vérifiez qu’il s’agit du bon compte. Sa réussite ne valide pas les droits sur les dépôts ni les autres Actions GitHub.

Vérifier l’Action avant de l’appeler

Objectif de l’exemple

Lire le profil de l’utilisateur GitHub connecté.

Autorisations requises par l’Action

• read:user
• user:email

Lisez le schéma de votre instance en cours d’exécution. Vérifiez les paramètres requis, les autorisations et le compte connecté avant l’appel.

curl -s http://localhost:3000/v1/actions/github.get_current_user

Une fois le compte connecté, adaptez les paramètres à vos ressources. Ajoutez un Bearer Token du runtime si son authentification est activée.

curl -s -X POST \
  http://localhost:3000/v1/actions/github.get_current_user \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

Lire le résultat

Les réponses HTTP du runtime contiennent success, message, data et meta. Vérifiez success et le schéma de sortie de l’Action, pas seulement le statut HTTP. Si les métadonnées contiennent executionId, utilisez-le pour retrouver le journal expurgé correspondant. L’exemple ci-dessous illustre le format ; ce n’est pas un résultat d’appel réel.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

En cas d’échec

• Pour une erreur d’authentification, vérifiez l’endpoint et le type d’identifiant : l’accès administrateur protège /api, le jeton Bearer runtime autorise /v1 et /mcp. Une clé API fournisseur ne remplace pas le jeton runtime.
• Pour un refus d’accès, vérifiez les scopes requis, les règles d’Actions et les autorisations de connexion. Un jeton valide peut ne pas être autorisé à utiliser le compte choisi.
• Si le résultat est vide ou incomplet, vérifiez le compte connecté et ses droits sur la ressource. Une autorisation réussie ne donne pas accès à tous les espaces, canaux ou documents.
• Consultez l’erreur et le journal avant de réessayer. Si l’Action modifie les données du fournisseur, vérifiez d’abord si elle a déjà abouti ; ne répétez pas la requête aveuglément.

Étapes suivantes

Pour les fournisseurs compatibles, OOMOL gère la configuration des applications OAuth et l’hébergement. Vous choisissez toujours le compte et approuvez ses autorisations.