Configuração da ligação MCP
Ligue-se às ferramentas da conta com autenticação e, em seguida, verifique a organização e o inventário de ferramentas.
Ligue o seu assistente à sua conta Lingo.dev e confirme a organização pretendida com um pedido de leitura. O servidor atua em nome do utilizador com sessão iniciada no Lingo.dev.
Ligação à conta #
Defina o URL do servidor remoto como https://mcp.lingo.dev/mcp e selecione HTTP com transmissão em fluxo com OAuth. Inicie o processo de autorização do cliente, entre na conta Lingo.dev pretendida e aprove a ligação. O cliente identifica o servidor de autorização a partir do ponto de acesso MCP e gere as respetivas credenciais de acesso e renovação.
O pedido MCP inclui um token de acesso do utilizador em Authorization: Bearer <access-token>. Este token não é uma chave de API pessoal permanente nem está associado a uma única organização. O serviço de retaguarda verifica se o utilizador tem acesso aos recursos indicados por cada ferramenta. A secção Credenciais da conta explica estas permissões e a gestão das credenciais.
Uma chave de API em x-api-key, ou usada como valor do token de portador, não permite autenticar-se neste servidor alojado. Utilize um cliente que suporte a ligação OAuth do servidor, em vez de copiar uma chave de API para um cabeçalho estático.
Os valores da ligação estão resumidos abaixo. Esta referência não é um ficheiro de configuração específico de um cliente:
{
"endpoint": "https://mcp.lingo.dev/mcp",
"transport": "Streamable HTTP",
"authentication": "OAuth user session"
}Associe estes valores aos campos suportados pelo seu cliente. O armazenamento das credenciais de autenticação e a sintaxe de configuração variam consoante a versão. O ponto de acesso aceita pedidos MCP POST: sem um token válido, devolve 401 com metadados de descoberta OAuth; um pedido GET autenticado devolve 405 Method Not Allowed. Abrir o URL num navegador não permite testar uma ligação MCP inicializada.
URLs alojados existentes #
https://mcp.lingo.dev/main disponibiliza as mesmas ferramentas e permissões do utilizador. O seu processo de descoberta OAuth difere do de /mcp, pelo que uma ligação funcional a /main pode manter a configuração de autorização existente. Ao mudar para /mcp, adicione esse URL como uma nova ligação e conclua o respetivo processo OAuth; não combine as definições de autorização guardadas de uma ligação antiga com o novo URL.
O endereço anterior https://mcp.lingo.dev/account devolve 401 até receber um token de utilizador válido. Depois, devolve 308, redirecionando para /main e preservando o método e o corpo do pedido. Este redirecionamento não restabelece a autenticação por chave de API nem o antigo catálogo de ferramentas associado a uma organização. Ao migrar uma ligação que utilizava uma chave de API, volte a estabelecer a ligação através de OAuth.
Concluir a configuração de uma nova organização #
Ao estabelecer a ligação com uma conta nova, é atribuído um nome à organização na aplicação Web. A pessoa que criou a organização conclui aí mais três passos: integrações, membros da equipa e o primeiro motor, que a aplicação Web preenche com dados do site da organização. Os passos das integrações e dos membros da equipa podem ser ignorados. Enquanto os três passos não estiverem concluídos, todas as ferramentas que indiquem essa organização devolvem um erro que identifica os passos em falta e inclui uma ligação para https://lingo.dev/orgs/<orgId>. Esta ligação abre o passo em que se encontra a pessoa que criou a organização. members_listMemberships continua a listar a organização, permitindo ao assistente encontrar o respetivo ID.
Abra a ligação, conclua os passos e repita a chamada. A partir daí, o assistente funciona normalmente e pode criar mais motores com engines_create ou provisioningJobs_create. Os membros convidados e as organizações criadas antes de este processo de configuração existir não são afetados.
Verificar o âmbito da conta #
- Abra o inventário de ferramentas do cliente e procure
members_listMembershipseengines_list. - Chame
members_listMembershipspara consultar as organizações do utilizador. Se existir apenas uma, utilize-a; se existirem várias, escolha a pretendida e guarde o respetivo ID para esta tarefa. - Chame
engines_listcom oorgIddessa organização e escolha um ID de motor nodatadevolvido. - Leia o esquema disponibilizado por cada ferramenta selecionada antes de a utilizar. As ferramentas ao nível da organização recebem um campo explícito de organização; as ferramentas ao nível do objeto podem receber um ID de recurso em alternativa. Mantenha as operações de escrita dentro do âmbito acordado para a tarefa.
Alternar entre organizações da mesma lista de organizações de que é membro não exige outra ligação OAuth. Indique o ID selecionado no campo declarado pela ferramenta, como orgId ou um id de organização. O servidor não insere uma organização fixa a partir do token. Se a sessão estiver iniciada com o utilizador errado, volte a estabelecer a ligação através da gestão de contas do cliente.
members_listMemberships #
Esta chamada não requer um ID de organização. intent é opcional e descreve a tarefa:
{
"intent": "Find the organization whose French translation guidance I should inspect."
}O campo data da resposta contém as organizações acessíveis, com os respetivos IDs e nomes. As entradas opcionais de ssoRequired identificam organizações de que o utilizador é membro que exigem uma autenticação por SSO ainda não efetuada nesta sessão. Inicie sessão no Lingo.dev através do fornecedor de identidade dessa organização e volte a estabelecer a ligação. Uma organização em ssoRequired ainda não está disponível para chamadas normais ao nível da organização.
Se ambas as listas estiverem vazias, abra https://lingo.dev/orgs/start para configurar a primeira organização e repita esta leitura. Não invente um ID de organização nem crie uma segunda organização apenas porque o acesso a uma organização de que já é membro exige SSO.
engines_list #
Substitua org_example por um ID da resposta com as organizações de que o utilizador é membro:
{
"orgId": "org_example",
"intent": "Find the localization engine used for French translations."
}Utilize um ID de motor do data devolvido nas leituras seguintes ao nível do motor. Estes são os argumentos completos da ferramenta, não estruturas que encapsulam os dados de pedidos HTTP. As ferramentas utilizam o campo opcional intent juntamente com os campos específicos de cada operação. Consulte Capacidades para conhecer as operações da conta.
Onde configurar cada cliente #
Consulte a documentação atual do cliente para conhecer a sintaxe de configuração e os transportes suportados. Estas escolhas são importantes mesmo quando dois clientes utilizam o mesmo ponto de acesso.
Claude Code #
Escolha uma ligação HTTP remota com OAuth para /mcp. Antes de a guardar, decida se a ligação deve ficar na sua configuração de utilizador ou na do projeto. As definições partilhadas no projeto não podem conter credenciais; cada utilizador deve autorizar a ligação à sua própria conta. Verifique o inventário depois de ativar a ligação.
Codex #
O Codex utiliza configuração TOML, geralmente em ~/.codex/config.toml. Configure o URL da conta através do suporte para MCP remoto da sua versão. Não copie JSON de outro cliente para TOML. Se a sua versão exigir uma ponte de transporte, verifique a autenticação e o armazenamento de tokens dessa ponte antes de a utilizar; uma ponte é mais um processo que contém credenciais.
Cursor #
Decida se pretende utilizar as definições ao nível do utilizador ou um .cursor/mcp.json do projeto. Uma ligação de projeto permite que os membros da equipa encontrem a definição do servidor, mas não pode partilhar o valor de uma chave de conta. Cada utilizador deve autorizar a ligação à sua própria conta.
Claude Desktop e claude.ai #
O Lingo.dev está no diretório de conectores do Claude, pelo que não é necessário um URL nem um ficheiro de configuração. Os passos são os mesmos no Claude Desktop e em claude.ai:
- Abra Definições > Personalizar > Descobrir.
- Procure
Lingo.deve clique em Ligar no conector do Lingo.dev. - Na página Autorizar do Lingo.dev, inicie sessão na conta pretendida e clique em Aprovar.
O Claude guarda e renova as credenciais. Verifique o inventário depois de estabelecer a ligação.
ChatGPT #
A disponibilidade de aplicações personalizadas remotas e o suporte para OAuth dependem da conta e da versão do cliente. Quando este suporte estiver disponível, utilize o URL /mcp e autorize o utilizador Lingo.dev pretendido.
Atribuir ao agente uma primeira tarefa bem delimitada #
Um primeiro pedido poderia ser:
Analise o glossário de francês e as instruções do motor de localização selecionado. Explique que recursos estão associados e se contemplam o termo do produto que forneci. Proponha qualquer alteração antes de a aplicar. Esta tarefa não autoriza a tradução, a geração de sugestões, a criação de chaves nem a gestão de membros.
Combine a instrução com a aprovação no cliente ou com uma lista adequada de ferramentas permitidas. Um pedido define o trabalho solicitado, mas não retira as permissões de escrita de uma credencial.
Se a descoberta ou a primeira leitura falhar, consulte Resolução de problemas para resolver a situação antes de continuar.