Claude MCP

El Model Context Protocol (MCP) es un estándar abierto que permite a asistentes de IA como Claude acceder de forma segura a herramientas y fuentes de datos externas. Finn expone un servidor MCP, así que puedes conectar Finn a Claude (o a cualquier cliente compatible con MCP) y hacer que tu asistente de IA consulte, configure y opere la plataforma de forma conversacional.

Para quién es esto. Está pensado para usuarios avanzados: desarrolladores, ingenieros de automatización y operadores con soltura en IA que quieran manejar Finn desde Claude Desktop, Claude Code o cualquier otro cliente MCP. Si no conoces Claude ni MCP, no lo necesitas: el panel hace todo lo que expone el MCP.

Estado: el servidor MCP de Finn está en beta pública. Las API son estables, pero se añaden herramientas nuevas con regularidad.

Qué puedes hacer con el MCP

Una vez conectado, tu Claude (u otra IA compatible con MCP) puede hacer todo lo siguiente en tu nombre:

Operaciones de lectura

• Consultar el estado de cualquier despliegue.
• Listar tus Finns, audiencias y números de teléfono.
• Extraer transcripciones de llamadas y analíticas de cualquier periodo.
• Buscar patrones concretos en el historial de llamadas («muéstrame las llamadas donde el interlocutor mencionó "reembolso"»).
• Consultar costes de despliegue, uso del plan y resúmenes de facturación.

Operaciones de escritura

• Lanzar un nuevo despliegue.
• Pausar o detener un despliegue activo.
• Añadir contactos a una audiencia.
• Actualizar los campos de análisis posterior a la llamada de un Finn.
• Suprimir números (añadirlos a la lista de no llamar).

Coordinación

• Generar informes semanales o mensuales automáticamente.
• Cruzar los resultados de las llamadas con tu CRM para detectar lagunas de atribución.
• Crear automáticamente un despliegue cuando una lista del CRM alcance un tamaño umbral.
• Resumir un despliegue en lenguaje sencillo, apto para compartir con una persona no técnica.

Configurar el servidor MCP

Paso 1: Generar un token MCP

Ajustes → Integraciones → MCP → Generar token.

Copia el token de inmediato: solo se muestra una vez. Guárdalo en tu gestor de contraseñas o almacén de secretos.

Los ámbitos del token son configurables:

• Solo lectura: consultar datos, sin modificarlos
• Lectura y escritura: acceso operativo completo (con cautela)
• Limitado a Finns/audiencias concretos: restringe el acceso a un subconjunto

Para la mayoría de usuarios, empieza con Solo lectura para coger confianza y amplía después.

Paso 2: Configurar tu cliente MCP

Claude Desktop (Mac, Windows):

Edita el archivo de configuración de Claude Desktop:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade el servidor de Finn:

{
  "mcpServers": {
    "finnai": {
      "command": "npx",
      "args": ["-y", "@finnai/mcp-server"],
      "env": {
        "FINNAI_API_TOKEN": "your_token_here"
      }
    }
  }
}

Reinicia Claude Desktop. Las herramientas de Finn quedan disponibles en cualquier conversación.

Claude Code (CLI):

claude mcp add finnai \
  --command "npx -y @finnai/mcp-server" \
  --env FINNAI_API_TOKEN=your_token_here

Luego claude desde cualquier directorio: las herramientas de Finn están disponibles.

Otros clientes MCP (Continue, Cursor, personalizados):

Usa el mismo comando npx en la configuración del servidor MCP de tu cliente. El servidor usa MCP estándar sobre stdio.

Paso 3: probar la conexión

En Claude (cualquier cliente), pregunta:

«¿Qué Finns tengo configurados?»

Si la conexión funciona, Claude llama a la herramienta list_finns y responde con datos reales.

Herramientas que expone el MCP

El servidor ofrece unas 30 herramientas. Las principales:

Gestión de Finns

• list_finns: lista todos los Finns de la cuenta.
• get_finn: obtiene la configuración completa de un Finn.
• create_finn: crea un Finn nuevo (avanzado).
• update_finn: modifica la configuración de un Finn.

Gestión de audiencias

• list_audiences: lista todas las audiencias.
• get_audience_stats: recuentos, estado de validación e importaciones recientes.
• add_contacts: añade contactos de forma masiva.
• remove_contact: elimina un contacto concreto.

Ciclo de vida del despliegue

• list_deployments: lista los despliegues pasados y activos.
• launch_deployment: inicia uno nuevo.
• pause_deployment / resume_deployment / stop_deployment.
• get_deployment_status: estado en vivo con el recuento de llamadas actuales.

Analítica

• get_deployment_analytics: métricas completas de un despliegue.
• search_calls: busca llamadas que coincidan con patrones de contenido.
• get_call: obtiene la transcripción y el análisis de una llamada.
• aggregate_calls: agregados personalizados por cualquier campo y periodo.

Cumplimiento

• add_to_suppression_list: bloquea un número de forma global.
• remove_from_suppression_list: desbloquea.
• check_suppression: ¿está el número en la lista?

Facturación

• get_usage_this_month: gasto acumulado.
• forecast_month_end: proyección según la tendencia.
• set_spend_cap: ajusta los límites.

Esquema completo de cada herramienta: api.hirefinn.ai/academy/mcp.

Cosas que puedes pedirle a Claude

Prompts reales que funcionan:

"Muéstrame los resultados de los despliegues de ayer y dime qué Finn tuvo mejor rendimiento."

"Busca todas las llamadas de la última semana en las que la persona dijo 'demasiado caro' y resume el contexto común."

"Lanza el mismo despliegue del lunes pasado, pero con la nueva audiencia que subí esta mañana."

