MCP im Überblick

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem ein KI-Client Tools auf einem entfernten Server aufrufen kann. Der MCP-Server von StickyPrompts stellt Ihren Workspace als Tools bereit: eine Wissensdatenbank durchsuchen, einen gespeicherten Prompt ausführen, einen CRM-Kontakt nachschlagen, eine verbundene Datenbank abfragen, eine E-Mail senden, ein Bild generieren. Einmal verbunden, erledigt Ihr Assistent echte Arbeit, mit denselben Modellen, Daten und Regeln, die Ihr Team in der App nutzt.

Tutorial 13 von 14 · 1:48 The MCP server Video auf Englisch, in der echten App aufgenommen

Auf einen Blick

Endpunkt	https://api.stickyprompts.com/mcp/
Transport	Nur Streamable HTTP. Es gibt keinen veralteten /sse-Endpunkt und keinen stdio-Server.
Authentifizierung	Authorization: Bearer STICKY-API-..., derselbe API-Schlüssel wie für die REST-API
Fähigkeiten	Nur Tools. Keine MCP-Ressourcen, keine Ressourcenvorlagen und keine Prompts.
Servername	StickyPrompts, Version 1.0.0 (gemeldet in initialize)

Mit abschließendem Schrägstrich

Der Endpunkt lautet /mcp/, mit abschließendem Schrägstrich. Ein Request an /mcp wird auf /mcp/ umgeleitet (301 bei GET, 307 bei POST und DELETE). Die meisten Clients folgen der Umleitung. Tragen Sie trotzdem direkt https://api.stickyprompts.com/mcp/ ein: Das spart einen Umweg und funktioniert auch mit Clients, die Umleitungen nicht folgen.

Authentifizierung

Senden Sie Ihren API-Schlüssel im Header Authorization, genau wie bei REST. Schlüssel erstellen Sie unter Settings > API keys. Mehr dazu unter API-Schlüssel und Authentifizierung.

Situation	HTTP-Antwort
Kein Authorization-Header oder kein Token der Form Bearer STICKY-API-...	401 {"error":"unauthorized"}
Unbekannter Schlüssel, falsches Geheimnis oder der Inhaber des Schlüssels existiert nicht mehr	401 {"error":"Invalid API key"}
Das Konto des Schlüsselinhabers ist nicht aktiv	403 {"error":"user is not verified"}
Der Request kommt aus einer Region, die der Dienst nicht bedient	403 {"error":"access from your region is not supported"}

Für die Verbindung selbst ist keine bestimmte Berechtigung nötig. Jeder gültige Schlüssel eines aktiven Kontos kann eine Sitzung öffnen. Was er danach tun darf, wird pro Tool entschieden.

Der Schlüssel handelt als der Benutzer, der ihn erstellt hat: derselbe Workspace, dieselben Projekte, dieselben geteilten Ressourcen, eingeschränkt durch die Berechtigungen des Schlüssels. Alles, was Sie über MCP anlegen (Unterhaltungen, Projekte, generierte Dateien), gehört Ihnen und erscheint in der App.

Sitzungen

Der Server verwendet Standard-Sitzungen von Streamable HTTP. MCP-Clients erledigen das alles automatisch. Wichtig ist es nur, wenn Sie das Protokoll von Hand sprechen.

• POST /mcp/ mit einem initialize-Request liefert eine Sitzungs-ID im Response-Header Mcp-Session-Id (Format mcp-session-<uuid>).
• Jeder weitere POST muss diesen Header Mcp-Session-Id mitsenden. Fehlt die ID oder ist sie fehlerhaft, lautet die Antwort 404 Invalid session ID.
• Sitzungen sind auf dem Server zustandslos: Geprüft wird nur das Format der ID. Sie überstehen Neustarts des Servers, nach einem Deployment müssen Sie also nicht neu verbinden.
• POST erfordert Content-Type: application/json. Antworten kommen in der Praxis als JSON, weil kein Tool Fortschrittsbenachrichtigungen sendet.
• GET /mcp/ öffnet einen optionalen Benachrichtigungsstream, der meist still bleibt. DELETE /mcp/ wird akzeptiert und bewirkt nichts.

Berechtigungen bestimmen, welche Tools Sie sehen

Jedes Tool braucht genau eine Berechtigung. Der Server filtert sowohl tools/list als auch tools/call nach den Berechtigungen des Schlüssels:

• Ein Schlüssel sieht nur die Tools, für die er die Berechtigung hat. Ein Schlüssel ohne MCP-relevante Berechtigungen verbindet sich erfolgreich und sieht eine leere Tool-Liste.
• Der Aufruf eines Tools, das der Schlüssel nicht nutzen darf, liefert den JSON-RPC-Fehler -32602 mit tool '<name>' not found, also genau dasselbe wie der Aufruf eines Tools, das es nicht gibt.

