El servidor MCP de Quikly permite que asistentes de IA interactúen con tu cuenta de Quikly a través del Model Context Protocol (MCP). Puedes crear propuestas, analizar briefs, obtener recomendaciones de tarifas y compartir propuestas — todo desde tu editor o chat con IA.
¿Qué es MCP?
Model Context Protocol es un estándar abierto que conecta asistentes de IA con herramientas y fuentes de datos externas. En lugar de copiar y pegar entre Quikly y tu editor, le das al asistente acceso directo a la API de Quikly a través de llamadas estructuradas a herramientas.
¿Qué es quikly-mcp-server?
quikly-mcp-server es un paquete npm que expone la API de Quikly como herramientas MCP. Cuando lo agregas a un cliente compatible, el asistente de IA puede:
- Obtener tu información de perfil
- Crear propuestas a partir de una descripción de proyecto
- Analizar un brief y extraer requerimientos estructurados
- Obtener recomendaciones de tarifas impulsadas por IA según rol, seniority y ubicación
- Recuperar detalles de propuestas
- Generar enlaces de compartir para clientes
Clientes compatibles
| Cliente | Estado |
|---|
| Cursor | Compatible |
| Claude Desktop | Compatible |
| Claude Code | Compatible |
Instalación
El servidor se ejecuta vía npx — no se requiere instalación global. Necesitas dos variables de entorno:
| Variable | Descripción |
|---|
QUIKLY_API_BASE_URL | https://api.getquikly.com/api/external/v1 |
QUIKLY_API_KEY | Tu clave de API de Quikly (crea una en Configuración → Claves de API) |
Cursor
Agrega esto al archivo de configuración MCP de Cursor (.cursor/mcp.json en tu proyecto o configuración global):
{
"mcpServers": {
"quikly": {
"command": "npx",
"args": ["-y", "quikly-mcp-server"],
"env": {
"QUIKLY_API_BASE_URL": "https://api.getquikly.com/api/external/v1",
"QUIKLY_API_KEY": "qk_your_api_key_here"
}
}
}
}
Claude Desktop
Agrega esto al archivo de configuración de Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"quikly": {
"command": "npx",
"args": ["-y", "quikly-mcp-server"],
"env": {
"QUIKLY_API_BASE_URL": "https://api.getquikly.com/api/external/v1",
"QUIKLY_API_KEY": "qk_your_api_key_here"
}
}
}
}
Claude Code
claude mcp add quikly -- npx -y quikly-mcp-server \
--env QUIKLY_API_BASE_URL=https://api.getquikly.com/api/external/v1 \
--env QUIKLY_API_KEY=qk_your_api_key_here
Verificar la conexión
Después de configurar, pídele a tu asistente de IA:
“Usa la herramienta quikly_me para verificar mi perfil de Quikly.”
Si todo está configurado correctamente, el asistente devolverá tu nombre, email y tier de suscripción.
Herramientas disponibles
El servidor MCP expone las siguientes herramientas:
| Herramienta | Descripción |
|---|
quikly_me | Obtener tu info de perfil |
quikly_create_proposal | Crear una nueva propuesta |
quikly_analyze_brief | Analizar un brief y extraer requerimientos |
quikly_recommend_rate | Obtener una recomendación de tarifa con IA |
quikly_get_proposal | Obtener una propuesta por ID |
quikly_share_link | Generar un enlace de compartir |
Crea una clave de API dedicada con scope read,write para tu servidor MCP. Etiquétala “Cursor MCP” o “Claude MCP” para que puedas identificarla y rotarla fácilmente.
