Configuración de la conexión MCP
Conéctate a las herramientas de la cuenta mediante autenticación y comprueba la organización y el inventario de herramientas.
Conecta tu asistente a tu cuenta de Lingo.dev y confirma que has seleccionado la organización correcta mediante una solicitud de lectura. El servidor actúa en nombre del usuario que ha iniciado sesión en Lingo.dev.
Conexión a la cuenta #
Establece https://mcp.lingo.dev/mcp como URL del servidor remoto y selecciona HTTP transmisible con OAuth. Inicia el proceso de autorización del cliente, accede a la cuenta de Lingo.dev que quieras utilizar y aprueba la conexión. El cliente descubre el servidor de autorización a través del punto de conexión MCP y gestiona sus credenciales de acceso y renovación.
La solicitud MCP incluye un token de acceso de usuario en Authorization: Bearer <access-token>. No es una clave de API personal permanente ni está vinculado a una única organización. El servidor comprueba si el usuario tiene acceso a los recursos que especifica cada herramienta. Credenciales de la cuenta explica estos permisos y cómo se gestionan las credenciales.
Una clave de API en x-api-key, o utilizada como valor del token portador, no permite autenticarse en este servidor alojado. Utiliza un cliente que admita su conexión OAuth en lugar de copiar una clave de API en una cabecera estática.
A continuación se resumen los valores de conexión. Esta ficha no es un archivo de configuración específico de un cliente:
{
"endpoint": "https://mcp.lingo.dev/mcp",
"transport": "Streamable HTTP",
"authentication": "OAuth user session"
}Asigna estos valores a los campos que admita tu cliente. El almacenamiento de las credenciales de autenticación y la sintaxis de configuración varían según la versión. El punto de conexión acepta solicitudes MCP POST: sin un token válido, devuelve 401 con metadatos de descubrimiento OAuth; una solicitud GET autenticada devuelve 405 Method Not Allowed. Abrir la URL en un navegador no sirve para comprobar una conexión MCP inicializada.
URL alojadas existentes #
https://mcp.lingo.dev/main ofrece las mismas herramientas y los mismos permisos de usuario. Su proceso de descubrimiento OAuth difiere del de /mcp, por lo que una conexión /main que ya funcione puede conservar su configuración de autorización. Al pasar a /mcp, añádela como una conexión nueva y completa el proceso OAuth de esa URL; no combines los ajustes de autorización guardados de una conexión antigua con la nueva URL.
La dirección anterior https://mcp.lingo.dev/account devuelve 401 hasta que recibe un token de usuario válido; después, devuelve 308 para redirigir a /main, conservando el método y el cuerpo de la solicitud. Esa redirección no restablece la autenticación mediante clave de API ni el antiguo catálogo de herramientas vinculado a una organización. Al migrar una conexión que utilizaba una clave de API, vuelve a conectarte mediante OAuth.
Completa la configuración de una nueva organización #
Al conectarse, quien utiliza una cuenta nueva da un nombre a su organización en la aplicación web. A continuación, la persona que ha creado la organización completa allí tres pasos adicionales: las integraciones, los miembros del equipo y el primer motor, que la aplicación web configura con la información del sitio web de la organización. Los pasos de integraciones y miembros del equipo se pueden omitir. Hasta que se completen los tres pasos, todas las herramientas que especifican esa organización devuelven un error que indica los pasos pendientes e incluye un enlace a https://lingo.dev/orgs/<orgId>, que abre el paso en el que se encuentra la persona que creó la organización. members_listMemberships sigue mostrando la organización, por lo que el asistente puede encontrar su ID.
Abre el enlace, completa los pasos y repite la llamada. A partir de ahí, el asistente funciona con normalidad y puede crear más motores con engines_create o provisioningJobs_create. Esto no afecta a los miembros invitados ni a las organizaciones creadas antes de que existiera este proceso de configuración.
Comprueba el alcance de la cuenta #
- Abre el inventario de herramientas del cliente y busca
members_listMembershipsyengines_list. - Llama a
members_listMembershipspara consultar las organizaciones del usuario. Si solo hay una, utilízala; si hay varias disponibles, elige la que corresponda y conserva su ID para esta tarea. - Llama a
engines_listcon elorgIdde esa organización y elige un ID de motor deldataque devuelva. - Antes de usar una herramienta seleccionada, lee el esquema que publica. Las herramientas a nivel de organización reciben un campo de organización explícito; las herramientas a nivel de objeto pueden recibir un ID de recurso en su lugar. Limita las operaciones de escritura al alcance acordado para la tarea.
Cambiar entre organizaciones de la misma lista de organizaciones a las que perteneces no requiere otra conexión OAuth. Pasa el ID seleccionado en el campo que declare la herramienta, como orgId o un id de organización. El servidor no introduce una organización fija a partir del token. Si la persona que ha iniciado sesión no es la correcta, vuelve a conectarte desde la gestión de cuentas del cliente.
members_listMemberships #
Esta llamada no necesita un ID de organización. intent es opcional y describe la tarea:
{
"intent": "Find the organization whose French translation guidance I should inspect."
}El data de la respuesta contiene las organizaciones accesibles, con sus ID y nombres. Las entradas opcionales de ssoRequired identifican las organizaciones a las que pertenece el usuario y que requieren un inicio de sesión SSO que aún no se ha realizado en esta sesión. Inicia sesión en Lingo.dev a través del proveedor de identidad de esa organización y vuelve a conectarte. Una organización que figure en ssoRequired aún no está disponible para las llamadas habituales a nivel de organización.
Si ambas listas están vacías, abre https://lingo.dev/orgs/start para configurar la primera organización y repite esta consulta. No inventes un ID de organización ni crees una segunda organización solo porque una a la que ya perteneces requiera SSO.
engines_list #
Sustituye org_example por un ID de la respuesta que enumera las organizaciones a las que pertenece el usuario:
{
"orgId": "org_example",
"intent": "Find the localization engine used for French translations."
}Utiliza un ID de motor del data que devuelva para las consultas posteriores a nivel de motor. Estos son los argumentos completos de la herramienta, no estructuras que envuelvan los datos de una solicitud HTTP. Las herramientas utilizan intent de forma opcional junto con los campos específicos de cada operación. Consulta Capacidades para conocer las operaciones de la cuenta.
Dónde configurar la conexión en cada cliente #
Consulta la documentación actual del cliente para conocer su sintaxis de configuración y los transportes que admite. Estas decisiones importan incluso cuando dos clientes utilizan el mismo punto de conexión.
Claude Code #
Elige una conexión HTTP remota con OAuth para /mcp. Antes de guardarla, decide si debe formar parte de tu configuración de usuario o de la del proyecto. Los ajustes compartidos del proyecto no deben contener credenciales; cada usuario debe autorizar la conexión de su propia cuenta. Comprueba el inventario después de habilitarla.
Codex #
Codex utiliza una configuración TOML, normalmente en ~/.codex/config.toml. Configura la URL de la cuenta mediante las funciones de MCP remoto que admita esa versión. No copies JSON de otro cliente en TOML. Si tu versión requiere un puente de transporte, comprueba cómo gestiona la autenticación y el almacenamiento de tokens antes de usarlo; el puente es otro proceso que maneja credenciales.
Cursor #
Decide si quieres usar los ajustes a nivel de usuario o un .cursor/mcp.json de proyecto. Una conexión de proyecto permite que los miembros del equipo descubran la definición del servidor, pero no debe compartir el valor literal de una clave de cuenta. Cada usuario debe autorizar la conexión de su propia cuenta.
Claude Desktop y claude.ai #
Lingo.dev aparece en el directorio de conectores de Claude, por lo que no necesitas ninguna URL ni archivo de configuración. Los pasos son los mismos en Claude Desktop y en claude.ai:
- Abre Ajustes > Personalizar > Descubrir.
- Busca
Lingo.devy haz clic en Conectar en el conector de Lingo.dev. - En la página Autorizar de Lingo.dev, inicia sesión en la cuenta que quieras utilizar y haz clic en Aprobar.
Claude almacena y renueva las credenciales. Comprueba el inventario después de conectarte.
ChatGPT #
La disponibilidad de aplicaciones personalizadas remotas y la compatibilidad con OAuth dependen de la cuenta y de la versión del cliente. Cuando estas funciones estén disponibles, utiliza la URL /mcp y autoriza al usuario de Lingo.dev que quieras utilizar.
Asigna al agente una primera tarea acotada #
Una primera solicitud podría ser:
Revisa el glosario en francés y las instrucciones del motor de localización seleccionado. Explica qué recursos están vinculados y si contemplan el término del producto que he proporcionado. Propón cualquier cambio antes de aplicarlo. Esta tarea no autoriza la traducción, la generación de sugerencias, la creación de claves ni la gestión de miembros.
Combina la instrucción con una aprobación desde el cliente o una lista adecuada de herramientas permitidas. Una instrucción define el trabajo solicitado, pero no elimina los permisos de escritura de una credencial.
Si falla el descubrimiento o la primera consulta, utiliza Solución de problemas para resolverlo antes de continuar.