Conector MCP
Qué hace el conector MCP
El conector MCP agrega tu organización de Tavnit como un conjunto de herramientas dentro de un asistente de IA. Una vez conectado, describes lo que necesitas en lenguaje natural y el asistente lo diseña y configura en tu cuenta real: Flows, reglas de limpieza, Buckets, Pipelines, integraciones.
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 https://mcp.tavnit.io/mcp. El conector inicia sesión con tu cuenta de Tavnit (OAuth 2.1), así que no hay ninguna clave ni URL que copiar: el asistente actúa como tú, en la organización que elijas, con tu rol. Funciona con claude.ai (Pro o superior), Claude Code, Claude Desktop, Cursor, ChatGPT (planes de pago) y cualquier otro cliente que soporte servidores MCP remotos con OAuth.
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 acceso MCP está activo en todas las organizaciones de Tavnit. Si la tarjeta Apps de IA no aparece en tu página Integraciones, un administrador lo desactivó para tu organización; contacta a soporte para restaurarlo.
Antes de empezar
Necesitas una cuenta de Tavnit que pertenezca al menos a una organización, y un cliente MCP. Nada más: la conexión se aprueba con tu inicio de sesión, no con una clave.
| Requisito | De dónde sale |
|---|---|
| Una cuenta de Tavnit | El mismo correo y contraseña (o inicio de sesión con Google) que usas en la app. La página de consentimiento te pide iniciar sesión cuando aún no lo has hecho. |
| Una organización | La eliges al aprobar la conexión. Solo se ofrecen las organizaciones a las que perteneces y que tienen el acceso MCP activo. |
| Un cliente MCP | claude.ai en plan Pro o superior, Claude Code, Claude Desktop, Cursor, ChatGPT en un plan de pago, o cualquier cliente que soporte servidores MCP remotos con OAuth. |
| Tu rol | El asistente hereda tu rol en la organización que elegiste, así que solo puede hacer lo que tú puedes hacer. Consulta los roles de usuario. |
Conecta claude.ai
Agrega Tavnit como conector y apruébalo con tu cuenta. No hay nada que instalar ni archivos de configuración que editar.
- 1Abre Integraciones en la barra lateral de Tavnit. La tarjeta Apps de IA muestra la URL del servidor y un botón Agregar a Claude.
- 2Selecciona Agregar a Claude, o en claude.ai ve a Settings → Connectors → Add custom connector e ingresa la URL del servidor de abajo. Deja vacíos el id y el secreto de cliente OAuth.
- 3Selecciona Connect. Se abre una página de Tavnit: inicia sesión si aún no lo has hecho, elige la organización en la que el asistente puede trabajar y aprueba.
- 4Abre un chat nuevo y pregúntale al asistente qué herramientas de Tavnit tiene. Si te las enumera, el conector está activo.
https://mcp.tavnit.io/mcpConecta Cursor, Claude Code, ChatGPT u otro cliente
Todos los clientes usan la misma URL del servidor y el mismo inicio de sesión. Agrégalo como servidor remoto (por URL), no como comando: no hay ningún proceso local que ejecutar.
| Cliente | Cómo |
|---|---|
| Cursor | Selecciona Agregar a Cursor en la página Integraciones, o agrega {"mcpServers":{"tavnit":{"url":"https://mcp.tavnit.io/mcp"}}} a ~/.cursor/mcp.json. Luego abre Settings → Tools & MCP y selecciona Login en la entrada de Tavnit. |
| Claude Code | Ejecuta claude mcp add --transport http tavnit https://mcp.tavnit.io/mcp, luego /mcp → Tavnit → Authenticate. |
| Claude Desktop | Settings → Connectors → Add custom connector con la URL del servidor, y luego Connect. |
| ChatGPT | Settings → Connectors → Add custom connector (puede requerir el modo desarrollador). Ingresa la URL del servidor, elige OAuth y deja vacíos los campos de cliente, luego Connect. |
Cada cliente tiene su propia conexión, aprobada por separado. Todas actúan como tú, en la organización que elegiste para cada una, y cada una se puede revocar por su cuenta.
Qué puede hacer tu asistente
A través del conector, el asistente diseña, configura e integra: crea Flows y sus campos, agrega reglas de limpieza, configura Buckets, Inspectores, Fillers, Subjects y Pipelines, y conecta los resultados a webhooks, correo y herramientas sin código. También lee tus Runs y resultados para validar un diseño.
El procesamiento se queda donde está: los documentos se suben y los Runs se inician en la app de Tavnit, por correo o a través de la API, y las revisiones se aprueban en la app. El conector nunca consume créditos.
Una conexión llega solo a la organización que elegiste al aprobarla. Para trabajar con otra organización, desconecta la app y vuelve a conectarla: te pedirá elegir de nuevo.
Administrar y revocar conexiones
La lista Apps de IA conectadas de la página Integraciones muestra cada app que aprobaste, cuándo y para qué organización. Revocar una corta su acceso de inmediato.
| Acción | Qué pasa |
|---|---|
| Revocar | El acceso de la app termina de inmediato. Su siguiente solicitud falla hasta que la vuelvas a conectar desde la app, que te pedirá iniciar sesión y elegir una organización. |
| Salir de una organización | Las conexiones que apuntan a esa organización dejan de funcionar por sí solas. |
| Acceso MCP desactivado | Todas las conexiones a esa organización dejan de funcionar hasta que se vuelva a activar. |
Revocar es inmediato y no se puede deshacer: hay que volver a conectar la app. Hazlo cuando puedas reconectarla enseguida, o cuando quieras cortar el acceso de forma definitiva.
Seguridad
Las conexiones son OAuth 2.1 estándar: tokens de corta duración que el cliente renueva por su cuenta, aprobados en una página que tú controlas, revocables en cualquier momento.
- Nada que copiar ni guardar: no hay ninguna credencial que pegar en un cliente, así que no hay nada que se pueda filtrar en un ticket, un chat o una captura de pantalla.
- El asistente actúa con tu rol en la organización que elegiste, y nunca puede hacer más de lo que tú puedes en la app.
- El procesamiento, las revisiones y los créditos se quedan en la app; el conector solo diseña y configura.
- Tu API key es aparte. Los scripts y automatizaciones la siguen usando; el conector no.
Solución de problemas
La mayoría de los problemas del conector son uno de cuatro: la conexión fue revocada, tu membresía o rol cambió, el acceso MCP está desactivado, o el cliente conserva una conexión antigua a otra organización.
| Síntoma | Causa | Solución |
|---|---|---|
| No aparece la tarjeta Apps de IA en Integraciones | El acceso MCP está desactivado para tu organización. | Contacta a soporte para que lo activen. |
| La página de consentimiento dice que ninguna de tus organizaciones tiene acceso MCP | Solo perteneces a organizaciones donde está desactivado. | Pide al Owner de la organización o a soporte que lo activen. |
| El asistente dejó de ver Tavnit | La conexión fue revocada, o tu membresía cambió. | Elimina el conector en el cliente y agrégalo de nuevo. |
| El asistente ve los datos equivocados | Elegiste otra organización al aprobar. | Revoca la conexión en Integraciones, reconecta y elige la organización correcta. |
| El asistente no puede realizar una acción | Tu rol no lo permite. | Revisa tu rol antes de asumir una falla del conector. |
Cuándo usar el conector en lugar de la API
Usa el conector para el trabajo conversacional: diseñar un Flow, agregar una regla, revisar resultados, conectar una integración. Usa la API REST para todo lo programado, de alto volumen o integrado en otro sistema, donde necesitas manejo explícito de errores y reintentos.
| Situación | Usa |
|---|---|
| Diseñar un Flow y sus reglas de limpieza describiéndolos | Conector MCP |
| Revisar por qué fallaron los Runs de la semana pasada | Conector MCP |
| Cada factura de un portal de proveedores, todas las noches | API REST o un disparador por correo |
| Tu propio producto necesita los datos extraídos | API REST más webhooks |
