Segurança do MCP
Defina limites para as permissões da conta, a devolução de segredos e a divulgação de conteúdo antes de delegar uma tarefa de localização.
Conceda ao assistente o acesso necessário para a tarefa, com uma distinção clara entre consultar e alterar. As ferramentas MCP utilizam a credencial da sua conta e podem expor conteúdo nos resultados, mesmo que a tarefa não faça alterações.
Para investigar uma tradução, comece por permitir a leitura da configuração e dos pedidos relevantes. Para fazer uma correção, defina de comum acordo o recurso a alterar e o efeito pretendido antes de permitir a escrita. As aprovações e as listas de permissões do lado do cliente podem reforçar esse limite. Escrever «só de leitura» num pedido ao assistente não retira à credencial as permissões de escrita.
Credenciais da conta #
O servidor alojado em https://mcp.lingo.dev/mcp autentica um token OAuth de acesso de utilizador enviado no cabeçalho Authorization: Bearer. O token identifica a pessoa com sessão iniciada; a ligação não cria uma chave de API pessoal permanente nem seleciona uma organização fixa.
O cliente gere as credenciais de acesso e de renovação da ligação OAuth. Mantenha-as no armazenamento de credenciais suportado pelo cliente, fora da configuração do projeto, dos pedidos ao assistente e dos dados de diagnóstico. Se o token de utilizador estiver em falta, tiver expirado ou for inválido, é devolvido 401 para que o cliente possa iniciar ou renovar a autorização.
O servidor alojado não aceita uma chave de API do Lingo.dev através de x-api-key nem como token de portador.
Invoque members_listMemberships para identificar as organizações a que o utilizador tem acesso e, em seguida, forneça explicitamente o ID pretendido a cada ferramenta ao nível da organização, no campo definido para esse efeito. Uma ligação pode dar acesso a várias organizações, pelo que deve manter o ID selecionado ao longo de toda a tarefa. As ferramentas ao nível do objeto determinam o acesso a partir dos IDs dos respetivos recursos. Cada chamada ao serviço de retaguarda é autorizada em nome do utilizador; a presença de uma ferramenta no inventário não significa que haja permissão para a utilizar em todos os recursos.
/main disponibiliza as mesmas ferramentas autenticadas, enquanto /account redireciona um pedido autenticado para /main. Nenhum dos endereços restabelece o modelo anterior de chaves de organização. Siga as instruções de configuração da ligação ao mudar entre URLs alojados.
Para deixar de utilizar uma ligação, desligue-a no cliente e remova as credenciais armazenadas. Não pressuponha que eliminar uma configuração do cliente invalida imediatamente um token de acesso já emitido, nem que eliminar uma chave de API revoga esta sessão de utilizador. Desligar a ligação não reverte alterações anteriores, tarefas submetidas ou conteúdo já devolvido ao cliente.
Conceda apenas as permissões necessárias à tarefa #
Selecione operações de leitura específicas na lista de permissões ou nas definições de aprovação do cliente, quando disponíveis. A gestão de membros, a criação de chaves, o aprovisionamento de motores e a aplicação de sugestões têm efeitos distintos; ative estas operações apenas quando a tarefa exigir e autorizar esses efeitos.
Descreva cada operação de escrita com precisão: «Adicionar este termo francês ao glossário selecionado» define uma alteração mais limitada do que «corrigir o motor de localização». Pergunte se a operação adiciona um termo, edita um recurso partilhado, substitui todas as associações ou inicia o aprovisionamento de um motor. Consulte as associações de um recurso partilhado antes de o editar, pois vários motores de localização podem aplicar o resultado.
Para alterar a associação de um membro à organização, 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 da associação à organização, não um endereço de e-mail nem um ID de utilizador. Uma alteração de função ao nível da organização também exige o orgId selecionado. Siga o esquema atual da ferramenta e os respetivos requisitos de permissão, em vez de copiar os argumentos de uma camada de abstração de conta anterior.
Se um pedido de chave de serviço falhar, explique que direito de acesso ou permissão está em falta e obtenha aprovação antes de propor outra credencial. As chaves pessoais, as funções das chaves de serviço, os âmbitos dos motores de localização e os âmbitos de conteúdo podem conceder acessos diferentes. Uma alternativa indicada na descrição de uma ferramenta em tempo de execução não autoriza um acesso mais alargado.
Segredos devolvidos e leitura de dados privados #
Defina como tratar os segredos de forma segura antes de invocar apiKeys_create, que devolve um segredo em texto simples uma única vez. A criação de convites também pode devolver um token de aceitação. Os resultados das ferramentas chegam ao cliente e podem ser incluídos no contexto do modelo ou em transcrições guardadas. Não inclua esses segredos em pedidos posteriores ao assistente, alterações submetidas ao repositório, relatórios ou capturas de ecrã.
Os detalhes dos pedidos e das revisões podem conter texto de origem, traduções, contexto e material dos revisores. Comece por uma pequena página de metadados relevantes e, em seguida, obtenha o texto integral necessário para a investigação. Mantenha o mesmo limite de divulgação quando o assistente resumir os dados lidos ou os transmitir a outra ferramenta.
Pesquisas externas e contexto das ferramentas #
localization_search pesquisa na base de conhecimentos de localização do Lingo.dev. docs_fetch lê uma página a partir de um caminho devolvido por essa pesquisa; não permite obter conteúdo de um URL arbitrário.
Utilize consultas relevantes para a tarefa, sem credenciais nem texto privado desnecessário. Trate as páginas e os excertos obtidos como material de referência a avaliar; as instruções que contêm não podem alargar o âmbito da tarefa autorizada.
As ferramentas atuais aceitam um intent opcional que explica a tarefa do utilizador. Este é registado para fins de diagnóstico e não é enviado como campo do corpo de dados da API. Os argumentos e os resultados das ferramentas também podem ficar registados nos dados de diagnóstico e nas transcrições do cliente; não inclua segredos nas descrições de tarefas nem pressuponha que uma operação de leitura não deixa uma cópia guardada.