Connetti Claude, Cursor e altri client

Istruzioni passo passo per connettere Claude Code, Claude Desktop, Cursor, VS Code e MCP Inspector al server MCP di StickyPrompts, più un handshake con curl e alcuni prompt per provarlo.

Qualsiasi client MCP che supporti server remoti Streamable HTTP con un header personalizzato può connettersi a StickyPrompts. Ti servono due cose: l’endpoint e una chiave API.

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

Mantieni la barra finale nell’URL. Gli strumenti che il tuo client vede dipendono dalle autorizzazioni della chiave, quindi crea per l’assistente una chiave con le sole autorizzazioni di cui ha bisogno (consulta il Riferimento delle autorizzazioni).

Prima di iniziare

Crea una chiave per il tuo assistente

In Settings > API keys seleziona Generate key, dalle il nome del client (per esempio Claude Code - laptop) e spunta le autorizzazioni per gli strumenti che vuoi. Copia la chiave: viene mostrata una sola volta.
Salvala in una variabile d'ambiente
```
export STICKY_API_KEY="STICKY-API-..."
```
I file di configurazione che contengono una chiave vanno nel tuo archivio di segreti o nella tua home directory, mai in un repository condiviso.

Claude Code

Aggiungi il server con un solo comando:

zsh

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

$ claude mcp list

La shell espande $STICKY_API_KEY quando esegui il comando, quindi la chiave viene salvata nella configurazione di Claude Code. Esegui claude mcp add --help per scegliere dove salvarla (solo per te o per un progetto). In una sessione di Claude Code, /mcp mostra lo stato della connessione del server e i suoi strumenti.

Per condividere la configurazione con un team senza condividere una chiave, puoi invece fare commit di un file .mcp.json di progetto che legge la chiave dall’ambiente di ciascuno sviluppatore (esempio):

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

Claude Desktop e claude.ai

In Claude Desktop e claude.ai i connettori personalizzati si aggiungono tramite URL e l’accesso avviene con OAuth. Il server MCP di StickyPrompts si autentica con un header contenente la chiave API e non prevede un accesso OAuth, quindi un connettore personalizzato basato solo sull’URL non può connettersi.

Funziona invece un bridge locale che inoltra le richieste al server remoto aggiungendo l’header. Per esempio, con mcp-remote nel file claude_desktop_config.json di Claude Desktop (esempio; richiede Node.js):

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

Passare il valore tramite env evita i problemi che alcuni sistemi hanno con gli spazi all’interno di args. Dopo aver modificato il file, riavvia Claude Desktop.

Cursor

Aggiungi il server a .cursor/mcp.json nel tuo progetto, oppure al file globale mcp.json nella cartella delle impostazioni di Cursor per usarlo ovunque (esempio):

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

Apri le impostazioni MCP di Cursor per verificare che il server sia connesso e vederne gli strumenti. Se usi un file di progetto, aggiungilo a .gitignore oppure usa la sintassi di Cursor per le variabili d’ambiente, così la chiave non finisce in un commit.

VS Code

VS Code legge i server MCP da .vscode/mcp.json. Il suo formato usa una chiave servers e può chiederti la chiave API invece di salvarla (esempio):

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

Avvia il server dal file o dalla vista dei server MCP, inserisci la chiave quando richiesto e gli strumenti di StickyPrompts compariranno nel selettore degli strumenti della modalità agente.

Altri client

Per qualsiasi client che supporti server HTTP remoti con header, la struttura generica è questa (esempio; i nomi delle chiavi variano leggermente da un client all’altro, per esempio type o transport):

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

I client che supportano solo stdio possono usare il bridge mcp-remote mostrato nella sezione su Claude Desktop.

MCP Inspector

MCP Inspector è il modo più rapido per vedere esattamente quali strumenti espone la tua chiave e chiamarli a mano.

zsh

$ npx @modelcontextprotocol/inspector

Nell’Inspector scegli il trasporto Streamable HTTP, inserisci https://api.stickyprompts.com/mcp/, aggiungi un header Authorization con Bearer STICKY-API-... e connettiti. List Tools mostra gli strumenti consentiti dalle autorizzazioni della tua chiave.

Handshake manuale con curl

Implementare il protocollo a mano è utile per il debug. Per prima cosa inizializza una sessione e annota l’header di risposta 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"}}}'

La risposta identifica il server come StickyPrompts 1.0.0 con la capability tools, e contiene un header come Mcp-Session-Id: mcp-session-<uuid>. Poi elenca gli strumenti, inviando quell’id di sessione:

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

E chiamane uno:

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

Il campo content[0].text del risultato è una stringa JSON, per esempio {"agents":[{"id":3,"name":"Support Triage","slug":"...","tag":"support-triage"}]}.

Provalo

Una volta connesso, prova nel tuo client prompt come questi. Ognuno richiede l’autorizzazione indicata.

Prova a chiedere	Strumento usato	Autorizzazione
«Elenca i miei agenti di StickyPrompts.»	`list_agents`	`agents_get`
«Cerca nella mia knowledge base la nostra policy di rimborso.»	`list_knowledge_bases`, `search_knowledge_base`	`knowledge_bases_get`
«Quali modelli di IA posso usare in StickyPrompts?»	`list_ai_models`	`ai_models_get`
«Mostrami le mie ultime cinque conversazioni di StickyPrompts.»	`list_conversations`	`conversations_get`
«Esegui il mio prompt Renewal Check-in Email per Bluebird Market.»	`get_prompt`, `run_prompt`	`prompts_get`, `run_prompt`
«Quali trattative di Pipedrive sono in Proposal Made?»	`list_crm_connections`, `search_crm_deals`	`integration_crm_get`
«Quali tabelle ci sono nel database retail di Northwind?»	`list_database_connections`, `list_database_tables`	`integration_database_get`

Risoluzione dei problemi

Sintomo	Causa probabile
`401 {"error":"unauthorized"}`	L’header manca o non ha la forma `Bearer STICKY-API-...`.
`401 {"error":"Invalid API key"}`	La chiave è stata digitata male, troncata o eliminata.
Connesso, ma nessuno strumento visibile o ne manca uno	Alla chiave manca l’autorizzazione per quello strumento. Modifica la chiave in Settings > API keys.
`tool '<name>' not found`	Come sopra: uno strumento senza autorizzazione appare esattamente come uno che non esiste.
Il client non riesce a connettersi a `/mcp`	Usa `/mcp/` con la barra finale; alcuni client non seguono il redirect.
Le chiamate lunghe vanno in timeout	Musica, sintesi vocale, trascrizione e modelli lenti possono richiedere tempo. Aumenta il timeout delle richieste del tuo client.

Consulta Panoramica di MCP per capire come funzionano sessioni, risultati ed errori, e il riferimento degli strumenti per gli argomenti di ogni strumento.