Resumen de MCP - Quikly.ai

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

Cualquier cliente compatible con MCP puede usar quikly-mcp-server.

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

Después de guardar, reinicia Cursor o recarga los servidores MCP. Deberías ver las herramientas de Quikly en el panel de MCP.

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

Reinicia Claude Desktop después de guardar. Las herramientas de Quikly aparecerán en el menú de herramientas.

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

Consulta la referencia de herramientas para parámetros, ejemplos y endpoints equivalentes de la API.

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.

​¿Qué es MCP?

​¿Qué es quikly-mcp-server?

​Clientes compatibles

​Instalación

​Cursor

​Claude Desktop

​Claude Code

​Verificar la conexión

​Herramientas disponibles

¿Qué es MCP?

¿Qué es quikly-mcp-server?

Clientes compatibles

Instalación

Cursor

Claude Desktop

Claude Code

Verificar la conexión

Herramientas disponibles