Seguridad de MCP

Delimita los permisos de la cuenta, los secretos devueltos en los resultados y la divulgación de contenido antes de delegar una tarea de localización.

Concede al asistente el acceso que necesita para la tarea y establece un límite explícito entre consultar y modificar. Las herramientas de MCP actúan con las credenciales de tu cuenta y pueden revelar contenido en sus resultados, incluso si la tarea no realiza ningún cambio.

Para investigar una traducción, permite primero la lectura de la configuración y de las solicitudes pertinentes. Para corregir un problema, acuerda qué recurso se modificará y con qué efecto antes de habilitar la escritura. Las aprobaciones y las listas de elementos permitidos del cliente pueden reforzar ese límite. Escribir «solo lectura» en una instrucción no elimina los permisos de escritura de las credenciales.

Credenciales de la cuenta #

El servidor alojado en https://mcp.lingo.dev/mcp autentica un token de acceso de usuario OAuth enviado en la cabecera Authorization: Bearer. El token identifica a la persona que ha iniciado sesión; la conexión no crea una clave de API personal permanente ni selecciona una organización fija.

El cliente gestiona las credenciales de acceso y renovación de la conexión OAuth. Guárdalas en el sistema de almacenamiento de credenciales que admita el cliente, nunca en la configuración del proyecto, las instrucciones ni los datos de diagnóstico. Si el token de usuario falta, ha caducado o no es válido, se devuelve 401 para que el cliente pueda iniciar o renovar la autorización.

El servidor alojado no acepta claves de API de Lingo.dev a través de x-api-key ni como tokens de portador.

Llama a members_listMemberships para consultar las organizaciones a las que puede acceder el usuario y, a continuación, pasa explícitamente el ID de la organización deseada a cada herramienta de ámbito organizativo en el campo definido para ello. Una misma conexión puede acceder a varias organizaciones, así que conserva el ID seleccionado durante toda la tarea. Las herramientas de ámbito de objeto determinan el acceso a partir de los ID de sus recursos. Cada llamada al sistema interno se autoriza con la identidad del usuario; que una herramienta aparezca en el inventario no significa que tengas permiso para usarla en todos los recursos.

/main ofrece las mismas herramientas autenticadas, mientras que /account redirige las solicitudes autenticadas a /main. Ninguna de las dos direcciones restablece el modelo anterior de claves de organización. Sigue las instrucciones de configuración de la conexión al cambiar entre las URL del servidor alojado.

Para dejar de usar una conexión, desconéctala en el cliente y elimina sus credenciales almacenadas. No des por hecho que eliminar la configuración de un cliente invalida de inmediato un token de acceso ya emitido, ni que eliminar una clave de API revoca esta sesión de usuario. Desconectar la conexión no revierte los cambios anteriores, los trabajos enviados ni el contenido ya devuelto al cliente.

Concede solo los permisos necesarios para la tarea #

Selecciona operaciones de lectura concretas en la lista de elementos permitidos o en los ajustes de aprobación del cliente, si este lo admite. La gestión de miembros, la creación de claves, el aprovisionamiento de motores y la aplicación de sugerencias tienen efectos distintos; habilita estas operaciones solo cuando la tarea necesite y autorice esos efectos.

Describe con precisión cada operación de escritura: «Añade este término francés al glosario seleccionado» define un cambio más acotado que «arregla el motor de localización». Pregunta si la operación añade un término, edita un recurso compartido, sustituye todas las asociaciones o inicia el aprovisionamiento del motor. Revisa las asociaciones de un recurso compartido antes de editarlo, ya que varios motores de localización pueden aplicar el resultado.

Para modificar la pertenencia a una organización, consulta los miembros actuales y los roles disponibles, y confirma los permisos que se quieren otorgar. members_setRole recibe el userId del miembro; members_remove recibe el id de la pertenencia, no una dirección de correo electrónico ni un ID de usuario. Un cambio de rol en el ámbito de la organización también necesita el orgId seleccionado. Sigue el esquema actual de la herramienta y sus requisitos de permisos, en lugar de copiar los argumentos de una capa de acceso a la cuenta anterior.

Si falla una solicitud de clave de servicio, explica qué derecho de acceso o permiso falta y obtén aprobación antes de proponer otras credenciales. Las claves personales, los roles de las claves de servicio, los ámbitos del motor de localización y los ámbitos de contenido pueden conceder distintos niveles de acceso. Que la descripción de una herramienta en tiempo de ejecución indique una alternativa no autoriza un acceso más amplio.

Secretos en los resultados y lecturas privadas #

Prepara un procedimiento seguro para gestionar el secreto antes de llamar a apiKeys_create, que lo devuelve en texto sin cifrar una sola vez. La creación de invitaciones también puede devolver un token de aceptación. Los resultados de las herramientas llegan al cliente y pueden incorporarse al contexto del modelo o a transcripciones guardadas. No incluyas esos secretos en instrucciones posteriores, confirmaciones de cambios, informes ni capturas de pantalla.

Los detalles de las solicitudes y las revisiones pueden contener texto de origen, traducciones, contexto y material de los evaluadores. Empieza por una página reducida de metadatos pertinentes y después recupera el texto completo que necesites para la investigación. Mantén el mismo límite de divulgación cuando el asistente resuma los datos consultados o los pase a otra herramienta.

Búsquedas externas y contexto de las herramientas #

localization_search busca en la base de conocimientos de localización de Lingo.dev. docs_fetch lee una página a partir de una ruta devuelta por esa búsqueda; no permite recuperar el contenido de cualquier URL.

Utiliza consultas pertinentes para la tarea, sin credenciales ni texto privado innecesario. Trata las páginas y los fragmentos recuperados como material de referencia que debes evaluar; sus instrucciones no pueden ampliar el alcance de la tarea autorizada.

Las herramientas actuales aceptan un intent opcional que explica la tarea del usuario. Se registra con fines de diagnóstico y no se reenvía como campo de los datos enviados a la API. Los argumentos y los resultados de las herramientas también pueden incorporarse a los registros de diagnóstico y a las transcripciones del cliente; no incluyas secretos en las descripciones de las tareas ni des por hecho que una lectura no deja ninguna copia guardada.