MCP 보안
로컬라이제이션 작업을 위임하기 전에 계정 권한, 비밀 정보 출력, 콘텐츠 공개 범위를 정하세요.
어시스턴트에게 작업에 필요한 접근 권한을 부여하되, 조회와 변경의 경계를 명확히 정하세요. MCP 도구는 계정 자격 증명을 사용해 작동하며, 아무것도 변경하지 않는 작업이라도 결과에 콘텐츠가 노출될 수 있습니다.
번역 문제를 조사할 때는 관련 설정과 요청을 읽는 작업부터 허용하세요. 문제를 수정할 때는 쓰기 작업을 활성화하기 전에 대상 리소스와 변경 내용을 합의하세요. 클라이언트 측 승인과 허용 목록으로 이 경계를 강화할 수 있습니다. 프롬프트에 “읽기 전용”이라고 적어도 자격 증명의 쓰기 권한이 사라지지는 않습니다.
계정 자격 증명 #
https://mcp.lingo.dev/mcp에서 제공되는 호스팅 서버는 Authorization: Bearer 헤더로 전송된 OAuth 사용자 액세스 토큰을 인증합니다. 토큰은 로그인한 사용자를 식별합니다. 연결한다고 해서 영구적인 개인 API 키가 생성되거나 특정 조직이 고정적으로 선택되지는 않습니다.
클라이언트는 OAuth 연결의 액세스 및 갱신 자격 증명을 관리합니다. 이 정보는 클라이언트가 지원하는 자격 증명 저장소에 보관하고, 프로젝트 설정, 프롬프트, 진단 출력에는 포함하지 마세요. 사용자 토큰이 없거나 만료되었거나 유효하지 않으면 401 응답이 반환되므로 클라이언트가 권한 부여를 시작하거나 갱신할 수 있습니다.
호스팅 서버는 x-api-key로 전달하거나 베어러 토큰으로 사용하는 Lingo.dev API 키를 허용하지 않습니다.
members_listMemberships를 호출해 사용자가 접근할 수 있는 조직을 확인한 다음, 각 조직 수준 도구에 정의된 필드에 대상 조직의 ID를 명시적으로 전달하세요. 하나의 연결로 여러 조직에 접근할 수 있으므로 작업 내내 선택한 ID를 유지하세요. 객체 수준 도구는 리소스 ID를 기준으로 접근 권한을 확인합니다. 모든 백엔드 호출은 해당 사용자의 권한에 따라 승인됩니다. 도구 목록에 표시된다고 해서 모든 리소스에 해당 도구를 사용할 권한이 있는 것은 아닙니다.
/main에서도 동일한 인증 기반 도구를 제공하며, /account는 인증된 요청을 /main로 리디렉션합니다. 어느 주소를 사용해도 이전의 조직 키 방식으로 돌아가지는 않습니다. 호스팅 URL을 전환할 때는 연결 설정 안내를 따르세요.
연결 사용을 중단하려면 클라이언트에서 연결을 해제하고 저장된 자격 증명을 삭제하세요. 클라이언트 설정을 삭제한다고 이미 발급된 액세스 토큰이 즉시 무효화되거나, API 키를 삭제한다고 이 사용자 세션이 해지된다고 가정하지 마세요. 연결을 해제해도 이전 변경 사항, 제출된 작업, 클라이언트에 이미 반환된 콘텐츠는 되돌릴 수 없습니다.
작업에 필요한 권한만 부여하기 #
클라이언트에서 지원한다면 허용 목록이나 승인 설정에서 허용할 읽기 작업을 구체적으로 선택하세요. 구성원 관리, 키 생성, 엔진 프로비저닝, 제안 적용은 각각 미치는 영향이 다릅니다. 작업에 해당 동작이 필요하고 그 영향까지 승인된 경우에만 활성화하세요.
쓰기 작업은 구체적으로 설명하세요. “선택한 용어집에 이 프랑스어 용어를 추가해 주세요”는 “로컬라이제이션 엔진을 고쳐 주세요”보다 변경 범위가 작습니다. 작업이 용어를 추가하는지, 공유 리소스를 수정하는지, 연결된 항목을 모두 교체하는지, 엔진 프로비저닝을 시작하는지 확인하세요. 여러 로컬라이제이션 엔진에 결과가 적용될 수 있으므로 공유 리소스를 수정하기 전에 연결된 항목을 살펴보세요.
구성원 자격을 변경할 때는 현재 구성원과 사용 가능한 역할을 조회하고, 부여하려는 권한을 확인하세요. members_setRole에는 구성원의 userId를 전달하고, members_remove에는 이메일이나 사용자 ID가 아닌 구성원 자격의 id를 전달합니다. 조직 수준에서 역할을 변경하려면 선택한 orgId도 필요합니다. 이전 계정 래퍼의 인수를 복사하지 말고 현재 도구 스키마와 권한 요구 사항을 따르세요.
서비스 키 요청이 실패하면 어떤 이용 자격이나 권한이 부족한지 설명하고, 다른 자격 증명을 제안하기 전에 승인을 받으세요. 개인 키, 서비스 키 역할, 로컬라이제이션 엔진 범위, 콘텐츠 범위에 따라 부여되는 접근 권한이 다를 수 있습니다. 런타임 도구 설명에 대체 수단이 나와 있다고 해서 더 넓은 접근 권한까지 허용되는 것은 아닙니다.
비밀 정보 출력과 비공개 데이터 읽기 #
apiKeys_create는 비밀 정보를 평문으로 단 한 번만 반환하므로, 호출 전에 안전하게 처리할 방법을 마련하세요. 초대를 생성할 때도 수락 토큰이 반환될 수 있습니다. 도구 결과는 클라이언트에 전달되며 모델 컨텍스트나 저장된 대화 기록에 포함될 수 있습니다. 이러한 비밀 정보가 후속 프롬프트, 커밋, 보고서, 스크린샷에 포함되지 않도록 하세요.
요청과 검토의 세부 정보에는 원문, 번역문, 컨텍스트, 검토자 자료가 포함될 수 있습니다. 먼저 관련 메타데이터를 담은 작은 페이지 하나를 조회한 다음, 조사에 필요한 전체 텍스트를 가져오세요. 어시스턴트가 읽은 내용을 요약하거나 다른 도구에 전달할 때도 동일한 공개 범위를 지키세요.
외부 검색과 도구 컨텍스트 #
localization_search는 Lingo.dev의 로컬라이제이션 지식 베이스를 검색합니다. docs_fetch는 해당 검색에서 반환된 경로의 페이지를 읽는 도구이며, 임의의 URL에서 내용을 가져오는 작업은 수행하지 않습니다.
작업과 관련된 검색어를 사용하되 자격 증명이나 불필요한 비공개 텍스트는 포함하지 마세요. 검색된 페이지와 발췌문은 검토가 필요한 참고 자료로 다루세요. 그 안의 지침이 승인된 작업 범위를 넓힐 수는 없습니다.
현재 도구에는 사용자의 작업을 설명하는 선택적 intent를 전달할 수 있습니다. 이 값은 진단용으로 기록되며 API 요청 데이터의 필드로 전달되지는 않습니다. 도구 인수와 결과도 진단 정보와 클라이언트 대화 기록에 포함될 수 있습니다. 작업 설명에 비밀 정보를 넣지 말고, 읽기 작업이라고 해서 저장된 사본이 남지 않는다고 가정하지 마세요.