Configuração da conexão MCP

Conecte-se às ferramentas autenticadas da conta e verifique a organização e o inventário de ferramentas.

Conecte seu assistente à sua conta Lingo.dev e confirme a organização desejada com uma solicitação de leitura. O servidor atua em nome do usuário conectado ao Lingo.dev.

Conexão com a conta #

Defina a URL do servidor remoto como https://mcp.lingo.dev/mcp e selecione HTTP com streaming com OAuth. Inicie o fluxo de autorização do cliente, entre na conta Lingo.dev desejada e aprove a conexão. O cliente identifica o servidor de autorização a partir do endpoint MCP e gerencia as credenciais de acesso e renovação.

A solicitação MCP envia um token de acesso do usuário em Authorization: Bearer <access-token>. Esse token não é uma chave de API pessoal permanente nem está vinculado a uma única organização. O backend verifica o acesso do usuário aos recursos especificados por cada ferramenta. Credenciais da conta explica essas permissões e como as credenciais são tratadas.

Uma chave de API em x-api-key, ou usada como valor do token de portador, não autentica este servidor hospedado. Use um cliente compatível com a conexão OAuth do servidor em vez de copiar uma chave de API para um cabeçalho estático.

Os valores da conexão estão resumidos abaixo. Esta tabela de referência não é um arquivo de configuração específico de um cliente:

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

Associe esses valores aos campos aceitos pelo seu cliente. O armazenamento das credenciais de autenticação e a sintaxe de configuração variam conforme a versão. O endpoint aceita solicitações MCP POST: sem um token válido, retorna 401 com metadados de descoberta OAuth; uma solicitação GET autenticada retorna 405 Method Not Allowed. Abrir a URL em um navegador não testa uma conexão MCP inicializada.

URLs hospedadas existentes #

https://mcp.lingo.dev/main disponibiliza as mesmas ferramentas e permissões do usuário. Seu fluxo de descoberta OAuth é diferente do de /mcp, por isso uma conexão /main que já funciona pode manter a configuração de autorização atual. Ao migrar para /mcp, adicione essa URL como uma nova conexão e conclua o fluxo OAuth correspondente; não combine as configurações de autorização salvas de uma conexão antiga com a nova URL.

O endereço anterior https://mcp.lingo.dev/account retorna 401 até receber um token de usuário válido; depois, retorna 308 para /main, preservando o método e o corpo da solicitação. Esse redirecionamento não restaura a autenticação por chave de API nem o antigo catálogo de ferramentas vinculado à organização. Ao migrar uma conexão que usava uma chave de API, reconecte-se via OAuth.

Conclua a configuração de uma nova organização #

Ao se conectar, quem cria uma conta define o nome da organização no aplicativo web. Em seguida, o criador da organização conclui mais três etapas no aplicativo: integrações, colegas de equipe e o primeiro engine, que o aplicativo preenche com base no site da organização. As etapas de integrações e colegas de equipe podem ser puladas. Até que as três etapas sejam concluídas, toda ferramenta que especificar essa organização retornará um erro com as etapas pendentes e um link para https://lingo.dev/orgs/<orgId>, que abre a etapa atual do criador. members_listMemberships continua listando a organização, permitindo que o assistente encontre seu ID.

Abra o link, conclua as etapas e repita a chamada. Depois disso, o assistente funciona normalmente e pode criar mais engines com engines_create ou provisioningJobs_create. Membros convidados e organizações criadas antes da implementação desse processo de configuração não são afetados.

Verifique o escopo da conta #

  1. Abra o inventário de ferramentas do cliente e localize members_listMemberships e engines_list.
  2. Chame members_listMemberships para consultar as organizações do usuário. Se houver apenas uma, use-a; se houver várias, escolha a desejada e guarde seu ID para esta tarefa.
  3. Chame engines_list com o orgId dessa organização e escolha um ID de engine no data retornado.
  4. Leia o esquema disponibilizado por cada ferramenta selecionada antes de usá-la. Ferramentas no nível da organização recebem um campo explícito de organização; ferramentas no nível do objeto podem receber um ID de recurso em vez disso. Mantenha as operações de gravação dentro do escopo acordado para a tarefa.

