Conector MCP
Qué hace el conector MCP
El conector MCP agrega tu organización de Tavnit como una herramienta dentro de un asistente de IA. Una vez conectado, puedes preguntarle al asistente sobre tus datos de Tavnit en lenguaje natural, y te responde a partir de tu cuenta real en lugar de adivinar.
MCP (Model Context Protocol) es el estándar abierto que permite a los asistentes de IA usar herramientas externas. Tavnit tiene un servidor MCP en mcp.tavnit.io, y la URL del conector es la credencial que dirige a un cliente hacia tu organización. Funciona con claude.ai (Pro o superior), Cursor y cualquier otro cliente que acepte la URL de un servidor MCP remoto.
Para saber para qué sirve el conector y cómo se compara con pegar un archivo en un chat, consulta la descripción general del conector MCP.
El conector se activa por organización. Si no ves la tarjeta Conector Personalizado en la página Integraciones, contacta a soporte para que lo habiliten en tu organización.
Antes de empezar
Necesitas tres cosas: una organización con el conector habilitado, tu API key y un cliente MCP. El conector se emite a partir de tu propia key, así que solo llega a la organización en la que estabas al generarlo, y el asistente actúa con esa key.
| Requisito | De dónde sale |
|---|---|
| Tarjeta “Conector Personalizado” | En la página Integraciones, solo cuando el conector está habilitado para tu organización. Si no aparece, pídelo a soporte. |
| Tu API key | La tarjeta Clave API de la misma página: una key por miembro y por organización. Si dice No se encontró clave API. Por favor inicia sesión nuevamente., cierra sesión y vuelve a iniciarla. |
| Un cliente MCP | claude.ai con un plan Pro o superior, Cursor o cualquier cliente que acepte la URL de un servidor MCP remoto. |
| Tu rol | El asistente usa tu API key, así que solo puede hacer lo que tu key permite. Por ejemplo, las solicitudes de procesamiento rechazan la key de un rol Solo HITL. Consulta roles de usuario y la página de la API. |
Conecta claude.ai
Genera la URL en Tavnit y pégala en claude.ai como conector personalizado. No hay nada que instalar ni archivos de configuración que editar.
- 1Abre Integraciones en la barra lateral de Tavnit. Revisa primero el selector de organización: el conector queda vinculado a la organización en la que estés.
- 2En la tarjeta Conector Personalizado, selecciona Generar URL del conector.
- 3Copia la URL con el botón de copiar.
- 4En claude.ai, ve a Settings → Connectors → Add custom connector y pega la URL.
- 5Abre un chat nuevo y pregúntale al asistente qué herramientas de Tavnit tiene. Si te las enumera, el conector está activo.
Conecta Cursor u otro cliente MCP
Cualquier cliente compatible con servidores MCP remotos acepta la misma URL. Agrégala como servidor remoto (por URL), no como uno basado en comandos: no hay ningún proceso local que ejecutar, porque el conector apunta a un servidor alojado.
- 1Genera y copia la URL del conector desde la página Integraciones, como arriba.
- 2En Cursor, abre la configuración de MCP y agrega un servidor nuevo de tipo remoto / URL.
- 3Pega la URL del conector como URL del servidor. No hace falta un campo aparte para la API key: la URL ya lleva la credencial.
- 4Recarga el cliente y confirma que Tavnit aparece en su lista de herramientas.
Tienes una sola URL de conector a la vez y puedes pegarla en más de un cliente. Todos actúan como tú en la misma organización, así que al actualizarla se desconectan todos a la vez.
Qué puede hacer tu asistente
A través del conector, el asistente trabaja con los datos de Tavnit de tu organización usando tu API key. Crear y configurar Flows, Cleaners, Pipelines y tu equipo sigue haciéndose en la app.
Tu cliente MCP muestra las herramientas que ofrece el conector, y la forma más rápida de verlas es preguntarle al asistente. Pregunta en lenguaje natural y nombra el Flow, el Bucket o el run al que te refieres tal como aparece en la app.
El conector solo llega a la organización en la que se generó. Para trabajar con otra organización, cámbiate a ella en Tavnit y genera una URL ahí. Lo que el asistente inicia sigue tu configuración como cualquier otro Run: si un Flow pide Revisión Humana, el Run la sigue esperando.
Vencimiento y actualización
Las URLs del conector tienen una vigencia limitada. La tarjeta Conector Personalizado muestra cuándo se creó la URL y cuánto le queda, y te avisa en sus últimas 24 horas. Al actualizarla se emite una URL nueva y la anterior queda invalidada de inmediato.
| Estado | Lo que ves | Qué hacer |
|---|---|---|
| Activa | La URL, la fecha de creación y los días que le quedan. | Nada. |
| Vence pronto (menos de 24 horas) | El tiempo restante en horas o minutos y un aviso ámbar: El conector expira pronto — actualiza ahora para evitar interrupciones. | Actualízala y pega la URL nueva en cada cliente que la use. |
| Vencida | Un aviso rojo: Este conector ha expirado. Actualiza para generar una nueva URL. | Actualízala y vuelve a pegarla. Los clientes con la URL anterior ya dejaron de funcionar. |
Para actualizarla, selecciona Actualizar URL y confirma con Actualizar en el diálogo ¿Actualizar URL del conector?.
Actualizar no es una rotación que puedas escalonar. En cuanto confirmas, la URL anterior deja de funcionar y todos los asistentes que la usan fallan hasta que pegues la nueva. Actualízala cuando puedas cambiar los clientes enseguida.
Trata la URL como una contraseña
La URL del conector es una credencial. Cualquiera que la tenga puede acceder a los datos de tu organización como si fuera tú, sin iniciar sesión. Es seguro pegarla en la configuración de un cliente MCP; no lo es compartirla en un ticket, un mensaje de chat o una captura de pantalla.
- No la subas a un repositorio ni la pegues en un documento compartido.
- Difumínala o recórtala de cualquier captura de pantalla antes de compartirla.
- Si se filtra, actualízala de inmediato: eso invalida la URL expuesta al instante.
- Regenerar tu API key es una acción aparte en la misma página; hazlo también si crees que la key quedó expuesta.
Solución de problemas
Casi todos los problemas del conector se deben a una de cuatro cosas: la función no está habilitada, la sesión caducó, la URL venció o el cliente tiene una URL que se reemplazó al actualizarla.
| Síntoma | Causa | Solución |
|---|---|---|
| No aparece la tarjeta Conector Personalizado en Integraciones | El conector no está habilitado para tu organización. | Contacta a soporte para que lo activen. |
Los conectores personalizados requieren una sesión válida de Tavnit. Intenta cerrar sesión y volver a iniciarla. | Tavnit no pudo validar tu key para emitir o leer la URL. | Cierra sesión, vuelve a iniciarla y genera la URL de nuevo. |
| El asistente dejó de ver Tavnit | La URL venció o alguien la actualizó. | Revisa si la tarjeta muestra un aviso de vencida o por vencer, actualízala y vuelve a pegarla en cada cliente. |
| El asistente ve datos equivocados | La URL se generó cuando estabas en otra organización. | Cámbiate de organización en Tavnit, genera una URL nueva y reemplaza la anterior. |
| El asistente no puede realizar una acción | Tu rol no lo permite. | Revisa tu rol antes de suponer que falla el conector. |
Cuándo usar el conector en lugar de la API
Usa el conector para trabajo conversacional y puntual: preguntas sueltas, explorar datos guardados, revisiones rápidas. Usa la API REST para todo lo programado, de alto volumen o integrado en otro sistema, donde necesitas manejo de errores y reintentos explícitos.
| Situación | Usa |
|---|---|
| Un colega pregunta cuánto facturó un proveedor el trimestre pasado | Conector MCP |
| Quieres explorar tus datos en un chat | Conector MCP |
| Todas las facturas de un portal de proveedores, cada noche | API REST o un disparador por correo |
| Tu propio producto necesita los datos extraídos | API REST más webhooks |