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.

Disponible para todas las organizaciones

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.

RequisitoDe dónde sale
Una cuenta de TavnitEl 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ónLa eliges al aprobar la conexión. Solo se ofrecen las organizaciones a las que perteneces y que tienen el acceso MCP activo.
Un cliente MCPclaude.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 rolEl 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.

  1. 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.
  2. 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.
  3. 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.
  4. 4Abre un chat nuevo y pregúntale al asistente qué herramientas de Tavnit tiene. Si te las enumera, el conector está activo.
text
https://mcp.tavnit.io/mcp

Conecta 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.

ClienteCómo
CursorSelecciona 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 CodeEjecuta claude mcp add --transport http tavnit https://mcp.tavnit.io/mcp, luego /mcp → Tavnit → Authenticate.
Claude DesktopSettings → Connectors → Add custom connector con la URL del servidor, y luego Connect.
ChatGPTSettings → 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.
Un inicio de sesión por cliente

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.

Tus datos, tu organización

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ónQué pasa
RevocarEl 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ónLas conexiones que apuntan a esa organización dejan de funcionar por sí solas.
Acceso MCP desactivadoTodas 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íntomaCausaSolución
No aparece la tarjeta Apps de IA en IntegracionesEl 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 MCPSolo perteneces a organizaciones donde está desactivado.Pide al Owner de la organización o a soporte que lo activen.
El asistente dejó de ver TavnitLa 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 equivocadosElegiste 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ónTu 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ónUsa
Diseñar un Flow y sus reglas de limpieza describiéndolosConector MCP
Revisar por qué fallaron los Runs de la semana pasadaConector MCP
Cada factura de un portal de proveedores, todas las nochesAPI REST o un disparador por correo
Tu propio producto necesita los datos extraídosAPI REST más webhooks