Connectez Notion à 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

Cette recherche renvoie le contenu accessible à la connexion Notion. Un titre correspondant ne rend pas une page non partagée accessible. Vérifiez le partage de la ressource avant de considérer un résultat vide comme une erreur.

Vérifier l’Action avant de l’appeler

Objectif de l’exemple

Rechercher des pages et sources de données Notion. Seul le contenu accessible à la connexion peut être renvoyé.

Autorisations requises par l’Action

• read_content

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/notion.search

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/notion.search \
  -H 'content-type: application/json' \
  -d '{"input":{"query":"OpenConnector","pageSize":5}}'

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.