Claude, Cursor és más kliensek csatlakoztatása

Lépésenkénti útmutató a Claude Code, a Claude Desktop, a Cursor, a VS Code és az MCP Inspector csatlakoztatásához a StickyPrompts MCP-szerveréhez, egy nyers curl-kézfogással és tesztpromptokkal kiegészítve.

Minden olyan MCP-kliens csatlakozhat a StickyPrompts MCP-szerveréhez, amely támogatja a távoli, egyéni headerrel használható Streamable HTTP-szervereket. Két dologra van szükséged: a végpontra és egy API-kulcsra.

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

Az URL végéről ne hagyd le a záró perjelet. Hogy a kliensed mely eszközöket látja, az a kulcs jogosultságaitól függ, ezért az asszisztensnek olyan kulcsot hozz létre, amely csak a szükséges jogosultságokat kapja meg - lásd: Jogosultságok referenciája.

Mielőtt elkezded

Hozz létre kulcsot az asszisztensednek

A Settings > API keys oldalon kattints a Generate key gombra, nevezd el a kulcsot a kliensről (például Claude Code - laptop), és jelöld be a használni kívánt eszközökhöz tartozó jogosultságokat. Másold ki a kulcsot, mert csak egyszer jelenik meg.
Tedd környezeti változóba
```
export STICKY_API_KEY="STICKY-API-..."
```
A kulcsot tartalmazó konfigurációs fájlok helye a titokkezelőd vagy a saját felhasználói (home) könyvtárad, soha nem egy megosztott repository.

Claude Code

Add hozzá a szervert egyetlen paranccsal:

zsh

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

$ claude mcp list

A shelled a parancs futtatásakor behelyettesíti a $STICKY_API_KEY értékét, így maga a kulcs kerül a Claude Code konfigurációjába. A claude mcp add --help paranccsal megnézheted, hová mentheted a beállítást (csak magadnak vagy egy projekthez). Egy Claude Code-munkamenetben a /mcp parancs mutatja a szerver kapcsolati állapotát és az eszközeit.

Ha a beállítást úgy szeretnéd megosztani a csapattal, hogy közben kulcsot nem osztasz meg, commitolhatsz helyette egy projektszintű .mcp.json fájlt, amely minden fejlesztő saját környezetéből olvassa ki a kulcsot (példa):

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

Claude Desktop és claude.ai

A Claude Desktop és a claude.ai egyéni connectorait (custom connectors) URL alapján lehet hozzáadni, és OAuth-tal jelentkeznek be. A StickyPrompts MCP-szervere API-kulcsos headerrel hitelesít, OAuth-bejelentkezése nincs, ezért egy csak URL-lel megadott egyéni connector nem tud csatlakozni hozzá.

Helyette egy helyi híd működik, amely továbbítja a kéréseket a távoli szerverre, és hozzáadja a headert. Például az mcp-remote csomaggal, a Claude Desktop claude_desktop_config.json fájljában (példa; Node.js kell hozzá):

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

Ha az értéket az env mezőn keresztül adod át, elkerülöd azokat a problémákat, amelyeket egyes rendszerekben az args értékein belüli szóközök okoznak. A fájl szerkesztése után indítsd újra a Claude Desktopot.

Cursor

Add hozzá a szervert a projekted .cursor/mcp.json fájljához, vagy ha mindenhol használni szeretnéd, a Cursor beállításmappájában lévő globális mcp.json fájlhoz (példa):

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

A Cursor MCP-beállításaiban ellenőrizheted, hogy a szerver csatlakozott-e, és megnézheted az eszközeit. Ha projektfájlt használsz, vedd fel a .gitignore fájlba, vagy használd a Cursor környezetiváltozó-szintaxisát, hogy a kulcs ne kerüljön be egy commitba.

VS Code

A VS Code a .vscode/mcp.json fájlból olvassa be az MCP-szervereket. Ez a formátum servers kulcsot használ, és a kulcs tárolása helyett be is kérheti azt (példa):

{
  "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}"
      }
    }
  }
}

Indítsd el a szervert a fájlból vagy az MCP-szerverek nézetéből, add meg a kulcsodat, amikor a VS Code kéri, és a StickyPrompts eszközei megjelennek az agent mód eszközválasztójában.

