Disponible para
-
Todos los planes de Phrase, y sin coste adicional actualmente
El servidor MCP de Phrase (servidor del Protocolo de contexto de modelo) conecta asistentes de IA, como Claude, con Phrase. Lleva la inteligencia lingüística de Phrase a estas herramientas, permitiendo que los asistentes trabajen con proyectos, trabajos y traducciones utilizando un lenguaje natural. El servidor abarca Phrase TMS, Phrase Strings y otras capacidades de Phrase expuestas a través de la API, y opera por encima de estos productos individuales en lugar de dentro de uno de ellos.
Capacidades
El servidor MCP lleva la inteligencia lingüística de Phrase a las herramientas de IA que ya están en uso, lo que permite actuar sobre el contenido, los trabajos y las traducciones con lenguaje natural dondequiera que se realice el trabajo.
Los datos de Phrase Analytics no están disponibles actualmente a través del servidor MCP. Los asistentes de IA conectados a través de MCP no pueden consultar ni recuperar informes o métricas de análisis. Para flujos de trabajo basados en análisis, como la creación de informes automatizados, conéctate directamente a través de Phrase Data.
Las tareas típicas incluyen:
-
Hacer preguntas sobre proyectos y trabajos.
-
Solucionar problemas de calidad en el contenido sin necesidad de abrir archivos o idiomas individuales.
-
Crear trabajos o reasignar proyectos.
-
Realizar actualizaciones masivas en lugar de actualizar los elementos de uno en uno.
-
Crear, editar y eliminar conectores de Phrase TMS.
Opciones de conexión
El servidor MCP admite dos métodos de conexión.
Conexión remota (recomendada)
La conexión remota utiliza el inicio de sesión con una cuenta de Phrase existente y no requiere de instalación alguna. Este método funciona con herramientas de IA que admiten la conexión a un servidor remoto.
La visibilidad de las herramientas en el asistente de IA conectado depende del token de acceso OAuth emitido al iniciar sesión, el cual solo cubre los productos de Phrase a los que el usuario que ha iniciado sesión tiene acceso dentro de la organización de la Plataforma utilizada para conectarse. Si un usuario no tiene acceso a un producto determinado, como Phrase Strings, dentro de esa organización de la Plataforma, las herramientas para ese producto no funcionan aunque aparezcan en la lista. Por ejemplo, una herramienta de búsqueda de Strings puede seguir apareciendo, pero solo busca en la referencia de la API de Strings y no puede acceder a los datos de los proyectos de Strings.
Para resolver la falta de acceso a un producto, primero otorga al usuario acceso al producto dentro de la organización de la Plataforma. Luego, desconecta y vuelve a conectar el servidor MCP en la herramienta de IA para que se emita un nuevo token de acceso que refleje el acceso actualizado.
La conexión remota se autentica mediante OAuth, el único protocolo de autenticación compatible actualmente con este método. Las herramientas de flujo de trabajo personalizadas o de terceros que requieren autenticación manual basada en encabezados no son compatibles actualmente con la conexión remota. Esto incluye tokens de portador, claves de API y credenciales de máquina a máquina (M2M).
Algunas herramientas de IA almacenan sus propias entradas de conexión al servidor por separado de Phrase. Si un intento de inicio de sesión falla con un error del servidor, como «Whitelabel Error Page» o «HTTP 500 Internal Server Error», comprueba la configuración del conector o del servidor de la propia herramienta de IA para detectar una entrada antigua o duplicada del servidor MCP de Phrase. Elimina dicha entrada antes de intentar conectarte de nuevo. Esta comprobación se aplica además de revisar la pestaña Consentimientos en la configuración del perfil de Phrase.
Autenticación obsoleta en VS Code
Visual Studio Code (VS Code) almacena en caché el ID de cliente registrado con un servidor MCP, codificado por la URL del servidor y no por el nombre mostrado. Si ese ID de cliente ha dejado de existir en el servidor de Phrase, VS Code continuará enviando el ID obsoleto en lugar de activar un nuevo registro. Esto resulta en un error «400 Bad Request» que informa de un client_id y redirect_uri no coincidentes, en lugar de llevar a la pantalla de consentimiento esperada. Eliminar y reinstalar la entrada del servidor, o cambiarle el nombre en mcp.json no borrará el registro almacenado en caché, ya que la caché está indexada por la URL del servidor.
Para resolver este problema en VS Code 1.101 o posterior, sigue estos pasos:
-
Abre la paleta de comandos (Ctrl/Cmd+Shift+P) y ejecuta Authentication: Remove Dynamic Authentication Providers, luego selecciona la entrada del servidor MCP de Phrase.
-
Abre el menú , localiza la cuenta vinculada al servidor de Phrase y abre Manage Trusted MCP Servers para revocarla, o cierra la sesión de esa cuenta.
-
En la vista MCP o a través de MCP: List Servers, detén y reinicia la conexión del servidor, o ejecuta Developer: Reload Window.
La siguiente llamada a la herramienta activará un nuevo registro y mostrará la pantalla de consentimiento.
Nota
Si estos pasos no eliminan el registro obsoleto, borra la autenticación almacenada manualmente desde el almacenamiento de credenciales del sistema operativo (SO) (el llavero de macOS, el administrador de credenciales de Windows o libsecret en Linux) y el almacenamiento global de VS Code. Esto borrará la autenticación para cualquier otro servidor MCP configurado.
Conexión autohospedada (obsoleta)
La conexión autohospedada se ejecuta en una infraestructura gestionada por el equipo y requiere Node.js y un archivo de configuración.
Primeros pasos
Encuentra los pasos de configuración completos para ambas opciones de conexión, incluidos los comandos para diferentes herramientas de IA, en el artículo del Centro de desarrolladores del servidor MCP de Phrase.
Después de conectarte, podrás encontrar una lista de prompts iniciales organizados por tarea en el artículo del Centro de desarrolladores Server Starter Prompts.
Permisos
Al conectarse, el titular de la cuenta seleccionará el nivel de acceso concedido al asistente: ver datos, crear datos, o modificar y eliminar datos. Esto se añade a los permisos de rol existentes en Phrase, no en lugar de ellos, por lo que el asistente no podrá ir más allá de lo que la cuenta ya permita.
Los permisos de rol y el consentimiento del conector funcionan de forma independiente, y el más restrictivo de los dos siempre determina el acceso real. Por ejemplo, un usuario con un rol de solo visualización no puede crear, modificar ni eliminar datos a través del asistente, incluso si el cuadro de diálogo de consentimiento otorga acceso para crear, modificar y eliminar datos.
Revisa o revoca el acceso en cualquier momento desde la configuración del perfil de Phrase, en la pestaña .
Un consentimiento existente no se puede editar directamente. Para cambiar el nivel de acceso otorgado a un asistente, el usuario revoca el consentimiento existente desde la pestaña Consentimientos y vuelve a conectarse; para ello, selecciona de nuevo el nivel de acceso deseado en el cuadro de diálogo de consentimiento.
El consentimiento es gestionado individualmente por cada usuario. Un usuario solo ve y controla su propio consentimiento, y no existe una vista de administrador para revisar o gestionar los consentimientos otorgados por otros usuarios.