Überblick für Entwickler
Mit der REST-API und dem MCP-Server von StickyPrompts automatisieren Sie Arbeit, bauen interne Tools und holen Ihren Workspace in Claude, Cursor und andere MCP-Clients. Ein einziger API-Schlüssel funktioniert für beides.
Alles, was Ihr Team in StickyPrompts aufbaut, steht auch Ihrem eigenen Code zur Verfügung: Prompts, Agenten, Wissensdatenbanken, Workflows sowie verbundene CRMs und Datenbanken. Sprechen Sie es über eine schlichte JSON-REST-API an, oder verbinden Sie einen MCP-Client und lassen Sie einen KI-Assistenten alles als Tools nutzen. Beides läuft auf derselben Engine wie die Web-App, deshalb gelten dieselben Modelle, Guardrails und Zugriffsregeln.
Was Sie bauen können
Führen Sie bei jedem neuen Support-Ticket einen gespeicherten Prompt aus, verarbeiten Sie eine Tabelle Zeile für Zeile oder starten Sie einen Workflow aus Ihrem eigenen Scheduler.
Bauen Sie ein Formular, einen Chatbot oder ein Admin-Panel um die Modelle und Agenten, die Ihr Workspace bereits freigibt.
Verbinden Sie Claude Code, Cursor oder VS Code über MCP und fragen Sie nach „der Erstattungsrichtlinie von Northwind“ oder bitten Sie: „Entwirf ein Follow-up zu diesem Deal“.
REST oder MCP?
| REST-API | MCP-Server | |
|---|---|---|
| Basis-URL | https://api.stickyprompts.com/api/v1 | https://api.stickyprompts.com/mcp/ (mit abschließendem Schrägstrich) |
| Ideal für | Ihren eigenen Code: Backends, Skripte, geplante Jobs | KI-Clients, die das Model Context Protocol sprechen |
| Aufbau | Ressourcen-Endpunkte (GET /conversation, POST /run, …) | Tools (send_message, search_knowledge_base, send_email, …) |
| Umfang | Am größten: Prompts, Agenten, Workflows, Dateien, Projekte, Teams und Medien anlegen und verwalten | Eine gezielte Auswahl an Tools zum Lesen, Ausführen und Handeln |
| Authentifizierung | Authorization: Bearer STICKY-API-... | Derselbe Header und derselbe Schlüssel |
Wählen Sie REST, wenn Ihr Code entscheidet, was passiert. Wählen Sie MCP, wenn ein Modell entscheiden soll, welches Tool es aufruft. Viele Teams nutzen beides mit einem einzigen Schlüssel: MCP im Editor, REST in produktiven Jobs.
Einiges gibt es nur auf einer Seite. Die semantische Suche in einer Wissensdatenbank ist ein MCP-Tool (search_knowledge_base) ohne REST-Gegenstück. Dateien hochladen können Sie nur per REST: Der MCP-Server kann mit import_storage_files Dateien aus Google Drive übernehmen, hat aber kein Upload-Tool.
Ein Schlüssel für beides
API-Schlüssel erstellen Sie selbst unter Settings > API keys. Jeder Schlüssel hat einen Namen und eine Reihe von Berechtigungen, und der vollständige Schlüssel wird nur ein einziges Mal angezeigt. Derselbe Schlüssel authentifiziert REST-Aufrufe und MCP-Sitzungen:
Authorization: Bearer STICKY-API-<64 characters>
Die Details finden Sie unter API-Schlüssel und Authentifizierung.
Ein Schlüssel handelt als Sie, eingeschränkt durch seine Berechtigungen
Ein Schlüssel ist kein eigenes Dienstkonto. Er handelt als der Benutzer, der ihn erstellt hat: Er sieht Ihren Workspace, Ihre Projekte und alles, was mit Ihnen geteilt wurde, und nichts darüber hinaus. Seine Berechtigungen schränken das weiter ein. Ein Schlüssel, der nur knowledge_bases_get hat, kann die Wissensdatenbanken lesen, die Sie lesen dürfen, und hat keinen Zugriff auf Ihre Unterhaltungen.
- Es gibt keine Schlüssel pro Workspace oder pro Projekt. Den Umfang eines Schlüssels legen Sie über seine Berechtigungen fest.
- Die Regeln des Workspace gelten weiterhin für jeden Aufruf: Modellzugriff, Datenresidenz und Guardrails verhalten sich genau wie in der App.
- Über MCP taucht ein Tool, für das Ihr Schlüssel keine Berechtigung hat, gar nicht erst in der Tool-Liste auf.
Die vollständige Liste steht in der Berechtigungsreferenz.
Nutzung zählt wie in der App
API- und MCP-Aufrufe laufen über dieselbe Ausführung, dieselben Kontingente und dieselbe Abrechnung wie die Web-App. Die Nutzung wird wie jede andere dem Inhaber des Schlüssels und seinem Workspace zugerechnet und verbraucht dieselben Credits. Eine eigene API-Preisliste gibt es nicht. Ist das Kontingent des Workspace aufgebraucht, antworten REST-Aufrufe, die kostenpflichtige Arbeit starten, mit 429 Quota exceeded. Mehr dazu unter Fehler, Paginierung und Kontingente.
Keine Webhooks: Ergebnisse abfragen
Die API sendet keine Webhooks. Die meisten Aufrufe sind synchron und liefern das fertige Ergebnis zurück. Bei länger laufenden Aufgaben starten Sie den Job und fragen anschließend regelmäßig seinen Status ab. Das betrifft Video, Sprache, Musik und Transkription über REST, die Tabellenverarbeitung und Workflow-Ausführungen. Eine Unterhaltung, die Sie über den Stream-Endpunkt gestartet haben, können Sie live über ihren WebSocket verfolgen. Jeder Frame enthält dabei die vollständige Nachricht bis zu diesem Zeitpunkt.
Hier starten
Erstellen Sie einen Schlüssel und machen Sie in fünf Minuten Ihre ersten Aufrufe.
API-Schlüssel und AuthentifizierungSchlüsselformat, Bearer-Header, Fehlerantworten und sicherer Umgang mit Schlüsseln.
BerechtigungsreferenzJede Berechtigung, was sie freischaltet und welche davon über MCP funktionieren.
Fehler, Paginierung und KontingenteFehler-Bodys, Statuscodes, Paginierungs-Header und Antworten bei erschöpftem Kontingent.
MCP-Server
Transport, Sitzungen, Berechtigungen und wie Ergebnisse zurückkommen.
Claude, Cursor und mehr verbindenClaude Code, Cursor, VS Code, MCP Inspector und reines curl.
Tool-ReferenzJedes Tool mit seinen Argumenten und der erforderlichen Berechtigung.
REST-API-Referenz
Chats starten, Nachrichten senden, Antworten live verfolgen.
Prompts und AusführungenGespeicherte Prompts, Variablen und einmalige Ausführungen.
Agenten und WorkflowsAgenten, geplante Workflows und manuelle Ausführungen.
Dateien, Projekte und WissenUploads, Projekte, Wissensdatenbanken und Teams.
Modelle und MedienDer Modellkatalog, Bilder, Video, Sprache, Musik und Transkription.
IntegrationenE-Mail, CRM, Datenbanken und Google Drive.