Claude, Cursor und mehr verbinden

Schritt-für-Schritt-Einrichtung, um Claude Code, Claude Desktop, Cursor, VS Code und MCP Inspector mit dem MCP-Server von StickyPrompts zu verbinden, dazu ein manueller Handshake mit curl und Prompts zum Testen.

Jeder MCP-Client, der entfernte Streamable-HTTP-Server mit eigenem Header unterstützt, kann sich mit StickyPrompts verbinden. Sie brauchen zwei Dinge: den Endpunkt und einen API-Schlüssel.

URL:     https://api.stickyprompts.com/mcp/
Header:  Authorization: Bearer STICKY-API-...

Behalten Sie den abschließenden Schrägstrich in der URL bei. Welche Tools Ihr Client sieht, hängt von den Berechtigungen des Schlüssels ab. Erstellen Sie für den Assistenten deshalb einen Schlüssel, der nur die nötigen Berechtigungen hat. Siehe Berechtigungsreferenz.

Bevor Sie beginnen

Schlüssel für Ihren Assistenten erstellen

Klicken Sie unter Settings > API keys auf die Schaltfläche Generate key, benennen Sie den Schlüssel nach dem Client (zum Beispiel Claude Code - Laptop) und haken Sie die Berechtigungen für die gewünschten Tools an. Kopieren Sie den Schlüssel, denn er wird nur einmal angezeigt.
In einer Umgebungsvariable ablegen
```
export STICKY_API_KEY="STICKY-API-..."
```
Konfigurationsdateien, die einen Schlüssel enthalten, gehören in Ihren Secret Store oder Ihr Home-Verzeichnis, niemals in ein gemeinsam genutztes Repository.

Claude Code

Fügen Sie den Server mit einem einzigen Befehl hinzu:

zsh

$ claude mcp add --transport http stickyprompts https://api.stickyprompts.com/mcp/ --header "Authorization: Bearer $STICKY_API_KEY"

$ claude mcp list

Ihre Shell setzt $STICKY_API_KEY beim Ausführen des Befehls ein, der Schlüssel wird also in der Konfiguration von Claude Code gespeichert. Mit claude mcp add --help legen Sie fest, wo er gespeichert wird (nur für Sie oder für ein Projekt). In einer Claude-Code-Sitzung zeigt /mcp den Verbindungsstatus des Servers und seine Tools an.

Um die Einrichtung mit einem Team zu teilen, ohne einen Schlüssel weiterzugeben, können Sie stattdessen eine projektweite .mcp.json committen, die den Schlüssel aus der Umgebung jedes Entwicklers liest (Beispiel):

{
  "mcpServers": {
    "stickyprompts": {
      "type": "http",
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${STICKY_API_KEY}"
      }
    }
  }
}

Claude Desktop und claude.ai

Benutzerdefinierte Konnektoren in Claude Desktop und claude.ai werden über eine URL hinzugefügt und melden sich per OAuth an. Der MCP-Server von StickyPrompts authentifiziert sich über einen Header mit API-Schlüssel und bietet keine OAuth-Anmeldung. Ein benutzerdefinierter Konnektor, der nur eine URL kennt, kann sich deshalb nicht mit ihm verbinden.

Was stattdessen funktioniert, ist eine lokale Brücke, die an den entfernten Server weiterleitet und den Header hinzufügt. Zum Beispiel mit mcp-remote in der claude_desktop_config.json von Claude Desktop (Beispiel, erfordert Node.js):

{
  "mcpServers": {
    "stickyprompts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.stickyprompts.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer STICKY-API-..."
      }
    }
  }
}

Wenn Sie den Wert über env übergeben, umgehen Sie Probleme, die manche Systeme mit Leerzeichen in args haben. Starten Sie Claude Desktop nach dem Bearbeiten der Datei neu.

Cursor

Tragen Sie den Server in die .cursor/mcp.json Ihres Projekts ein oder, damit er überall verfügbar ist, in die globale mcp.json in Ihrem Cursor-Einstellungsordner (Beispiel):

{
  "mcpServers": {
    "stickyprompts": {
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer STICKY-API-..."
      }
    }
  }
}

Öffnen Sie die MCP-Einstellungen von Cursor, um zu prüfen, ob der Server verbunden ist, und um seine Tools zu sehen. Wenn Sie eine Projektdatei verwenden, nehmen Sie sie in die .gitignore auf oder nutzen Sie die Syntax von Cursor für Umgebungsvariablen, damit der Schlüssel nicht committet wird.

VS Code

VS Code liest MCP-Server aus .vscode/mcp.json. Das Format verwendet einen Schlüssel servers und kann den API-Schlüssel abfragen, statt ihn zu speichern (Beispiel):

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sticky-api-key",
      "description": "StickyPrompts API key",
      "password": true
    }
  ],
  "servers": {
    "stickyprompts": {
      "type": "http",
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:sticky-api-key}"
      }
    }
  }
}