Egyéb kliensek

Minden olyan kliensnél, amely támogatja a headerrel használható távoli HTTP-szervereket, az általános forma a következő (példa; a beállításkulcsok neve kliensenként kissé eltér, például type vagy transport):

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

A csak stdio-t ismerő kliensek a Claude Desktopnál bemutatott mcp-remote hidat használhatják.

MCP Inspector

Az MCP Inspector segítségével a leggyorsabban láthatod, pontosan mely eszközöket teszi elérhetővé a kulcsod, és kézzel is meghívhatod őket.

zsh

$ npx @modelcontextprotocol/inspector

Az Inspectorban válaszd a Streamable HTTP átviteli módot, add meg a https://api.stickyprompts.com/mcp/ címet, adj hozzá egy Authorization headert Bearer STICKY-API-... értékkel, majd csatlakozz. A List Tools gombbal megnézheted, mely eszközöket engedélyezik a kulcsod jogosultságai.

Nyers kézfogás curllel

Hibakereséskor hasznos, ha kézzel kommunikálsz a protokollon. Először inicializálj egy munkamenetet, és jegyezd fel a válasz Mcp-Session-Id headerét:

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"}}}'

A válaszban a szerver StickyPrompts 1.0.0 néven, tools képességgel jelentkezik, és egy Mcp-Session-Id: mcp-session-<uuid> formájú headert is visszaad. Ezután listázd az eszközöket, és küldd el a munkamenet-azonosítót:

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"}'

Végül hívj meg egy eszközt:

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":{}}}'

Az eredmény content[0].text mezője egy JSON-string, például {"agents":[{"id":3,"name":"Support Triage","slug":"...","tag":"support-triage"}]}.

Próbáld ki

Csatlakozás után próbálj ki ilyen promptokat a kliensedben. Mindegyikhez a feltüntetett jogosultság kell.

Kérdezd meg például	A használt eszköz	Jogosultság
„Listázd a StickyPrompts-ügynökeimet.”	`list_agents`	`agents_get`
„Keresd meg a tudásbázisomban a visszatérítési szabályzatunkat.”	`list_knowledge_bases`, `search_knowledge_base`	`knowledge_bases_get`
„Milyen AI-modelleket használhatok a StickyPromptsban?”	`list_ai_models`	`ai_models_get`
„Mutasd az utolsó öt StickyPrompts-beszélgetésemet.”	`list_conversations`	`conversations_get`
„Futtasd a Renewal Check-in Email promptomat a Bluebird Market ügyfélre.”	`get_prompt`, `run_prompt`	`prompts_get`, `run_prompt`
„Mely Pipedrive-üzletek vannak a Proposal Made fázisban?”	`list_crm_connections`, `search_crm_deals`	`integration_crm_get`
„Milyen táblák vannak a Northwind kiskereskedelmi adatbázisában?”	`list_database_connections`, `list_database_tables`	`integration_database_get`

Hibaelhárítás

Tünet	Valószínű ok
`401 {"error":"unauthorized"}`	Hiányzik a header, vagy nem `Bearer STICKY-API-...` formájú.
`401 {"error":"Invalid API key"}`	A kulcs el van gépelve, csonka, vagy törölték.
A kliens csatlakozik, de nincsenek eszközök, vagy hiányzik egy eszköz	A kulcsból hiányzik az adott eszközhöz tartozó jogosultság. Szerkeszd a kulcsot a Settings > API keys oldalon.
`tool '<name>' not found`	Ugyanaz, mint fent: a jogosultság nélküli eszköz pontosan úgy néz ki, mint egy nem létező.
A kliens nem tud csatlakozni a `/mcp` címhez	Használd a `/mcp/` címet, záró perjellel; egyes kliensek nem követik az átirányítást.
A hosszú hívások túllépik az időkorlátot	A zene- és beszédgenerálás, a hangátírás és a lassú modellek eltarthatnak egy ideig. Növeld a kliensed kérési időkorlátját.

A munkamenetek, az eredmények és a hibák működéséről Az MCP áttekintése oldalon olvashatsz, az egyes eszközök argumentumairól pedig az Eszközreferencia oldalon.