Meldet Ihr Client also, dass ein StickyPrompts-Tool fehlt, prüfen Sie zuerst die Berechtigungen des Schlüssels. Die Berechtigungen mit der Markierung MCP in der Berechtigungsreferenz schalten Tools frei, und jeder Eintrag in der Tool-Referenz nennt seine Berechtigung.

Minimale Rechte sind hier noch wichtiger als sonst, denn ein KI-Client nutzt jedes Tool, das er sieht. Geben Sie einem Schlüssel für einen Assistenten nur die Tools, deren Aufruf Sie ihm ohne Bedenken überlassen. Lassen Sie schreibende Tools wie send_email oder run_database_query weg, solange Sie sie nicht brauchen.

Ergebnisse und Fehler

Jedes Tool liefert ein einziges Text-Content-Element, dessen Text ein JSON-Dokument ist. Parsen Sie den Text als JSON. Es gibt kein structuredContent und kein Ausgabeschema. Den Aufbau jedes Ergebnisses beschreibt die Tool-Referenz.

{
  "content": [
    { "type": "text", "text": "{\"conversation_id\": 5120, \"text\": \"Here are three options ...\"}" }
  ]
}

Fehler kommen auf eine von zwei Arten zurück:

Art	Sieht so aus	Verwendet für
Tool-Fehler	Ein Ergebnis mit isError: true und einer einfachen Meldung wie conversation not found	Viele Abfragen mit dem Ergebnis „nicht gefunden oder kein Zugriff“
JSON-RPC-Fehler -32603	Ein fehlgeschlagener Aufruf mit der Meldung des Servers, etwa required argument "prompt" not found	Fehlende Pflichtargumente, die meisten Validierungsfehler, Fehler bei Anbietern und Integrationen

Eingabeschemas werden Ihrem Client mitgeteilt, vom Server aber nicht validiert. Ein falscher Argumenttyp zeigt sich daher als einer der obigen Fehler und nicht als Schemafehler.

Lang laufende Tools

Die meisten Tools arbeiten synchron: Sie antworten, wenn die Arbeit erledigt ist. Einige wenige antworten sofort, und Sie müssen anschließend den Status abfragen.

Starten mit	Liefert	Status abfragen mit	Fertig, wenn
generate_video	{"id", "status"}	get_video_generation_status	status ist done oder error
start_spreadsheet_processing	{"task_id"}	get_spreadsheet_processing_task	status ist done oder error
run_workflow_task	{"execution_id", "status"}	Kein Status-Tool über MCP	Prüfen Sie danach total_run_count und success_rate mit get_workflow_task

Ein Video kann mehrere Minuten dauern. Die Beschreibung des Tools bittet das Modell, zwischen zwei Abfragen 15-60 Sekunden zu warten. generate_speech, generate_music und transcribe arbeiten synchron: Sie blockieren, bis Audio oder Transkript fertig sind. Geben Sie Ihrem Client für diese Tools ein großzügiges Request-Timeout, ebenso für send_message mit einem langsamen Modell.

Credits und Zugriffsregeln

• Tools, die echte Arbeit leisten, werden wie dieselben Aktionen in der App auf dem Konto des Schlüsselinhabers abgerechnet. Das sind send_message, run_prompt, custom_run, die Medien-Tools, search_knowledge_base, die Tabellenverarbeitung und Workflow-Ausführungen.
• Ein mit run_workflow_task gestarteter Workflow schlägt mit quota exceeded fehl, wenn das Kontingent des Inhabers erschöpft ist.
• Regeln für den Modellzugriff und Filter für die Datenresidenz greifen, sobald ein Modell aufgelöst wird. Ein Modell, das Ihr Workspace nicht erlaubt, lässt den Aufruf scheitern. list_ai_models lässt Modelle, die Sie nicht nutzen dürfen, bereits weg.

Modell auswählen

run_prompt, custom_run und start_spreadsheet_processing brauchen eine ai_model_id aus list_ai_models. Einen Wert "auto" gibt es nicht. send_message nimmt eine optionale ai_model_id entgegen. Übergeben Sie sie beim Start einer neuen Unterhaltung trotzdem immer: Ohne sie schlägt der Aufruf derzeit mit no AI model is selected, try reselecting model fehl. Die Medien-Tools nehmen kein Modellargument entgegen.

Was der MCP-Server nicht kann

• Keine Datei-Uploads. Holen Sie Dateien mit import_storage_files aus Google Drive oder laden Sie sie über die REST-API hoch.
• Keine Download-Links für beliebige Dateien. list_files und get_file liefern nur ID, Name und Typ. Medienergebnisse enthalten einen path zur gespeicherten Datei.
• Keine Ressourcen und keine Prompts. Ihre gespeicherten Prompts erreichen Sie über die Tools list_prompts, get_prompt und run_prompt.
• Kein OAuth. Clients, die entfernte Server nur über eine OAuth-Anmeldung hinzufügen können, lassen sich nicht mit einem API-Schlüssel verbinden.