Vue d'ensemble pour les développeurs
Utilisez l'API REST et le serveur MCP de StickyPrompts pour automatiser votre travail, créer des outils internes et retrouver votre espace de travail dans Claude, Cursor et d'autres clients MCP. Une seule clé API sert aux deux.
Tout ce que votre équipe construit dans StickyPrompts (prompts, agents, bases de connaissances, workflows, CRM et bases de données connectés) est aussi accessible depuis votre propre code. Appelez-le via une API REST en JSON, tout simplement, ou connectez un client MCP et laissez un assistant IA s’en servir comme d’un ensemble d’outils. Les deux reposent sur le même moteur que l’application web : les mêmes modèles, garde-fous et règles d’accès s’appliquent.
Ce que vous pouvez créer
Exécutez un prompt enregistré sur chaque nouveau ticket de support, traitez une feuille de calcul ligne par ligne ou lancez un workflow depuis votre propre planificateur.
Placez derrière un formulaire, un chatbot ou un panneau d’administration les modèles et les agents que votre espace de travail autorise déjà.
Connectez Claude Code, Cursor ou VS Code via MCP, puis demandez « la politique de remboursement de Northwind » ou « rédige une relance pour cette affaire ».
REST ou MCP ?
| API REST | Serveur MCP | |
|---|---|---|
| URL de base | https://api.stickyprompts.com/api/v1 | https://api.stickyprompts.com/mcp/ (conservez la barre oblique finale) |
| Idéal pour | Votre propre code : backends, scripts, tâches planifiées | Les clients IA qui parlent le Model Context Protocol |
| Structure | Endpoints par ressource (GET /conversation, POST /run, …) | Outils (send_message, search_knowledge_base, send_email, …) |
| Couverture | La plus large : créer et gérer prompts, agents, workflows, fichiers, projets, équipes et médias | Un ensemble ciblé d’outils pour lire, exécuter et agir |
| Authentification | Authorization: Bearer STICKY-API-... | Le même header et la même clé |
Choisissez REST quand c’est votre code qui décide de ce qui se passe. Choisissez MCP quand vous voulez qu’un modèle décide de l’outil à appeler. Beaucoup d’équipes utilisent les deux avec une seule clé : MCP dans l’éditeur, REST pour les tâches en production.
Certaines fonctions n’existent que d’un côté. La recherche sémantique dans une base de connaissances est un outil MCP (search_knowledge_base) sans équivalent REST. À l’inverse, le téléversement de fichiers passe uniquement par REST : le serveur MCP peut importer des fichiers depuis Google Drive avec import_storage_files, mais il ne propose aucun outil de téléversement.
Une seule clé pour les deux
Vous créez vous-même vos clés API dans Settings > API keys. Chaque clé a un nom et un ensemble d’autorisations, et la clé complète ne s’affiche qu’une seule fois. La même clé authentifie les appels REST et les sessions MCP :
Authorization: Bearer STICKY-API-<64 characters>
Tous les détails figurent dans Clés API et authentification.
Une clé agit en votre nom, dans la limite de ses autorisations
Une clé n’est pas un compte de service distinct. Elle agit en tant que l’utilisateur qui l’a créée : elle voit votre espace de travail, vos projets et tout ce qui a été partagé avec vous, rien de plus. Ses autorisations restreignent ensuite ce périmètre. Une clé qui ne possède que knowledge_bases_get peut lire les bases de connaissances que vous pouvez lire, mais n’a aucun accès à vos conversations.
- Il n’existe pas de clé propre à un espace de travail ou à un projet. Vous définissez le périmètre d’une clé en choisissant ses autorisations.
- Les règles de l’espace de travail s’appliquent toujours, à chaque appel : l’accès aux modèles, la résidence des données et les garde-fous se comportent exactement comme dans l’application.
- Via MCP, un outil pour lequel votre clé n’a pas d’autorisation n’apparaît tout simplement pas dans la liste des outils.
La liste complète se trouve dans la référence des autorisations.
L’utilisation est comptée comme dans l’application
Les appels API et MCP passent par le même circuit d’exécution, de quotas et de facturation que l’application web. L’utilisation est attribuée au propriétaire de la clé et à son espace de travail, comme n’importe quelle autre utilisation, et consomme les mêmes crédits. Il n’existe pas de grille tarifaire distincte pour l’API. Lorsque l’espace de travail a épuisé son quota, les appels REST qui lancent un travail payant renvoient 429 Quota exceeded (voir Erreurs, pagination et quotas).
Pas de webhooks : interrogez le statut
L’API n’envoie pas de webhooks. La plupart des appels sont synchrones et renvoient le résultat final. Pour les traitements longs (vidéo, synthèse vocale, musique et transcription via REST, traitement de feuilles de calcul, exécutions de workflows), vous lancez la tâche puis interrogez son statut à intervalles réguliers. Une conversation démarrée avec l’endpoint de streaming peut être suivie en direct sur son WebSocket : chaque trame contient l’intégralité du message généré jusque-là.
Commencer ici
Créez une clé et effectuez vos premiers appels en cinq minutes.
Clés API et authentificationFormat des clés, header bearer, réponses d’erreur et bonnes pratiques de sécurité.
Référence des autorisationsChaque autorisation, ce qu’elle débloque et celles qui fonctionnent via MCP.
Erreurs, pagination et quotasCorps d’erreur, codes de statut, headers de pagination et réponses liées aux quotas.
Serveur MCP
Transport, sessions, autorisations et forme des résultats.
Connecter votre clientClaude Code, Cursor, VS Code, MCP Inspector et curl en direct.
Référence des outilsChaque outil, avec ses arguments et l’autorisation requise.
Référence de l’API REST
Démarrez des chats, envoyez des messages, suivez les réponses en direct.
Prompts et exécutionsPrompts enregistrés, variables et exécutions ponctuelles.
Agents et workflowsAgents, workflows planifiés et exécutions manuelles.
Fichiers, projets et connaissancesTéléversements, projets, bases de connaissances et équipes.
Modèles et médiasLe catalogue des modèles, les images, la vidéo, la synthèse vocale, la musique et la transcription.
IntégrationsE-mail, CRM, bases de données et Google Drive.