Claude MCP
Controla Finn desde Claude vía Model Context Protocol.
El Model Context Protocol (MCP) es un estándar abierto que permite a asistentes de IA como Claude invocar herramientas externas. Finn ejecuta un servidor MCP, así que puedes conectar Claude a tu cuenta de Finn y crear agentes de voz describiéndolos en una conversación, en lugar de rellenar el editor a mano.
Qué hace este servidor. Lee tus Finns y crea o edita borradores. Eso es todo. No puede lanzar un Finn, marcar un número, gastar tu saldo, modificar contactos ni leer transcripciones: esas acciones se quedan en el panel a propósito. La sección Alcance más abajo explica por qué.
Para quién es. Para cualquiera que ya use Claude y prefiera describir un agente en lugar de crearlo clic a clic. No necesitas escribir código. Si no usas Claude, no te pierdes nada: el panel hace todo lo que expone este servidor, y más.
Hay exactamente dos formas de conectarse, y solo necesitas una:
| Si usas | Conéctate con | Qué pegas |
|---|---|---|
| Claude en claude.ai o Claude Desktop | Un conector personalizado | Un enlace |
| Claude Code en una terminal | Un comando claude mcp add | Una línea |
Alcance: qué puede y qué no puede hacer el servidor
| Puede | No puede |
|---|---|
| Listar tus Finns y leer cualquiera de ellos completo | Lanzar, pausar o detener un Finn |
| Crear un nuevo Finn como borrador | Realizar, recibir o probar una llamada |
| Editar el nombre, la persona, la voz, el idioma y la frase inicial de un borrador | Editar un Finn que ya se ha lanzado |
| Mostrar a qué organización pertenece tu clave | Comprar o asignar un número de teléfono |
| Explorar el catálogo de voces | Leer transcripciones, grabaciones o analíticas |
| Añadir o eliminar contactos y audiencias | |
| Ver o cambiar la facturación, el monedero o el plan | |
| Eliminar cualquier cosa |
Esto es intencionado y se aplica en dos lugares: el servidor se niega a exponer esas herramientas y el backend rechaza las solicitudes subyacentes aunque algo las pida. El motivo es el enlace del conector que se describe más abajo: ese enlace es en sí una credencial, así que lo peor que puede hacer uno filtrado es leer tus Finns y editar tus borradores. Eso tiene arreglo. «Llamar a mis clientes y gastar mi saldo», no.
La consecuencia para ti: Claude lo crea, tú lo lanzas. Cada Finn llega como borrador; lo revisas en el panel y pulsas el botón.
Paso 1: Genera una clave
En el panel: Configuración → Integraciones → Asistentes de IA (MCP) → Generar clave.
El nombre que le das a la clave es el nombre con el que aparece el conector dentro de Claude, así que ponle el nombre del lugar donde piensas usarla: «portátil del trabajo», «ordenador de casa». Así, dos claves se muestran como dos entradas distinguibles en lugar de dos filas idénticas.
Tu clave tiene el formato finn_mcp_ seguido de una cadena larga. Solo se muestra una vez. Copia lo que necesites antes de cerrar el cuadro de diálogo; si la pierdes, revócala y genera otra.
Algunas cosas que conviene saber sobre las claves:
- Una clave lleva tu identidad. Un Finn creado con tu clave se guarda en tu organización, a tu nombre. Si usas la clave de un compañero, el Finn aparecerá en su cuenta y no podrás encontrarlo.
- No hay alcances ni niveles. Todas las claves pueden hacer todo lo de la lista «Puede» anterior y nada de la lista «No puede».
- La revocación es inmediata. El servidor vuelve a verificar la clave con tu cuenta en cada llamada, así que una clave revocada deja de funcionar en la siguiente solicitud, no al final de una sesión.
Paso 2: conectar Claude
El diálogo que muestra tu nueva clave te ofrece ambas opciones, cada una con un botón de copiar. Elige la que corresponda a tu forma de usar Claude.
Opción 1: app de Claude (claude.ai o Claude Desktop)
Es la que la mayoría necesita. No hay nada que instalar ni que editar.
Copia tu enlace de conector desde el diálogo. Tiene este aspecto, con tu propia clave al final:
https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE
Después, en Claude:
- Abre Customize → Connectors, haz clic en + y elige Add custom connector.
- Pega el enlace como URL del servidor MCP remoto y haz clic en Add. Aparecerá con el nombre de tu clave.
- En un chat nuevo, abre + → Connectors, activa Finn y pídele a Claude que cree un Finn.
Dos cosas que debes saber sobre los planes: el plan Free permite un conector personalizado, y en los planes Team y Enterprise solo un Owner puede añadirlo, desde Organization settings → Connectors; el resto de usuarios solo tiene que hacer clic en Connect.
La contrapartida: un conector personalizado es un único campo de URL sin lugar para una contraseña, así que el enlace es la credencial. Trata la URL completa como tratarías la contraseña de tu panel: no la pegues en un chat, un ticket, una captura de pantalla ni un repositorio.
Opción 2: Claude Code (terminal)
Copia el comando desde el diálogo. Ocupa una sola línea, así que se pega sin problemas en bash, zsh, PowerShell y cmd:
claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"
- Pega el comando en una terminal y ejecútalo.
- Ejecuta
claude. - Pídele que cree un Finn.
Esta forma guarda la clave en un encabezado en lugar de en la URL, lo que la convierte en la más segura de las dos.
Otros clientes MCP
El servidor usa HTTP transmitible (streamable HTTP), no stdio, y no tiene estado: no hay ninguna sesión que abrir ni que caduque. Cualquier cliente compatible con un endpoint MCP por HTTP funciona con cualquiera de las dos vías anteriores: la clave en un encabezado Authorization: Bearer contra /mcp, o la clave como último segmento de la ruta de /mcp/<key>.
claude_desktop_config.json no es una de las opciones. Ese archivo configura servidores MCP locales; el servidor de Finn es remoto, así que se añade como conector personalizado.
Paso 3: comprobar que funciona
Pregúntale a Claude:
"¿Qué Finns tengo?"
Si la conexión funciona, la respuesta incluirá los nombres reales de tus Finns. Si Claude dice que no tiene esa herramienta, consulta Solución de problemas más abajo.
Las herramientas
Hay seis herramientas y Claude elige entre ellas por su cuenta; nunca tienes que nombrar ninguna.
| Herramienta | Qué hace | ¿Escribe? |
|---|---|---|
list_finns | Tus Finns, de más reciente a más antiguo, con id, nombre, estado y caso de uso | No |
get_finn | La configuración completa de un Finn | No |
list_orgs | A qué organización pertenece tu clave y cuál es tu rol | No |
list_voices | El catálogo de voces, filtrable por proveedor y término de búsqueda | No |
create_finn | Crea un nuevo Finn como borrador | Sí — crea un borrador |
update_finn_draft | Edita el nombre, la persona, el caso de uso, el idioma, la voz, la frase inicial o el vocabulario de un borrador | Sí — solo borradores |
Crear un Finn conversando
Pide lo que quieres en lenguaje natural. El diálogo ofrece esta petición como punto de partida:
"Usa el conector de Finn para crear un Finn en borrador llamado Maya que agende citas para una clínica dental: amable, conciso, en inglés."
Una petición más completa se ve así:
"Crea un Finn llamado Skylar que agende llamadas de demostración de 15 minutos para nuestro equipo de ventas. Cálido y conciso, nunca interrumpe y siempre repite al interlocutor la fecha y la hora para confirmarlas. Solo debe hablar de demostraciones y agendamiento; si alguien pregunta por precios, debe ofrecer transferirlo a una persona. Usa una voz femenina amable en inglés."
Para hacerlo, Claude necesita cuatro datos, y te los pedirá si omites alguno:
| Campo | Qué es |
|---|---|
| Nombre | Cómo se llama el Finn |
| Rol e identidad | Quién es y cuál es su trabajo |
| Tono y estilo | Cómo debe hablar |
| Pautas de respuesta | Qué debe y qué no debe hacer |
Opcionalmente, también puedes indicar una etiqueta de caso de uso, un idioma, una voz, una frase inicial y una lista de vocabulario personalizado para los nombres que, de otro modo, pronunciaría mal.
Recibirás un enlace al nuevo borrador, su id y la organización y cuenta en las que se creó. A partir de ahí:
- Abre el enlace y revísalo en el editor.
- Pide cambios a Claude — "acorta la frase inicial", "añade una rama para el buzón de voz" — y editará el borrador directamente.
- Cuando estés conforme, asigna un número y lánzalo en el dashboard. Consulta Implementaciones.
Una pestaña del dashboard que ya estaba abierta no mostrará el nuevo Finn hasta que la recargues.
Voces
Pide una voz describiéndola — "una voz masculina tranquila en inglés" — y Claude buscará en el catálogo por ti.
Un detalle a tener en cuenta: los nuevos Finns se crean en Cartesia, y un id de voz de otro proveedor se guardará sin dar error, pero fallará en una llamada real. Si pides un proveedor concreto, asegúrate de que sea el que realmente usa tu Finn. En Galería de voces encontrarás el catálogo completo.
Seguridad
El enlace del conector es una contraseña. Con la configuración de un solo enlace, la clave va en la URL, así que cualquiera que vea la URL tiene tu acceso. No le hagas capturas de pantalla, no lo pegues en un chat compartido y no lo incluyas en un commit.
Da por hecho que cualquier cosa que pegues queda expuesta. Si una clave ha aparecido en una ventana de chat, un ticket o un correo electrónico, revócala y genera una nueva. No cuesta nada.
Revoca la clave en Settings → Integrations → AI Assistants → Revoke. La revocación se aplica en la siguiente solicitud. Los Finns ya creados no se ven afectados: revocar una clave no elimina nada de lo que se creó con ella.
Una clave para cada lugar. Si usas claves distintas para tu portátil, tu equipo de sobremesa y cada colega, puedes revocar una sin afectar a las demás, y el nombre del conector te indica a qué corresponde cada una.
Comprueba en qué cuenta estás. Si perteneces a más de una organización, pregúntale a Claude "¿en qué organización de Finn estoy?" antes de crear nada. Los nuevos Finns se crean en la última organización a la que te hayas unido.
Solución de problemas
"Claude no tiene ninguna herramienta de Finn"
- En la aplicación de Claude, abre + → Connectors en el chat y comprueba que Finn está activado. Los conectores se activan en cada conversación.
- En Claude Code, reinícialo: lee su configuración de MCP al iniciarse.
- Con un plan Free, comprueba que no hayas usado ya tu único espacio de conector personalizado en otra cosa.
"Este enlace de conector no es válido"
La clave de la URL tiene un formato incorrecto. Debe estar completa, empezar por finn_mcp_, sin nada recortado al final y sin barra ni espacio finales.
"Este enlace de conector se ha revocado"
Esa clave ya no existe. Genera una nueva y actualiza el conector.
"No se pudo conectar con el backend de Finn para verificar tu clave"
Se trata de un problema temporal por nuestra parte, no de un fallo en tu configuración. Vuelve a intentarlo; si persiste, contacta con soporte.
Claude ha creado un Finn, pero no lo encuentras
Casi siempre se debe a que estás en la cuenta equivocada. Pregúntale a Claude "¿en qué organización se ha creado?": la respuesta indica la organización y el correo electrónico al que pertenece la clave. Si no es el tuyo, estás usando la clave de otra persona.
Claude dice que no puede editar un Finn
El Finn ya está lanzado. El servidor solo edita borradores; un Finn activo se edita en el panel.
Siguientes pasos
- Crear un Finn →: el creador del panel y la función de cada campo de la persona.
- Despliegues →: cómo asignar un número y activar un borrador.
- Voice Gallery →: el catálogo completo de voces.
- Integraciones →: webhooks y el resto de las integraciones.
Was this page helpful?
Still stuck or have feedback?
Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.