"¿Cuánto gastamos la semana pasada y vamos según lo previsto frente a nuestro presupuesto?"

"Añade estos números de teléfono a la lista de exclusión: [pegar lista]"

"¿Cuál es la diferencia en la tasa de éxito entre nuestras llamadas de la mañana y las de la tarde?"

"Genera un resumen de 1 página de la campaña de recordatorios de citas del mes pasado para el gerente de la clínica."

El MCP hace que Finn sea conversacional. Operaciones que requerirían de 5 a 10 clics en el panel se convierten en una sola petición en lenguaje natural.

Consideraciones de seguridad

Qué puede hacer el token

Los ámbitos del token determinan lo que está permitido:

• Token de solo lectura → puede consultar todo, pero no modificar nada.
• Lectura + escritura → acceso operativo completo. Trátalo como la contraseña de tu panel.
• Tokens con ámbito limitado → restringidos por ID de Finn, ID de audiencia o tipo de operación.

Buenas prácticas

• No pegues tokens en mensajes de chat. Usa variables de entorno en la configuración de tu cliente MCP.
• Rota los tokens periódicamente. Configuración → Integraciones → MCP → Rotar.
• Usa tokens con ámbito limitado para los miembros del equipo. No des un token de acceso completo a un colaborador externo.
• Registro de auditoría. Cada llamada MCP queda registrada. Configuración → Integraciones → MCP → Registro de actividad.
• Revoca los tokens de inmediato si se filtran. Configuración → Integraciones → MCP → Revocar.

Qué no puede hacer Claude

El MCP no expone:

• Creación/eliminación de cuentas
• Cambios en el método de pago
• Mejoras o reducciones de plan
• Invitaciones a miembros del equipo
• Configuración de SSO

Esto requiere acceso al panel. Es intencionado: son decisiones que conviene que tome una persona.

Aprobar acciones sensibles

De forma predeterminada, el MCP exige aprobación humana explícita (mediante el sistema de permisos de tu cliente MCP) para cualquier operación de escritura:

• Lanzar despliegues
• Añadir o eliminar contactos
• Modificar configuraciones de Finn
• Gastar dinero

Esto se aplica a nivel de protocolo: Claude no puede ejecutar una escritura sin que lo confirmes en la interfaz del cliente. Las operaciones de lectura no requieren aprobación.

Puedes desactivarlo herramienta por herramienta en Configuración → Integraciones → MCP → Lista de aprobación automática si quieres que ciertas herramientas se ejecuten sin confirmación. Úsalo con moderación: aprobar automáticamente "launch_deployment" es una forma real de gastar mucho dinero muy rápido.

Patrones habituales

Reunión diaria

Configura Claude para que recupere las métricas del día anterior cada mañana:

"Cada día laborable a las 9 h, resume los resultados de los despliegues del día anterior, destaca cualquier anomalía y publícalo en mi Slack."

(Requiere Claude Code con tareas programadas, o tu propio cron + envoltorio MCP.)

Detección de anomalías

"Comprueba si algún despliegue de las últimas 24 horas tuvo una tasa de éxito inferior al 50 % o un coste superior al doble de su media de 7 días. Márcalos con los detalles."

Auditoría masiva

"Enumera todos los Finns que no tengan definidos campos de análisis posterior a la llamada. Sugiere valores predeterminados razonables para cada uno según la descripción de identidad del Finn."

Exportaciones rápidas

"Extrae todas las llamadas del despliegue X donde qualified=true, expórtalas como CSV y envíamelas por correo."

Resolución de problemas

"Claude no encuentra las herramientas de Finn"

• Reinicia Claude Desktop después de editar la configuración.
• Comprueba que el JSON de configuración sea válido (comas, comillas).
• Ejecuta npx -y @finnai/mcp-server --test en el terminal para verificar que el servidor arranca.

"Error de autenticación"

• El token caducó o fue revocado. Genera uno nuevo.
• La variable de entorno del token no se está transmitiendo (error tipográfico en la configuración).

"Se agotó el tiempo de espera de la llamada a la herramienta"

• Las consultas grandes (por ejemplo, buscar en el historial de llamadas) pueden tardar más de 30 segundos.
• El tiempo de espera predeterminado en la mayoría de los clientes es de 30 s. Auméntalo si es necesario.

"Permiso denegado para la herramienta X"

• El alcance de tu token no incluye esta herramienta.
• Vuelve a generar un token con mayor alcance, o usa el panel para esa operación.

Novedades previstas

Hoja de ruta de MCP (en el momento de escribir esto):

• Herramientas de flujo de trabajo: crea y edita flujos de trabajo visuales desde Claude.
• Herramienta de llamada de prueba: inicia llamadas de prueba desde Claude.
• Suscripciones en streaming: flujos de eventos en tiempo real para despliegues activos.
• Compatibilidad con varias cuentas: gestiona varias cuentas de Finn desde una sola sesión de Claude.
• Reproducción de grabaciones: transmite el audio de las llamadas a Claude para escucharlo directamente (Enterprise).

Sugiere las herramientas que quieras en [email protected].

Más allá de Claude

Aunque esta página se centra en Claude, el servidor MCP es independiente del proveedor. Funciona con:

• Continue.dev (extensión de IA para VS Code)
• Cursor (IDE centrado en IA)
• OpenAI ChatGPT Desktop (cuando incorpore compatibilidad con MCP)
• Clientes MCP personalizados creados sobre la especificación abierta

Cualquier cliente compatible con MCP puede usar Finn a través del mismo servidor.

Siguiente

• Integraciones → API REST: la API subyacente que envuelve el MCP.
• Integraciones → Webhooks: notificaciones push para flujos de trabajo basados en eventos.
• Capacidad y escala →: los límites de frecuencia que se aplican a las llamadas MCP.