Servidor MCP (Model Context Protocol)
El servidor MCP de Salescaling permite que agentes de IA como Claude, Cursor y otros clientes compatibles con el protocolo MCP accedan a tus datos de reuniones, transcripciones y resúmenes de forma estructurada y segura.
¿Qué es MCP?
Model Context Protocol (MCP) es un protocolo estándar que permite a los modelos de lenguaje (LLMs) interactuar con sistemas externos de forma estructurada. El servidor MCP de Salescaling implementa este protocolo para exponer tus datos de reuniones a través de herramientas que los agentes de IA pueden usar.
Características
- ✅ Spec-Compliant: Implementación completa del protocolo MCP oficial
- ✅ 14 Herramientas Disponibles: Reuniones (videollamada y presencial), llamadas telefónicas, búsqueda, listados, transcripción, resumen con action items, detalle, estadísticas, enlaces profundos a la app web y más
- ✅ Búsqueda Avanzada: Full Text Search para búsquedas por contenido en reuniones y llamadas
- ✅ Control de Payload: Límites configurables para evitar overflow de contexto
- ✅ Autenticación Segura: API key de Salescaling u OAuth Clients (Authorization Code + PKCE)
- ✅ Multi-tenant: Aislamiento automático por organización
- ✅ Alto Rendimiento: Optimizado para grandes volúmenes de actividad con control de concurrencia
Endpoints MCP
El servidor MCP expone dos endpoints principales:
GET /api/v1/mcp - Listar Herramientas
Retorna la lista de herramientas disponibles con sus esquemas de entrada.
Ejemplo:
curl -X GET https://api.salescaling.com/api/v1/mcp \
-H "X-API-Key: sk_xxx"
POST /api/v1/mcp - Ejecutar Herramienta
Ejecuta una herramienta específica con los argumentos proporcionados.
Ejemplo:
curl -X POST https://api.salescaling.com/api/v1/mcp \
-H "X-API-Key: sk_xxx" \
-H "Content-Type: application/json" \
-d '{
"name": "search_meetings",
"arguments": {
"query": "performance",
"limit": 10
}
}'
Conexión MCP vía OAuth Clients
Además de la API key, puedes conectar clientes MCP que soporten OAuth 2.0 (flujo Authorization Code con PKCE). El servidor admite Dynamic Client Registration (DCR), por lo que el cliente registra automáticamente sus redirect URIs y no necesita un client_id ni un client_secret creados manualmente.
Requisitos
- El cliente MCP debe poder completar el flujo OAuth en el navegador y enviar
Authorization: Bearer <access_token>al servidor MCP.
Configurar el cliente MCP
Añade únicamente la URL del servidor MCP. Claude u otro cliente compatible hará el registro DCR y abrirá la pantalla de consentimiento. Para Claude (Anthropic) la redirect URI que registra el cliente es:
https://claude.ai/api/mcp/auth_callback
Como mínimo se solicita acceso de lectura a reuniones; la pantalla de consentimiento muestra todos los permisos que tu rol permite en el tenant seleccionado, con casillas para elegir cuáles conceder antes de autorizar.
Metadatos del servidor de autorización
Salescaling expone metadatos compatibles con descubrimiento OpenID en el propio endpoint MCP:
GET https://api.salescaling.com/.well-known/oauth-protected-resource/api/v1/mcpGET https://api.salescaling.com/.well-known/oauth-authorization-server
Ahí encontrarás issuer, authorization_endpoint, token_endpoint, revocation_endpoint y scopes soportados (sustituye el host si usas otro entorno).
Ejemplo: MCP para Claude con OAuth
Configura el cliente MCP con la URL del servidor MCP (ajusta dominios si usas otro entorno):
{
"mcpServers": {
"salescaling": {
"url": "https://api.salescaling.com/api/v1/mcp"
}
}
}
Resumen de URLs típicas
| Uso | URL |
|---|---|
| Servidor MCP | https://api.salescaling.com/api/v1/mcp |
| Autorización (login usuario) | https://app.salescaling.com/oauth/authorize |
| Token (intercambio código / refresh) | https://api.salescaling.com/v1/oauth/token |
| Registro dinámico (DCR) | https://api.salescaling.com/v1/oauth/register |
Las peticiones al MCP usarán el token de acceso en el header Authorization: Bearer … en lugar de X-API-Key.
Reuniones vs llamadas telefónicas
Salescaling guarda videollamadas, reuniones presenciales y llamadas telefónicas en la misma entidad de reunión. Para que la API MCP sea clara:
- Las herramientas cuyo nombre incluye
meetings(search_meetings,search_meetings_semantic,list_meetings,find_meetings_by_participant) solo incluyen videollamadas y presenciales por defecto (search_meetings_semanticpuede incluir llamadas conincludePhoneCalls: true). - Las herramientas
list_calls,search_callsyfind_calls_by_participantestán dedicadas a llamadas telefónicas y admiten filtros como dirección (INBOUND/OUTBOUND) y números de teléfono. get_meeting_transcript,get_meeting_summary,get_meeting_detailsyget_meeting_action_itemsfuncionan con cualquier ID de reunión o llamada (el mismo identificador).
Herramientas Disponibles
1. search_meetings - Búsqueda Avanzada
Busca videollamadas y reuniones presenciales por texto en títulos y/o transcripciones (Full Text Search). No incluye llamadas telefónicas; para eso usa search_calls. La búsqueda en transcript respeta el mismo acceso FGA que el agente (access_control).
Parámetros:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
query | string | Sí | Término de búsqueda |
scope | string | No | title, sentences o all (default: all) |
fromDate | string | No | Fecha inicio (YYYY-MM-DD) |
toDate | string | No | Fecha fin (YYYY-MM-DD) |
limit | number | No | Máximo 50 (default: 20) |
Nota: Solo actividades de tipo videollamada o presencial.
Ejemplo:
{
"name": "search_meetings",
"arguments": {
"query": "performance review",
"scope": "all",
"fromDate": "2024-12-01",
"limit": 10
}
}
1b. search_meetings_semantic - Búsqueda por tema (embeddings)
Misma pipeline que el agente de platform: embeddings en summary y transcript, subconsultas compuestas, FGA obligatorio. Usar para preguntas en lenguaje natural (“¿dónde hablamos del coste de la línea?”). Por defecto excluye phone calls.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
query | string | Sí | Tema o pregunta en lenguaje natural |
limit | number | No | Máximo 20 (default: 8) |
fromDate / toDate | string | No | Rango por fecha de inicio de reunión |
includePhoneCalls | boolean | No | Incluir llamadas telefónicas (default: false) |
1c. search_memory_statements - Hechos extraídos (person facts)
Búsqueda semántica sobre statements CRM (person_fact) con evidenceQuote. No requiere contactId. FGA sobre la actividad origen.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
query | string | Sí | Tema (pricing, objeciones, etc.) |
limit | number | No | Máximo 20 (default: 8) |
canonicalNamespace | string | No | Filtro opcional (pricing, budget, …) |
2. list_meetings - Listar Reuniones
Lista videollamadas y reuniones presenciales con filtros estructurados (excluye llamadas telefónicas).
Parámetros:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
keyword | string | No | Búsqueda en nombres / título |
fromDate | string | No | Fecha inicio |
toDate | string | No | Fecha fin |
limit | number | No | Máximo 50 (default: 20) |
skip | number | No | Paginación (default: 0) |
sortOrder | string | No | asc o desc — orden por fecha de inicio (default: desc) |
participants | string[] | No | Emails de participantes |
organizers | string[] | No | Emails de organizadores |
Ejemplo:
{
"name": "list_meetings",
"arguments": {
"fromDate": "2024-12-01",
"toDate": "2024-12-31",
"participants": ["cliente@empresa.com"],
"limit": 20
}
}
3. get_meeting_transcript - Obtener Transcripción
Obtiene la transcripción detallada con atribución de speakers (reunión o llamada).
Parámetros:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
transcriptId | string | Sí | ID de la reunión o llamada |
language | string | No | Código de idioma (ej: "es", "en") |
maxSentences | number | No | Límite de oraciones (control de payload) |
Control de Payload:
- Auto-trunca en 10,000 oraciones si no se especifica
maxSentences - Indica en la respuesta si se truncó el contenido
Ejemplo:
{
"name": "get_meeting_transcript",
"arguments": {
"transcriptId": "meeting-uuid-here",
"language": "es",
"maxSentences": 100
}
}
4. get_meeting_summary - Obtener Resumen
Obtiene el resumen generado por IA: texto (summaryText), action items (actionItems / next_steps), y según el tipo, topics/highlights (reuniones) o call insights (llamadas).
Parámetros:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
transcriptId | string | Sí | ID de la reunión o llamada |
language | string | No | Código de idioma |
Ejemplo:
{
"name": "get_meeting_summary",
"arguments": {
"transcriptId": "meeting-uuid-here",
"language": "es"
}
}
5. get_meeting_details - Detalles Completos
Obtiene detalles completos de una reunión (metadatos + transcripción + resumen).
Parámetros:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | ID de la reunión |
includeTranscript | boolean | No | Incluir transcripción (default: true) |
includeSummary | boolean | No | Incluir resumen (default: true) |
maxSentences | number | No | Límite de oraciones en transcript |
Ejemplo:
{
"name": "get_meeting_details",
"arguments": {
"id": "meeting-uuid-here",
"includeTranscript": true,
"includeSummary": true,
"maxSentences": 500
}
}
6. find_meetings_by_participant - Buscar Reuniones por Participante
Encuentra reuniones donde participó una persona específica. Busca por nombre (coincidencia parcial) o email (coincidencia exacta).
Parámetros:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
participant | string | Sí | Nombre o email del participante |
fromDate | string | No | Fecha inicio (YYYY-MM-DD) |
toDate | string | No | Fecha fin (YYYY-MM-DD) |
limit | number | No | Máximo 50 (default: 20) |
skip | number | No | Paginación (default: 0) |
sortOrder | string | No | asc o desc por fecha de inicio (default: desc) |
titleFilter | string | No | Filtro opcional sobre el título de la reunión (coincidencia parcial) |
Características:
- Solo videollamadas y presenciales (no llamadas telefónicas).
- Búsqueda por email: Coincidencia exacta (case-insensitive)
- Ejemplo:
jon@empresa.comencontrará solo ese email exacto
- Ejemplo:
- Búsqueda por nombre: Coincidencia parcial
- Ejemplo:
Jonencontrará "Jon Smith", "Jonathan", "Jon Doe", etc.
- Ejemplo:
- Retorna información completa de participantes y organizador
- Orden configurable con
sortOrder
Ejemplos:
Buscar por email:
{
"name": "find_meetings_by_participant",
"arguments": {
"participant": "jon@empresa.com",
"fromDate": "2024-12-01",
"limit": 20
}
}
Buscar por nombre:
{
"name": "find_meetings_by_participant",
"arguments": {
"participant": "Jon",
"fromDate": "2024-01-01",
"toDate": "2024-12-31",
"limit": 50
}
}
7. list_calls - Listar llamadas telefónicas
Lista solo llamadas telefónicas (phonecall), con filtros por fechas, título, participantes, dirección y números.
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
titleFilter | string | No | Coincidencia parcial en el nombre/título |
fromDate / toDate | string | No | Rango de fechas (YYYY-MM-DD) |
limit | number | No | Máximo 50 (default: 20) |
skip | number | No | Paginación |
sortOrder | string | No | asc o desc (default: desc) |
direction | string | No | INBOUND o OUTBOUND |
participants | string[] | No | Emails de participantes |
fromNumber / toNumber | string | No | Filtro parcial por número de llamante o destino |
8. search_calls - Buscar en llamadas
Búsqueda en títulos y/o transcripciones solo para llamadas telefónicas. Parámetros similares a search_meetings, más direction, fromNumber, toNumber opcionales.
9. find_calls_by_participant - Llamadas por participante
Igual que find_meetings_by_participant pero solo para llamadas telefónicas, con los mismos filtros extra que list_calls (titleFilter, sortOrder, direction, números).
10. get_meeting_action_items - Action items del resumen
Devuelve los next steps estructurados del resumen IA para un ID de reunión o llamada.
| Parámetro | Tipo | Requerido |
|---|---|---|
meetingId | string | Sí |
language | string | No |
11. get_meetings_statistics - Estadísticas agregadas
Totales, duraciones medias por tipo de actividad, y top participantes (muestra acotada). Ámbito configurable:
| Parámetro | Tipo | Descripción |
|---|---|---|
fromDate / toDate | string | Rango opcional |
type | string | meetings (video+presencial), calls (solo teléfono), o all (default) |
12. build_platform_link - Enlace a la plataforma web
Devuelve una URL absoluta para abrir un recurso en la app web (mismo tenant que la petición). Rutas alineadas con la plataforma (/meetings, /calls, actividades, CRM, etc.).
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
resourceType | string | Sí | meeting, call, activity, contact, company, calendar_event, clip, playlist, library_topic, voice_agent, call_campaign |
id | string | Sí | Id del recurso (UUID u otro id que use la API / la URL) |
baseUrl | string | No | Origen https de la app (p. ej. https://app.salescaling.com). Solo se aceptan orígenes en la lista permitida del servidor (producción y el mismo host que PLATFORM_URL / NEXT_PUBLIC_URL / FRONTEND_URL en ese entorno); la ruta del valor se ignora. Si se omite: esas variables o el valor por defecto de producción |
preferCallDetail | boolean | No | Solo con resourceType: "meeting". Si es true (default) y la reunión es llamada telefónica, el enlace apunta a /calls/{callId} en lugar de /meetings/{id} |
Notas:
- Para
resourceType: "call",iddebe ser el id de la filacall(el que usa la página/calls/[id]). - Para reuniones que son teléfono, si ya tienes el id de reunión y
preferCallDetail: true, el servidor resuelve elcallIdcuando exista (respeta acceso FGA como el resto de tools). - La respuesta incluye JSON con
url,path,resourceType,idy opcionalmentenote(p. ej. cuando se enlaza una reunión telefónica vía/calls/...).
Configuración en Clientes MCP
Para OAuth (incluido Claude con redirect https://claude.ai/api/mcp/auth_callback), sigue la sección Conexión MCP vía OAuth Clients.
Claude Desktop (API Key)
-
Localiza tu archivo de configuración:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Agrega la configuración del servidor MCP:
{
"mcpServers": {
"salescaling": {
"url": "https://api.salescaling.com/api/v1/mcp",
"headers": {
"X-API-Key": "sk_tu_api_key_aqui"
}
}
}
}
-
Reinicia Claude Desktop
-
Verifica que el servidor esté conectado:
- Busca el ícono de herramientas en la interfaz
- Deberías ver "salescaling" como servidor disponible
- Las 14 herramientas deberían aparecer listadas
Cursor IDE
-
Abre la configuración de Cursor (
Cmd/Ctrl + ,) -
Busca "MCP Servers" en la configuración
-
Agrega el servidor de Salescaling:
{
"mcp.servers": {
"salescaling": {
"url": "https://api.salescaling.com/api/v1/mcp",
"headers": {
"X-API-Key": "sk_tu_api_key_aqui"
}
}
}
}
-
Reinicia Cursor
-
Usa el servidor desde el chat de Cursor:
- Menciona "@salescaling" en el chat
- O pide directamente: "Busca reuniones sobre performance"
Otros Clientes MCP
Para cualquier cliente compatible con MCP:
- URL del servidor:
https://api.salescaling.com/api/v1/mcp - Autenticación: Header
X-API-Keycon tu API key - Protocolo: HTTP/HTTPS estándar
- Formato: JSON
Ejemplos de Uso
Ejemplo 1: Buscar Reuniones con Claude
Usuario: "Busca reuniones sobre pricing del último mes"
Claude → POST /api/v1/mcp
{
"name": "search_meetings",
"arguments": {
"query": "pricing",
"scope": "all",
"fromDate": "2024-12-01",
"limit": 20
}
}
Claude: "Encontré 5 reuniones sobre pricing:
1. Reunión de pricing con Acme Corp - 15 dic 2024
2. Review de estrategia de precios - 10 dic 2024
..."
Ejemplo 2: Obtener Transcripción Completa
Usuario: "Dame la transcripción completa de la reunión con ID abc-123"
Claude → POST /api/v1/mcp
{
"name": "get_meeting_transcript",
"arguments": {
"transcriptId": "abc-123",
"language": "es"
}
}
Claude: "Aquí está la transcripción de la reunión:
[00:00 - 00:15] Juan Pérez: Buenos días a todos..."
Ejemplo 3: Análisis de Múltiples Reuniones
Usuario: "Analiza las reuniones de ventas de diciembre y dame insights"
Claude:
1. Lista reuniones → list_meetings (diciembre)
2. Para cada reunión → get_meeting_summary
3. Analiza patrones y genera insights
Claude: "He analizado 15 reuniones de diciembre:
- Temas más discutidos: pricing (8), implementación (6)
- Objeciones comunes: tiempo de implementación (5)
- Oportunidades identificadas: 3 cuentas enterprise..."
Formato de Respuesta
Todas las herramientas retornan respuestas en formato MCP estándar:
{
"content": [
{
"type": "text",
"text": "Descripción legible del resultado"
},
{
"type": "resource",
"resource": {
"uri": "salescaling://meeting/xxx",
"mimeType": "application/json",
"text": "{...datos JSON estructurados...}"
}
}
]
}
Seguridad y Privacidad
Autenticación
- Las peticiones requieren API key (
X-API-Key) o un access token OAuth (Authorization: Bearer) emitido para un OAuth Client autorizado - Las API keys se gestionan desde Configuración > API Keys; los clientes MCP OAuth se registran automáticamente mediante DCR
- Cada credencial está vinculada a tu organización (tenant)
Aislamiento de Datos
- El servidor MCP respeta el aislamiento multi-tenant
- Solo puedes acceder a reuniones de tu organización
- Los permisos de tu rol y organización se aplican automáticamente
Mejores Prácticas
- Nunca compartas tu API key: Trátala como una contraseña
- Usa variables de entorno: No hardcodees la key en archivos
- Rota las keys periódicamente: Crea nuevas keys y elimina las antiguas
- Establece fechas de expiración: Para keys temporales o de prueba
- Monitorea el uso: Revisa los logs de acceso regularmente
Límites y Cuotas
Rate Limiting
El servidor MCP comparte los mismos límites de la API pública:
- Corto plazo: 35 peticiones por segundo
- Mediano plazo: 200 peticiones cada 10 segundos
- Largo plazo: 1000 peticiones por minuto
Límites de Payload
- Transcripciones: Auto-trunca en 10,000 oraciones
- Búsquedas: Máximo 50 resultados por petición
- Listados: Máximo 50 reuniones por petición
Usa el parámetro maxSentences para controlar el tamaño de las transcripciones.
Troubleshooting
Error: "Unauthorized - missing or invalid API key"
Causa: API key no válida o no proporcionada
Solución:
- Verifica que el header
X-API-Keyesté presente - Confirma que la key sea válida en Configuración > API Keys
- Verifica que la key no haya expirado
Error: "Unknown tool: xxx"
Causa: Nombre de herramienta incorrecto
Solución:
- Verifica el nombre de la herramienta (case-sensitive)
- Usa
GET /api/v1/mcppara ver las herramientas disponibles - Nombres válidos (entre otros):
search_meetings,search_meetings_semantic,search_memory_statements,list_meetings,get_meeting_transcript,get_meeting_summary,get_meeting_details,find_meetings_by_participant,list_calls,search_calls,find_calls_by_participant,get_meeting_action_items,get_meetings_statistics,build_platform_link
Error: "Meeting not found"
Causa: ID de reunión no existe o no tienes acceso
Solución:
- Verifica que el ID sea correcto
- Confirma que la reunión pertenezca a tu organización
- Usa
list_meetingspara obtener IDs válidos
El servidor no aparece en Claude Desktop
Solución:
- Verifica que el archivo de configuración esté en la ubicación correcta
- Revisa que el JSON sea válido (sin errores de sintaxis)
- Reinicia Claude Desktop completamente
- Revisa los logs de Claude Desktop para errores
Respuestas muy largas o timeouts
Solución:
- Usa
maxSentencespara limitar transcripciones - Reduce el
limiten búsquedas y listados - Usa
includeTranscript: falsesi solo necesitas el resumen - Filtra por fechas para reducir el conjunto de datos
Soporte
¿Necesitas ayuda con el servidor MCP?
- Email: support@salescaling.com
- Documentación API: https://api.salescaling.com/api/docs
- Slack de la comunidad: Únete aquí
Recursos Adicionales
Última actualización: Abril 2026