Guía Rápida: Servidor 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
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:

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

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

{
  "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.

Cursor IDE

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

{
  "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:

# 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:

# 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
• 🔧 Explora las 11 herramientas disponibles
• 💡 Aprende sobre casos de uso avanzados
• 🔐 Revisa las mejores prácticas de seguridad

¿Necesitas Ayuda?

• Email: support@salescaling.com
• Documentación API: https://api.salescaling.com/api/docs
• Slack: Únete a la comunidad

Tiempo estimado: 5 minutos ⏱️
Dificultad: Principiante 🟢