Alternar entre organizações na mesma lista de vínculos não exige outra conexão OAuth. Informe 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 conta conectada não for a correta, reconecte-se pelo gerenciamento de contas do cliente.

members_listMemberships #

Esta chamada não exige um ID de organização. intent é opcional e descreve a tarefa:

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

O data da resposta contém as organizações acessíveis, com seus IDs e nomes. As entradas opcionais em ssoRequired identificam vínculos que exigem uma autenticação via SSO ainda não realizada nesta sessão. Entre no Lingo.dev pelo provedor de identidade dessa organização e reconecte-se. Uma organização em ssoRequired ainda não está disponível para chamadas comuns no nível da organização.

Se as duas 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 só porque um vínculo existente exige SSO.

engines_list #

Substitua org_example por um ID da resposta de vínculos:

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

Use um ID de engine do data retornado para as próximas leituras no nível do engine. Esses são argumentos completos da ferramenta, não estruturas que encapsulam o corpo de uma solicitação HTTP. As ferramentas usam o campo opcional intent junto com os campos específicos de cada operação. Consulte Recursos para conhecer as operações da conta.

Onde configurar em cada cliente #

Consulte a documentação atual do cliente para conhecer a sintaxe de configuração e os transportes compatíveis. Essas escolhas são importantes mesmo quando dois clientes usam o mesmo endpoint.

Claude Code #

Escolha uma conexão HTTP remota com OAuth para /mcp. Antes de salvar, decida se a conexão ficará na sua configuração de usuário ou na do projeto. Configurações compartilhadas no projeto não devem conter credenciais; cada usuário deve autorizar a conexão com sua própria conta. Verifique o inventário depois de habilitar a conexão.

Codex #

O Codex usa configuração TOML, geralmente em ~/.codex/config.toml. Configure a URL da conta usando o suporte a MCP remoto da sua versão. Não copie JSON de outro cliente para o TOML. Se a sua versão exigir uma ponte de transporte, verifique como ela autentica e armazena tokens antes de usá-la; a ponte é mais um processo que mantém credenciais.

Cursor #

Escolha com cuidado entre as configurações do usuário e um .cursor/mcp.json do projeto. Uma conexão de projeto permite que colegas de equipe encontrem a definição do servidor, mas não deve compartilhar uma chave de conta inserida diretamente na configuração. Cada usuário deve autorizar a conexão com sua própria conta.

Claude Desktop e claude.ai #

O Lingo.dev está no diretório de conectores do Claude, então não é necessário usar uma URL nem um arquivo de configuração. As etapas são as mesmas no Claude Desktop e em claude.ai:

  1. Abra Configurações > Personalizar > Descobrir.
  2. Pesquise por Lingo.dev e clique em Conectar no conector do Lingo.dev.
  3. Na página Autorizar do Lingo.dev, entre na conta desejada e clique em Aprovar.

O Claude armazena e renova as credenciais. Verifique o inventário depois de se conectar.

ChatGPT #

A disponibilidade de aplicativos personalizados remotos e o suporte a OAuth dependem da conta e da versão do cliente. Quando esse suporte estiver disponível, use a URL /mcp e autorize o usuário Lingo.dev desejado.

Dê ao agente uma primeira tarefa com escopo delimitado #

Uma primeira solicitação poderia ser:

Examine o glossário de francês e as instruções do engine de localização selecionado. Explique quais recursos estão vinculados e se eles contemplam o termo do produto que forneci. Proponha qualquer alteração antes de aplicá-la. Esta tarefa não autoriza tradução, geração de sugestões, criação de chaves nem gerenciamento de membros.

Combine a instrução com a aprovação no cliente ou uma lista adequada de ferramentas permitidas. Um prompt define o trabalho solicitado, mas não retira as permissões de gravação de uma credencial.

Se a descoberta ou a primeira leitura falhar, consulte Solução de problemas para resolver a falha antes de continuar.