Configuración de la conexión MCP

Conéctate a las herramientas de la cuenta mediante autenticación y luego verifica la organización y el inventario de herramientas.

Conecta tu asistente a tu cuenta de Lingo.dev y luego confirma la organización que quieres usar mediante una solicitud de lectura. El servidor actúa en nombre del usuario que inició sesión en Lingo.dev.

Conexión de la cuenta #

Usa https://mcp.lingo.dev/mcp como URL del servidor remoto y selecciona HTTP de transmisión con OAuth. Inicia el flujo de autorización del cliente, inicia sesión en la cuenta de Lingo.dev que quieres usar y aprueba la conexión. El cliente descubre el servidor de autorización a través del punto de conexión MCP y administra 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 sola organización. El servidor verifica el acceso del usuario a los recursos que especifica cada herramienta. Credenciales de la cuenta explica estos permisos y cómo se manejan las credenciales.

Una clave de API en x-api-key, o usada como valor del token de portador, no permite autenticarse en este servidor alojado. Usa un cliente compatible con su conexión OAuth en lugar de copiar una clave de API en un encabezado estático.

A continuación se resumen los valores de conexión. Esta hoja de referencia no es un archivo de configuración específico de un cliente:

json
{
  "endpoint": "https://mcp.lingo.dev/mcp",
  "transport": "Streamable HTTP",
  "authentication": "OAuth user session"
}

Asigna estos valores a los campos que admite 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 de OAuth; una solicitud GET autenticada devuelve 405 Method Not Allowed. Abrir la URL en un navegador no sirve para probar una conexión MCP inicializada.

URLs alojadas existentes #

https://mcp.lingo.dev/main ofrece las mismas herramientas y los mismos permisos de usuario. Su flujo de descubrimiento de OAuth es distinto del de /mcp, por lo que una conexión /main que ya funciona puede conservar su configuración de autorización. Al migrar a /mcp, agrégala como una nueva conexión y completa el flujo OAuth de esa URL; no mezcles la configuración de autorización guardada de una conexión anterior 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 con clave de API ni el antiguo catálogo de herramientas vinculado a una organización. Vuelve a conectarte mediante OAuth al migrar una conexión que tenía una clave de API.

Termina de configurar una nueva organización #

Al conectarse, quien usa una cuenta nueva le asigna un nombre a su organización en la aplicación web. Luego, quien creó la organización completa allí tres pasos adicionales: integraciones, compañeros de equipo y el primer motor, que la aplicación web completa con información del sitio web de la organización. Los pasos de integraciones y compañeros de equipo se pueden omitir. Hasta que se completen los tres pasos, cada herramienta que especifica esa organización devuelve 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 quien 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 luego 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.

Verifica el alcance de la cuenta #

  1. Abre el inventario de herramientas del cliente y busca members_listMemberships y engines_list.
  2. Llama a members_listMemberships para consultar las organizaciones del usuario. Si solo hay una, úsala; si hay varias disponibles, elige la que quieres usar y conserva su ID para esta tarea.
  3. Llama a engines_list con el orgId de esa organización y luego elige un ID de motor del data que devuelve.
  4. Consulta el esquema declarado de cada herramienta seleccionada antes de usarla. 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. Mantén las operaciones de escritura dentro del alcance acordado para la tarea.

Cambiar entre organizaciones de la misma lista de membresías no requiere otra conexión OAuth. Pasa el ID seleccionado en el campo que declara la herramienta, como orgId o un id de organización. El servidor no asigna una organización fija a partir del token. Si la sesión corresponde a otra persona, vuelve a conectarte desde la administración de cuentas del cliente.

members_listMemberships #

Esta llamada no requiere un ID de organización. intent es opcional y describe la tarea:

json
{
  "intent": "Find the organization whose French translation guidance I should inspect."
}

El data de la respuesta contiene las organizaciones a las que tienes acceso, con sus IDs y nombres. Las entradas opcionales de ssoRequired identifican membresías que requieren un inicio de sesión SSO que 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 luego vuelve a conectarte. Una organización 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 luego repite esta lectura. No inventes un ID de organización ni crees una segunda organización solo porque una membresía existente requiere SSO.

engines_list #

Reemplaza org_example por un ID de la respuesta de membresías:

json
{
  "orgId": "org_example",
  "intent": "Find the localization engine used for French translations."
}

Usa un ID de motor del data devuelto para las siguientes lecturas a nivel de motor. Estos son los argumentos completos de la herramienta, no estructuras que envuelven el cuerpo de una solicitud HTTP. Las herramientas usan intent de forma opcional junto con los campos específicos de cada operación. Consulta Funciones para conocer las operaciones de la cuenta.

Dónde configurar la conexión según el cliente #

Consulta la documentación vigente del cliente para conocer su sintaxis de configuración y los transportes compatibles. Estas decisiones importan incluso cuando dos clientes usan el mismo punto de conexión.

Claude Code #

Elige una conexión HTTP remota con OAuth para /mcp. Antes de guardarla, decide si la conexión pertenece a tu configuración de usuario o al proyecto. La configuración compartida del proyecto no debe contener credenciales; cada usuario debe autorizar la conexión de su propia cuenta. Verifica el inventario después de habilitarla.

Codex #

Codex usa una configuración TOML, normalmente en ~/.codex/config.toml. Configura la URL de la cuenta mediante la compatibilidad con MCP remoto que ofrece tu versión. No copies JSON de otro cliente en TOML. Si tu versión requiere un puente de transporte, revisa cómo maneja la autenticación y el almacenamiento de tokens antes de usarlo; un puente es otro proceso que contiene credenciales.

Cursor #

Decide si usar la configuración a nivel de usuario o un .cursor/mcp.json del proyecto. Una conexión de proyecto permite que el equipo descubra la definición del servidor, pero no debe compartir una clave de cuenta escrita directamente en la configuración. 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, así que no necesitas una URL ni un archivo de configuración. Los pasos son los mismos en Claude Desktop y en claude.ai:

  1. Abre Configuración > Personalizar > Descubrir.
  2. Busca Lingo.dev y haz clic en Conectar en el conector de Lingo.dev.
  3. En la página Autorizar de Lingo.dev, inicia sesión en la cuenta que quieres usar y haz clic en Aprobar.

Claude almacena y renueva las credenciales. Verifica 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 estén disponibles, usa la URL /mcp y autoriza al usuario de Lingo.dev que quieres usar.

Dale al agente una primera tarea con límites claros #

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 asociados y si contemplan el término de producto que proporcioné. Propón cualquier cambio antes de aplicarlo. Esta tarea no autoriza traducciones, generación de sugerencias, creación de claves ni administración de miembros.

Complementa la instrucción con una aprobación del lado del 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 lectura, consulta Solución de problemas para resolverlo antes de continuar.