Explorar el centro de ayuda

Conecta tu asistente de IA (MCP)

Mantenido por Vitalii VlasiukCo-founder

Transept ofrece un endpoint MCP al que los asistentes de IA se conectan directamente. Una vez conectado, el asistente puede gestionar todo el flujo de trabajo (importar documentos, ejecutar procesos en distintos idiomas, administrar glosarios y guías de estilo, y consultar resultados), mientras mantienes el control total sobre los permisos y el saldo de palabras.

En esta página

¿Qué es el endpoint MCP?

MCP (Model Context Protocol) es el estándar que utilizan los asistentes de IA para invocar herramientas externas. Transept publica un endpoint para ello, https://app.transept.ai/api/public/v1/mcp, y cualquier asistente que se conecte a él obtiene las mismas capacidades que un script obtendría de la API, presentadas como herramientas que puede invocar de forma autónoma: crear un documento, presupuestar una ejecución, iniciarla, consultar su estado y recuperar las traducciones.

La diferencia práctica frente a copiar y pegar texto en un chatbot es que el asistente trabaja con tus documentos reales, aplicando tus glosarios, tus guías de estilo y tu memoria de traducción. Los resultados se guardan en Transept, donde puedes revisarlos y exportarlos como cualquier otro trabajo.

¿Cómo conecto Claude Code, Claude Desktop o Cursor?

La conexión utiliza el estándar OAuth: añade la URL a tu cliente y, al conectarte por primera vez, se abrirá una ventana del navegador para que apruebes el acceso. Una vez aprobado, el cliente quedará vinculado; no hace falta pegar ninguna clave. En la página de Integraciones de la aplicación encontrarás fragmentos de código listos para usar para cada cliente.

Configuración única para cada cliente MCP.
ClienteConfiguración
Claude CodeEjecuta claude mcp add --transport http transept https://app.transept.ai/api/public/v1/mcp en una terminal
Claude DesktopConfiguración → Conectores → Añadir conector personalizado, pega la URL del endpoint
CursorAñade un servidor con "url": "https://app.transept.ai/api/public/v1/mcp" a su mcp.json
Cualquier otroCualquier cliente MCP que admita HTTP por streaming: vincúlalo a la misma URL

¿Necesito una clave de API?

No es para clientes interactivos: de ellos ya se encarga OAuth. Las claves son para máquinas que no pueden abrir un navegador. En cualquier caso, la conexión aparece en Ajustes → Desarrollador como una entrada revocable, por lo que desconectarla es cuestión de un clic, independientemente de cómo se haya creado.

OAuth o clave de API, según cómo se ejecute el asistente.
Qué vas a conectarQué autenticación usar
Un asistente que utilizas directamente (Claude, Cursor)OAuth: consentimiento en el navegador al conectar por primera vez; no hay que pegar nada
CI, un servidor, un agente headlessUna clave de API de Ajustes → Desarrollador, enviada como encabezado Authorization: Bearer

¿Qué puede hacer el asistente exactamente?

Las herramientas cubren todo el flujo de principio a fin, por lo que en una sola conversación se puede gestionar un documento desde su importación hasta las traducciones revisadas:

  • Importar contenido: documentos pegados o un catálogo de cadenas con claves, contextos y marcadores de posición.
  • Presupuestar cualquier ejecución de forma gratuita, iniciar un flujo de trabajo en todos los idiomas de destino a la vez y consultar el progreso por idioma.
  • Crear y ampliar glosarios, leer guías de estilo y consultar la memoria de traducción antes de traducir.
  • Recuperar los resultados: por bloque en el caso de la prosa, o por ID de cadena en el de los catálogos.
  • Registrar webhooks para que tus propios sistemas reciban un evento firmado en cuanto finalice una ejecución.
  • Lo que queda fuera por diseño: la carga de archivos y las exportaciones binarias (DOCX, XLIFF, TMX) se gestionan a través de la API REST, y la gestión de claves sigue siendo una acción humana en la aplicación; un asistente nunca podrá generar sus propias claves.

¿Cómo se protege mi gasto?

Tres mecanismos de control aplicados directamente por Transept, en lugar de delegar la responsabilidad en el asistente:

  • Permisos. Cada llamada a una herramienta se verifica comparándola con los permisos concedidos: los alcances de la clave o del consentimiento de OAuth. Si una llamada queda fuera de estos, se deniega y se indica el permiso que falta.
  • Estimación y confirmación. Cualquier acción que consuma palabras devuelve primero una estimación y se detiene. La ejecución solo comienza cuando el asistente confirma explícitamente, lo que permite ver el precio en la conversación antes de que se produzca. Los controles de revisión de tus flujos de trabajo siguen pausando la ejecución; para continuar, se requiere una aprobación explícita, ya sea por tu parte o por parte del asistente siguiendo tus instrucciones.
  • Revocación. Puedes interrumpir la conexión en cualquier momento: la siguiente llamada de un asistente revocado será rechazada, esté o no en mitad de una conversación.

¿Puede el contenido entrar y salir sin que yo tenga que entrar en la aplicación?

Sí: vincula la conexión con un activador de webhook y el ciclo se completa. Tu plataforma de correo electrónico, CMS o un script envía el contenido mediante POST a la URL del activador (el cuerpo de la solicitud se convierte en el documento), el flujo de trabajo lo traduce y un webhook o el asistente recupera las traducciones terminadas: diez idiomas de salida por cada plantilla de entrada, sin que nadie tenga que abrir el editor.

Este es el funcionamiento detrás de la localización de plantillas de correo electrónico y el trabajo continuo con catálogos de cadenas: la plataforma envía los cambios, Transept vuelve a traducir solo esa parte y tu flujo de trabajo extrae los resultados. Tu función es la revisión; todo lo mecánico queda delegado.

Preguntas frecuentes

¿Puede el asistente gastar mis palabras sin preguntarme?

No. Cualquier herramienta que inicie una ejecución con coste responde primero con la estimación de palabras y se detiene ahí; el asistente debe confirmar de forma explícita antes de que la ejecución comience, y verás la confirmación en tu chat. Las acciones gratuitas (importar, presupuestar o leer resultados) no necesitan confirmación porque nunca se facturan.

¿Cómo desconecto un asistente?

En Ajustes → Desarrollador. Cada conexión (consentimiento de OAuth o clave pegada) aparece allí como una entrada revocable. Al revocarla, la siguiente llamada del asistente será rechazada; no es necesario realizar ninguna acción adicional en el lado del asistente.

¿Qué clientes MCP son compatibles?

Cualquier cliente que utilice MCP a través de HTTP con streaming es compatible: Claude Code, Claude Desktop, Cursor y los frameworks de agentes más recientes cumplen los requisitos. Los clientes interactivos se conectan mediante OAuth; los que no tienen interfaz envían una clave de API como encabezado Bearer. La URL del endpoint es la misma en ambos casos.

Explorar funciones

¿Necesita más ayuda? Pregunte a Literess en la aplicación o escriba a [email protected].