Conecta Claude, Cursor y más - StickyPrompts Docs

Configuración paso a paso para conectar Claude Code, Claude Desktop, Cursor, VS Code y MCP Inspector al servidor MCP de StickyPrompts, además de un handshake manual con curl y prompts para probarlo.

Cualquier cliente MCP compatible con servidores remotos Streamable HTTP con un header personalizado puede conectarse a StickyPrompts. Necesitas dos cosas: el endpoint y una clave de API.

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

Conserva la barra final de la URL. Las herramientas que ve tu cliente dependen de los permisos de la clave, así que crea para el asistente una clave que tenga solo los permisos que necesita (consulta la Referencia de permisos).

Antes de empezar

Crea una clave para tu asistente

En Settings > API keys, selecciona Generate key, ponle el nombre del cliente (por ejemplo, Claude Code - portátil) y marca los permisos de las herramientas que quieras usar. Copia la clave; solo se muestra una vez.
Guárdala en una variable de entorno
```
export STICKY_API_KEY="STICKY-API-..."
```
Los archivos de configuración que contienen una clave deben estar en tu gestor de secretos o en tu directorio personal, nunca en un repositorio compartido.

Claude Code

Añade el servidor 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

Tu shell expande $STICKY_API_KEY al ejecutar el comando, así que la clave queda guardada en la configuración de Claude Code. Ejecuta claude mcp add --help para elegir dónde se guarda (solo para ti o para un proyecto). Dentro de una sesión de Claude Code, /mcp muestra el estado de conexión del servidor y sus herramientas.

Para compartir la configuración con un equipo sin compartir ninguna clave, puedes subir al repositorio un archivo .mcp.json de proyecto que lea la clave del entorno de cada desarrollador (ejemplo):

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

Claude Desktop y claude.ai

En Claude Desktop y claude.ai, los conectores personalizados se añaden por URL e inician sesión con OAuth. El servidor MCP de StickyPrompts se autentica con un header que lleva la clave de API y no tiene inicio de sesión OAuth, así que un conector personalizado que solo usa la URL no puede conectarse a él.

Lo que sí funciona es un puente local que reenvía las peticiones al servidor remoto y añade el header. Por ejemplo, con mcp-remote en el archivo claude_desktop_config.json de Claude Desktop (ejemplo; requiere Node.js):

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

Pasar el valor mediante env evita los problemas que tienen algunos sistemas con los espacios dentro de args. Reinicia Claude Desktop después de editar el archivo.

Cursor

Añade el servidor a .cursor/mcp.json en tu proyecto, o al mcp.json global de tu carpeta de configuración de Cursor para usarlo en todas partes (ejemplo):

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

Abre la configuración de MCP de Cursor para comprobar que el servidor está conectado y ver sus herramientas. Si usas un archivo de proyecto, añádelo a .gitignore o usa la sintaxis de variables de entorno de Cursor para que la clave no acabe en el repositorio.

VS Code

VS Code lee los servidores MCP de .vscode/mcp.json. Su formato usa una clave servers y puede pedirte la clave de API en lugar de guardarla (ejemplo):

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

Inicia el servidor desde el archivo o desde la vista de servidores MCP, introduce tu clave cuando te la pida y las herramientas de StickyPrompts aparecerán en el selector de herramientas del modo agente.

Otros clientes

Para cualquier cliente compatible con servidores HTTP remotos con headers, la estructura genérica es esta (ejemplo; los nombres de las claves varían ligeramente de un cliente a otro, por ejemplo type o transport):

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

Los clientes que solo hablan stdio pueden usar el puente mcp-remote que se muestra en la sección de Claude Desktop.

MCP Inspector

MCP Inspector es la forma más rápida de ver exactamente qué herramientas expone tu clave y de llamarlas a mano.

zsh

$ npx @modelcontextprotocol/inspector

En el Inspector, elige el transporte Streamable HTTP, introduce https://api.stickyprompts.com/mcp/, añade un header Authorization con Bearer STICKY-API-... y conéctate. List Tools muestra las herramientas que permiten los permisos de tu clave.

Handshake manual con curl

Hablar el protocolo a mano es útil para depurar. Primero, inicializa una sesión y anota el header de respuesta 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 respuesta identifica el servidor como StickyPrompts 1.0.0 con la capacidad tools e incluye un header del tipo Mcp-Session-Id: mcp-session-<uuid>. Después, lista las herramientas enviando ese id de sesión:

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

Y llama a una de ellas:

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

El content[0].text del resultado es una cadena JSON, por ejemplo {"agents":[{"id":3,"name":"Support Triage","slug":"...","tag":"support-triage"}]}.

Pruébalo

Una vez conectado, prueba en tu cliente prompts como estos. Cada uno necesita el permiso indicado.

Prueba a pedir	Herramienta que usa	Permiso
«Lista mis agentes de StickyPrompts.»	`list_agents`	`agents_get`
«Busca nuestra política de reembolsos en mi base de conocimiento.»	`list_knowledge_bases`, `search_knowledge_base`	`knowledge_bases_get`
«¿Qué modelos de IA puedo usar en StickyPrompts?»	`list_ai_models`	`ai_models_get`
«Muestra mis cinco últimas conversaciones de StickyPrompts.»	`list_conversations`	`conversations_get`
«Ejecuta mi prompt Renewal Check-in Email para Bluebird Market.»	`get_prompt`, `run_prompt`	`prompts_get`, `run_prompt`
«¿Qué tratos de Pipedrive están en la etapa Proposal Made?»	`list_crm_connections`, `search_crm_deals`	`integration_crm_get`
«¿Qué tablas hay en la base de datos de retail de Northwind?»	`list_database_connections`, `list_database_tables`	`integration_database_get`

Solución de problemas

Síntoma	Causa probable
`401 {"error":"unauthorized"}`	Falta el header o no tiene la forma `Bearer STICKY-API-...`.
`401 {"error":"Invalid API key"}`	La clave se escribió mal, está incompleta o se ha eliminado.
La conexión funciona, pero no hay herramientas o falta alguna	A la clave le falta el permiso de esa herramienta. Edita la clave en Settings > API keys.
`tool '<name>' not found`	Lo mismo que en el caso anterior: una herramienta sin permiso se ve exactamente igual que una que no existe.
El cliente no puede conectarse a `/mcp`	Usa `/mcp/` con la barra final; algunos clientes no siguen la redirección.
Las llamadas largas agotan el tiempo de espera	La música, la voz, la transcripción y los modelos lentos pueden tardar un rato. Aumenta el tiempo de espera de las peticiones en tu cliente.

Consulta Introducción a MCP para saber cómo funcionan las sesiones, los resultados y los errores, y la referencia de herramientas para ver los argumentos de cada herramienta.