> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getquikly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen de MCP

> Usa quikly-mcp-server para crear y gestionar propuestas desde asistentes de IA para código como Cursor, Claude Desktop y Claude Code.

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)](https://modelcontextprotocol.io). 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](https://cursor.com)                                                            | Compatible |
| [Claude Desktop](https://claude.ai/download)                                            | Compatible |
| [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) | 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):

```json theme={null}
{
  "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`

```json theme={null}
{
  "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

```bash theme={null}
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](/es/mcp/tools-reference) para parámetros, ejemplos y endpoints equivalentes de la API.

<Tip>
  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.
</Tip>