# Guía Rápida MCP

Esta guía te ayudará a conectar el servidor MCP de Salescaling con tu cliente favorito en menos de 5 minutos.

## Paso 1: Obtén tu API Key

1. Inicia sesión en [app.salescaling.com](https://app.salescaling.com)
2. Ve a **Configuración > API Keys**
3. Haz clic en **"Crear Nueva API Key"**
4. Dale un nombre (ej: "MCP Claude Desktop")
5. Copia la key

⚠️ **Importante**: Guarda la key en un lugar seguro, solo se muestra una vez.

## Paso 2: Configura tu Cliente

### Claude Desktop (Recomendado)

**macOS:**

1. Abre Terminal
2. Ejecuta:

```bash
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

3. Pega esta configuración (reemplaza `TU_API_KEY`):

```json
{
  "mcpServers": {
    "salescaling": {
      "url": "https://api.salescaling.com/api/v1/mcp",
      "headers": {
        "X-API-Key": "TU_API_KEY"
      }
    }
  }
}
```

4. Guarda (`Ctrl+O`, `Enter`, `Ctrl+X`)
5. Reinicia Claude Desktop

**Windows:**

1. Abre el Explorador de archivos
2. Navega a: `%APPDATA%\Claude\`
3. Abre `claude_desktop_config.json` con Notepad
4. Pega la configuración (reemplaza `TU_API_KEY`)
5. Guarda y reinicia Claude Desktop

### Claude u otros clientes con OAuth (sin API Key en el fichero)

Si tu cliente usa **OAuth Clients** en lugar de API key (por ejemplo Claude con inicio de sesión en el navegador):

1. En Salescaling: **Configuración → OAuth Clients** y crea un cliente.
2. Añade como **Redirect URI** la URL de Claude: `https://claude.ai/api/mcp/auth_callback`
3. Configura el bloque `oauth` del cliente MCP con `authorizationUrl`, `tokenUrl`, `clientId` y `scopes`.

La guía detallada, tabla de URLs y ejemplo JSON están en [Servidor MCP → Conexión MCP vía OAuth Clients](/api/mcp-server.md#mcp-oauth-clients).

### Cursor IDE

1. Abre Cursor
2. Ve a Configuración (`Cmd/Ctrl + ,`)
3. Busca "MCP"
4. Agrega:

```json
{
  "mcp.servers": {
    "salescaling": {
      "url": "https://api.salescaling.com/api/v1/mcp",
      "headers": {
        "X-API-Key": "TU_API_KEY"
      }
    }
  }
}
```

5. Reinicia Cursor

## Paso 3: Verifica la Conexión

### En Claude Desktop

1. Abre Claude Desktop
2. Busca el ícono de herramientas (🔧) en la barra lateral
3. Deberías ver "salescaling" listado
4. Haz clic para ver las 11 herramientas disponibles

### En Cursor

1. Abre el chat de Cursor
2. Escribe: `@salescaling`
3. Deberías ver el servidor disponible

## Paso 4: Prueba una Búsqueda

Prueba con este prompt en Claude o Cursor:

```
Busca mis reuniones de la última semana
```

Claude/Cursor debería:

1. Usar automáticamente la herramienta `list_meetings`
2. Mostrar tus reuniones recientes
3. Permitirte hacer preguntas de seguimiento

## Ejemplos de Prompts

Una vez conectado, prueba estos prompts:

### Búsqueda Básica

```
Busca reuniones sobre "pricing" del último mes
```

### Análisis de Reunión

```
Dame el resumen de la reunión con ID abc-123
```

### Análisis Agregado

```
Analiza todas mis reuniones de diciembre y dame insights sobre:
- Temas más discutidos
- Objeciones comunes
- Oportunidades identificadas
```

### Transcripción Completa

```
Muéstrame la transcripción completa de la última reunión con el cliente XYZ
```

### Búsqueda Avanzada

```
Busca reuniones donde se mencionó "implementación" o "timeline" 
en las transcripciones de los últimos 3 meses
```

## Solución de Problemas

### ❌ "No puedo encontrar el servidor salescaling"

**Solución:**

1. Verifica que el archivo de configuración esté en la ubicación correcta
2. Confirma que el JSON sea válido (sin comas extras)
3. Reinicia completamente el cliente
4. Revisa los logs del cliente para errores

### ❌ "Unauthorized - missing or invalid API key"

**Solución:**

1. Verifica que copiaste la API key completa
2. Confirma que la key no haya expirado
3. Revisa que no haya espacios extra al inicio o final
4. Genera una nueva key si es necesario

### ❌ "No encuentro el archivo de configuración"

**macOS:**

```bash
# Crea el directorio si no existe
mkdir -p ~/Library/Application\ Support/Claude/

# Crea el archivo
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

**Windows:**

```powershell
# Crea el directorio si no existe
New-Item -ItemType Directory -Force -Path "$env:APPDATA\Claude"

# Crea el archivo
New-Item -ItemType File -Force -Path "$env:APPDATA\Claude\claude_desktop_config.json"
```

### ❌ "Las respuestas son muy largas"

**Solución:** Pide explícitamente límites más pequeños:

```
Busca reuniones sobre pricing (máximo 5 resultados)
```

O para transcripciones:

```
Dame las primeras 50 oraciones de la transcripción de la reunión abc-123
```

## Próximos Pasos

* 📖 Lee la [documentación completa del servidor MCP](/api/mcp-server.md)
* 🔧 Explora las [11 herramientas disponibles](/api/mcp-server.md#herramientas-disponibles)
* 💡 Aprende sobre [casos de uso avanzados](/api/mcp-server.md#ejemplos-de-uso)
* 🔐 Revisa las [mejores prácticas de seguridad](/api/mcp-server.md#seguridad-y-privacidad)

## ¿Necesitas Ayuda?

* **Email**: <support@salescaling.com>
* **Documentación API**: <https://api.salescaling.com/api/docs>
* **Slack**: [Únete a la comunidad](https://salescaling.com/slack)

***

**Tiempo estimado**: 5 minutos ⏱️\
**Dificultad**: Principiante 🟢


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.salescaling.com/api/mcp-server/mcp-quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.