Segurança do MCP
Defina limites para as permissões da conta, o retorno de dados sigilosos e a divulgação de conteúdo antes de delegar uma tarefa de localização.
Dê ao assistente o acesso necessário para a tarefa, com uma separação explícita entre consultar e alterar. As ferramentas MCP usam a credencial da sua conta e podem expor conteúdo nos resultados, mesmo quando a tarefa não faz nenhuma alteração.
Para investigar uma tradução, permita primeiro a leitura das configurações e solicitações relevantes. Para fazer uma correção, defina de comum acordo o recurso e o efeito da operação antes de habilitar a gravação. As aprovações e listas de permissões no cliente podem reforçar esse limite. Escrever “somente leitura” em um prompt não remove a permissão de gravação da credencial.
Credenciais da conta #
O servidor hospedado em https://mcp.lingo.dev/mcp autentica um token de acesso de usuário OAuth enviado no cabeçalho Authorization: Bearer. O token identifica a pessoa conectada; a conexão não cria uma chave de API pessoal permanente nem seleciona uma organização fixa.
O cliente gerencia as credenciais de acesso e renovação da conexão OAuth. Mantenha-as no armazenamento de credenciais compatível com o cliente, fora das configurações do projeto, dos prompts e das saídas de diagnóstico. Se o token de usuário estiver ausente, expirado ou inválido, a resposta será 401, para que o cliente possa iniciar ou renovar a autorização.
O servidor hospedado não aceita uma chave de API do Lingo.dev por meio de x-api-key nem como token de portador.
Chame members_listMemberships para encontrar as organizações às quais o usuário tem acesso. Em seguida, informe explicitamente o ID desejado no campo declarado por cada ferramenta que opera no nível da organização. Uma conexão pode acessar várias organizações, por isso mantenha o ID selecionado durante toda a tarefa. As ferramentas que operam no nível do objeto determinam o acesso pelos IDs dos recursos. Cada chamada ao backend é autorizada em nome do usuário; a presença de uma ferramenta no inventário não significa que há permissão para usá-la em todos os recursos.
/main disponibiliza as mesmas ferramentas autenticadas, enquanto /account redireciona uma solicitação autenticada para /main. Nenhum dos endereços restabelece o modelo anterior de chave da organização. Siga as orientações de configuração da conexão ao mudar de uma URL hospedada para outra.
Para deixar de usar uma conexão, desconecte-a no cliente e remova as credenciais armazenadas. Não presuma que excluir uma configuração do cliente invalida imediatamente um token de acesso já emitido, nem que excluir uma chave de API revoga essa sessão de usuário. A desconexão não reverte alterações anteriores, tarefas enviadas ou conteúdo já retornado ao cliente.
Conceda apenas as permissões necessárias para a tarefa #
Selecione operações de leitura específicas na lista de permissões ou nas configurações de aprovação do cliente, quando houver suporte. O gerenciamento de membros, a criação de chaves, o provisionamento de engines e a aplicação de sugestões têm efeitos distintos; habilite essas operações apenas quando a tarefa exigir e autorizar esses efeitos.
Descreva cada operação de gravação com precisão: “Adicione este termo em francês ao glossário selecionado” especifica uma alteração menor do que “corrija o engine de localização”. Pergunte se a operação adiciona um termo, edita um recurso compartilhado, substitui todos os anexos ou inicia o provisionamento de um engine. Inspecione os anexos de um recurso compartilhado antes de editá-lo, pois vários engines de localização podem aplicar o resultado.
Para alterar o vínculo de um membro, consulte os membros atuais e as funções disponíveis e confirme as permissões pretendidas. members_setRole recebe o userId do membro; members_remove recebe o id do vínculo, não um e-mail ou ID de usuário. Uma alteração de função no nível da organização também exige o orgId selecionado. Siga o esquema atual da ferramenta e seus requisitos de permissão, em vez de copiar os argumentos de uma camada de abstração de conta anterior.
Se uma solicitação de chave de serviço falhar, explique qual direito de acesso ou permissão está faltando e obtenha aprovação antes de propor outra credencial. Chaves pessoais, funções de chaves de serviço, escopos de engines de localização e escopos de conteúdo podem conceder acessos diferentes. Uma alternativa prevista na descrição de uma ferramenta em tempo de execução não autoriza um acesso mais amplo.
Retorno de dados sigilosos e leitura de dados privados #
Defina como tratar os dados com segurança antes de chamar apiKeys_create, que retorna um segredo em texto simples uma única vez. A criação de convites também pode retornar um token de aceitação. Os resultados das ferramentas chegam ao cliente e podem entrar no contexto do modelo ou em transcrições salvas. Mantenha esses segredos fora de prompts posteriores, commits, relatórios e capturas de tela.
Os detalhes de solicitações e revisões podem conter texto de origem, traduções, contexto e material dos revisores. Comece com uma página pequena de metadados relevantes e, depois, obtenha o texto completo necessário para a investigação. Mantenha o mesmo limite de divulgação quando o assistente resumir os dados lidos ou os repassar a outra ferramenta.
Pesquisas externas e contexto das ferramentas #
localization_search pesquisa na base de conhecimento de localização do Lingo.dev. docs_fetch lê uma página a partir de um caminho retornado por essa pesquisa; não é uma operação para buscar conteúdo em qualquer URL.
Use consultas relevantes para a tarefa, sem credenciais nem texto privado desnecessário. Trate as páginas e os trechos recuperados como material de referência a ser avaliado; as instruções contidas neles não podem ampliar a tarefa autorizada.
As ferramentas atuais aceitam um intent opcional que explica a tarefa do usuário. Ele é registrado para diagnóstico e não é encaminhado como campo do corpo da requisição à API. Os argumentos e resultados das ferramentas também podem ser incluídos nos diagnósticos e nas transcrições do cliente; não inclua segredos nas descrições das tarefas nem presuma que uma leitura não deixa uma cópia salva.