Pour les développeurs et les agents

Notis pour les développeurs

Connecte ton agent à Notis avec la CLI officielle ou le serveur MCP hébergé. Installation, scopes OAuth, découverte des outils et reprise après erreur.

Quand utiliser Notis

Utilise Notis quand ton agent doit travailler avec les services connectés de l’utilisateur : retrouver un e-mail, consulter un agenda, mettre à jour un projet, ou garder une mémoire et des notes partagées. Découvre les outils disponibles pour la tâche, inspecte leurs schémas et n’exécute que ce que l’utilisateur a demandé.

Choisis la CLI pour les agents qui peuvent lancer des commandes shell, y compris pour créer des Apps. Choisis le MCP hébergé pour les clients qui se connectent à des serveurs MCP distants sans shell. Le MCP hébergé expose les outils compatibles avec le cloud ; les capacités réservées à l’app Desktop demandent la configuration locale de Notis adaptée.

Démarrer avec la CLI

Le package officiel est @notis_ai/cli sur npm. Connecte-toi dans le navigateur, puis lance une requête de découverte :

npx --package @notis_ai/cli@latest -- notis login
npx --package @notis_ai/cli@latest -- notis doctor
npx --package @notis_ai/cli@latest -- notis tools search "find tools to read my calendar"

Utilise le nom d’outil renvoyé par la découverte. Inspecte son schéma avant de préparer les arguments, et valide une écriture avant de l’exécuter :

npx --package @notis_ai/cli@latest -- notis tools describe <DISCOVERED_TOOL>
npx --package @notis_ai/cli@latest -- notis tools exec <DISCOVERED_TOOL> --dry-run --arguments '<JSON_ARGUMENTS>'
npx --package @notis_ai/cli@latest -- notis tools exec <DISCOVERED_TOOL> --arguments '<JSON_ARGUMENTS>'

Les valeurs entre chevrons sont des emplacements à remplir, pas des commandes littérales. Un dry run valide la requête ; il ne garantit pas le succès côté fournisseur et n’autorise pas une écriture. Commence par la découverte et les lectures avant toute modification autorisée. Utilise --json pour une sortie CLI structurée, et --help pour les options à jour de chaque commande.

Se connecter via MCP

Ajoute cette URL de serveur distant dans les paramètres de connexion de ton client MCP, puis termine la connexion et le consentement Notis :

https://mcp.notis.ai/mcp

Notis utilise le Streamable HTTP sans état, pas un ancien endpoint SSE. Un GET depuis le navigateur ne teste pas la connexion. Le client MCP initialise la connexion en POST et utilise la découverte standard des outils et des ressources. Les schémas d’outils à l’exécution font foi : passe par la découverte et la consultation des schémas plutôt que par une liste enregistrée d’opérations d’intégration.

Consulte les guides de configuration des agents Notis pour les instructions propres à chaque client.

OAuth et accès au strict nécessaire

Notis utilise OAuth avec code d’autorisation, PKCE S256 et des autorisations révocables. L’émetteur de production est https://mcp.notis.ai. Les tokens MCP ciblent https://mcp.notis.ai/mcp ; les identifiants CLI ciblent https://api.notis.ai/cli. Ces audiences ne sont pas interchangeables. L’audience CLI sert à la CLI officielle, pas à une API REST générique pour des clients tiers.

Utilise les métadonnées propres à chaque ressource ci-dessous pour ne demander que les scopes dont ta tâche a besoin. Les scopes sont des permissions par capacité, pas des filtres par fournisseur ou par enregistrement. Ajouter des permissions demande un nouveau consentement de l’utilisateur.

Scope	Permission	Interface
`notis:read`	Découverte, consultation des schémas, validation, ressources de guide et exécution en lecture seule.	CLI et MCP
`notis:write`	Modifications classées comme telles par le serveur, dans la limite des comptes connectés et des permissions de l’utilisateur.	CLI et MCP
`notis:connections`	Création de liens d’autorisation pour que l’utilisateur connecte un service pris en charge.	CLI et MCP
`notis:apps`	Création et publication de Notis Apps via la ressource CLI officielle.	CLI uniquement

Serveur d’autorisation OAuth de Notis : Émetteur et endpoints d’autorisation, de token, d’enregistrement et de révocation, lisibles par une machine.
Métadonnées de la ressource MCP de Notis : L’audience exacte de la ressource MCP et les scopes OAuth pris en charge.
Métadonnées de la ressource CLI de Notis : Ressource CLI officielle, scopes et canal de publication.

Erreurs et nouvelles tentatives

Lis la réponse structurée en plus du statut HTTP. Les erreurs OAuth utilisent les champs JSON OAuth comme error et error_description. Les erreurs de protocole MCP et les échecs d’outils suivent la sémantique MCP/JSON-RPC : un échec d’outil peut arriver dans une réponse HTTP 200 avec isError. Les erreurs d’outils Notis incluent un code, un message, des pistes de reprise et un identifiant de requête, et peuvent indiquer si l’erreur peut être retentée. Les erreurs JSON de la CLI incluent aussi des codes et des pistes structurés.

Erreurs d’authentification ou de scope : reconnecte-toi ou demande la permission manquante via le consentement. Réessayer en boucle n’ajoutera pas d’accès.
Limitation de débit : respecte Retry-After quand il est fourni. L’enregistrement et l’admission d’autorisation OAuth le renvoient avec les réponses de limitation. Les limites des fournisseurs varient ; il n’existe pas de quota universel annoncé de requêtes par minute.
Écritures incertaines : ne répète pas une modification à l’aveugle après un timeout. Vérifie son résultat et utilise l’idempotence de l’interface quand elle existe.
Échecs persistants : garde l’identifiant de requête pour le support, sans partager de tokens ni de données privées.

Versions et compatibilité

Les clients MCP négocient une version du protocole à l’initialisation. Le serveur implémente actuellement MCP 2025-11-25. Utilise le point d’entrée @latest de la CLI publiée et inspecte les schémas à l’exécution ; ne traite pas un inventaire OpenAPI généré par le backend comme un contrat REST public pris en charge.

Notis ne publie pas encore de délai de préavis fixe avant dépréciation ni de politique universelle d’en-tête Sunset pour ces interfaces. Suis le changelog pour les évolutions du produit.

Comptes et tests

Le forfait gratuit inclut l’accès à la CLI et au MCP. La connexion et le branchement des services sont en libre-service : aucune clé d’API ni aucun appel commercial n’est nécessaire pour cette configuration. La disponibilité des outils, les permissions des fournisseurs, les droits du forfait et la facturation à l’usage s’appliquent quand même. Aucun sandbox public séparé n’est proposé ici : les appels autorisés agissent sur le compte connecté.

Lire le site en Markdown

Demande la même URL de contenu public avec Accept: text/markdown. Les requêtes classiques du navigateur continuent de recevoir du HTML. Les réponses varient selon Accept ; les représentations de page non prises en charge renvoient 406. Les pages personnelles de résultat ou de partage, les API et les fichiers statiques sont hors de cette négociation.

curl -i -H 'Accept: text/markdown' https://www.notis.ai/developers/

Utilise l’index du site pour les agents et le sitemap pour trouver les pages. Les chemins de contenu inconnus renvoient une vraie 404, avec des liens de secours dans leur version Markdown.