Introducción para desarrolladores

Usa la API REST y el servidor MCP de StickyPrompts para automatizar tareas, crear herramientas internas y llevar tu espacio de trabajo a Claude, Cursor y otros clientes MCP. Una sola clave de API sirve para ambos.

Todo lo que tu equipo crea en StickyPrompts (prompts, agentes, bases de conocimiento, flujos de trabajo, CRM y bases de datos conectados) también está al alcance de tu propio código. Puedes usarlo mediante una API REST sencilla basada en JSON, o conectar un cliente MCP y dejar que un asistente de IA lo utilice como un conjunto de herramientas. Ambas opciones funcionan sobre el mismo motor que la aplicación web, así que se aplican los mismos modelos, guardrails y reglas de acceso.

Una clave, dos puertas. Detrás está todo lo que tu espacio de trabajo ya tiene.

Qué puedes crear

Automatizaciones

Ejecuta un prompt guardado con cada nuevo ticket de soporte, procesa una hoja de cálculo fila por fila o inicia un flujo de trabajo desde tu propio programador de tareas.

Herramientas internas

Pon los modelos y agentes que tu espacio de trabajo ya permite detrás de un formulario, un chatbot o un panel de administración.

StickyPrompts en tu cliente de IA

Conecta Claude Code, Cursor o VS Code mediante MCP y pide «la política de reembolsos de Northwind» o «redacta un seguimiento para este trato».

¿REST o MCP?

	API REST	Servidor MCP
URL base	`https://api.stickyprompts.com/api/v1`	`https://api.stickyprompts.com/mcp/` (conserva la barra final)
Ideal para	Tu propio código: backends, scripts, tareas programadas	Clientes de IA compatibles con el Model Context Protocol
Estructura	Endpoints de recursos (`GET /conversation`, `POST /run`, …)	Herramientas (`send_message`, `search_knowledge_base`, `send_email`, …)
Cobertura	La más amplia: crear y gestionar prompts, agentes, flujos de trabajo, archivos, proyectos, equipos y contenido multimedia	Un conjunto acotado de herramientas para consultar, ejecutar y actuar
Autenticación	`Authorization: Bearer STICKY-API-...`	El mismo header y la misma clave

Elige REST cuando sea tu código el que decide qué ocurre. Elige MCP cuando quieras que sea un modelo el que decida qué herramienta llamar. Muchos equipos usan ambos con una sola clave: MCP en el editor y REST en las tareas de producción.

Algunas funciones solo existen en uno de los dos lados. La búsqueda semántica dentro de una base de conocimiento es una herramienta MCP (search_knowledge_base) sin equivalente en REST. La subida de archivos, en cambio, solo está en REST: el servidor MCP puede traer archivos de Google Drive con import_storage_files, pero no tiene ninguna herramienta para subirlos.

Una clave para ambos

Las claves de API las creas tú en Settings > API keys. Cada clave tiene un nombre y un conjunto de permisos, y la clave completa se muestra una sola vez. La misma clave autentica tanto las llamadas REST como las sesiones MCP:

Authorization: Bearer STICKY-API-<64 characters>

Encontrarás todos los detalles en Claves de API y autenticación.

Una clave actúa en tu nombre, limitada por sus permisos

Una clave no es una cuenta de servicio independiente. Actúa como el usuario que la creó: ve tu espacio de trabajo, tus proyectos y todo lo que se ha compartido contigo, y nada más. Sus permisos restringen después ese acceso. Una clave que solo tiene knowledge_bases_get puede leer las bases de conocimiento que tú puedes leer, pero no puede tocar tus conversaciones.

No existen claves por espacio de trabajo ni por proyecto. El alcance de una clave se define al elegir sus permisos.
Las reglas del espacio de trabajo se siguen aplicando a cada llamada: el acceso a modelos, la residencia de datos y los guardrails funcionan exactamente igual que en la aplicación.
En MCP, una herramienta para la que tu clave no tiene permiso ni siquiera aparece en la lista de herramientas.

Tienes la lista completa en la referencia de permisos.

El uso cuenta igual que en la aplicación

Las llamadas a la API y a MCP pasan por la misma ruta de ejecución, cuotas y facturación que la aplicación web. El uso se atribuye al propietario de la clave y a su espacio de trabajo, como cualquier otro uso, y consume los mismos créditos. No hay una lista de precios aparte para la API. Cuando el espacio de trabajo agota su cuota, las llamadas REST que inician trabajo de pago devuelven 429 Quota exceeded (consulta Errores, paginación y cuotas).

Sin webhooks: consulta el estado periódicamente

La API no envía webhooks. La mayoría de las llamadas son síncronas y devuelven el resultado terminado. Para los trabajos de larga duración (vídeo, voz, música y transcripción por REST, procesamiento de hojas de cálculo, ejecuciones de flujos de trabajo), inicias el trabajo y luego consultas su estado cada cierto tiempo. Una conversación iniciada con el endpoint de streaming se puede seguir en directo por su WebSocket, donde cada frame incluye el mensaje completo hasta ese momento.