Starten Sie den Server aus der Datei oder aus der Ansicht der MCP-Server, geben Sie auf Nachfrage Ihren Schlüssel ein, und die StickyPrompts-Tools erscheinen in der Tool-Auswahl des Agent-Modus.

Andere Clients

Für jeden Client, der entfernte HTTP-Server mit Headern unterstützt, sieht die allgemeine Form so aus (Beispiel; die Schlüsselnamen unterscheiden sich je nach Client leicht, etwa type oder transport):

{
  "mcpServers": {
    "stickyprompts": {
      "type": "http",
      "url": "https://api.stickyprompts.com/mcp/",
      "headers": {
        "Authorization": "Bearer STICKY-API-..."
      }
    }
  }
}

Clients, die nur stdio sprechen, können die Brücke mcp-remote aus dem Abschnitt zu Claude Desktop verwenden.

MCP Inspector

Mit MCP Inspector sehen Sie am schnellsten, welche Tools Ihr Schlüssel genau freigibt, und können sie von Hand aufrufen.

zsh

$ npx @modelcontextprotocol/inspector

Wählen Sie im Inspector den Transport Streamable HTTP, geben Sie https://api.stickyprompts.com/mcp/ ein, fügen Sie einen Header Authorization mit Bearer STICKY-API-... hinzu und verbinden Sie sich. List Tools zeigt die Tools, die die Berechtigungen Ihres Schlüssels erlauben.

Manueller Handshake mit curl

Das Protokoll von Hand zu sprechen, hilft bei der Fehlersuche. Initialisieren Sie zuerst eine Sitzung und notieren Sie den Response-Header Mcp-Session-Id:

curl -i https://api.stickyprompts.com/mcp/ \
  -H "Authorization: Bearer $STICKY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

Die Antwort meldet den Server als StickyPrompts 1.0.0 mit der Fähigkeit tools und enthält einen Header wie Mcp-Session-Id: mcp-session-<uuid>. Listen Sie dann die Tools auf und senden Sie dabei diese Sitzungs-ID mit:

curl https://api.stickyprompts.com/mcp/ \
  -H "Authorization: Bearer $STICKY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: mcp-session-..." \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Und rufen Sie eines auf:

curl https://api.stickyprompts.com/mcp/ \
  -H "Authorization: Bearer $STICKY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: mcp-session-..." \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_agents","arguments":{}}}'

Das Feld content[0].text im Ergebnis ist ein JSON-String, zum Beispiel {"agents":[{"id":3,"name":"Support Triage","slug":"...","tag":"support-triage"}]}.

Testen

Probieren Sie nach dem Verbinden Prompts wie diese in Ihrem Client aus. Jeder braucht die angegebene Berechtigung.

Fragen Sie zum Beispiel	Verwendetes Tool	Berechtigung
„Liste meine StickyPrompts-Agenten auf.“	`list_agents`	`agents_get`
„Durchsuche meine Wissensdatenbank nach unserer Erstattungsrichtlinie.“	`list_knowledge_bases`, `search_knowledge_base`	`knowledge_bases_get`
„Welche KI-Modelle kann ich in StickyPrompts nutzen?“	`list_ai_models`	`ai_models_get`
„Zeige meine letzten fünf Unterhaltungen in StickyPrompts.“	`list_conversations`	`conversations_get`
„Führe meinen Prompt Renewal Check-in Email für Bluebird Market aus.“	`get_prompt`, `run_prompt`	`prompts_get`, `run_prompt`
„Welche Pipedrive-Deals stehen auf Proposal Made?“	`list_crm_connections`, `search_crm_deals`	`integration_crm_get`
„Welche Tabellen enthält die Einzelhandelsdatenbank von Northwind?“	`list_database_connections`, `list_database_tables`	`integration_database_get`

Fehlerbehebung

Symptom	Wahrscheinliche Ursache
`401 {"error":"unauthorized"}`	Der Header fehlt oder hat nicht die Form `Bearer STICKY-API-...`.
`401 {"error":"Invalid API key"}`	Der Schlüssel ist falsch eingegeben, abgeschnitten oder gelöscht.
Verbunden, aber keine Tools oder ein Tool fehlt	Dem Schlüssel fehlt die Berechtigung für dieses Tool. Bearbeiten Sie den Schlüssel unter Settings > API keys.
`tool '<name>' not found`	Wie oben: Ein Tool ohne Berechtigung sieht genauso aus wie eines, das es nicht gibt.
Der Client kann sich nicht mit `/mcp` verbinden	Verwenden Sie `/mcp/` mit abschließendem Schrägstrich. Manche Clients folgen der Umleitung nicht.
Lange Aufrufe laufen in ein Timeout	Musik, Sprache, Transkription und langsame Modelle können eine Weile dauern. Erhöhen Sie das Request-Timeout Ihres Clients.

Wie Sitzungen, Ergebnisse und Fehler funktionieren, lesen Sie unter MCP im Überblick. Die Argumente jedes Tools finden Sie in der Tool-Referenz.