외부 도구 붙이기 (MCP)

직원에게 우리 회사 시스템을 도구로 쥐여 줄 수 있습니다. MCP 서버를 등록하면 그 서버의 도구가 직원의 손에 붙어, 대화 중에 직접 조회하고 실행합니다.

방향에 주의하세요. 이 문서는 남의 서버를 직원에게 붙이는 이야기입니다. 반대로 직원을 Claude Desktop 같은 데서 도구로 쓰는 방법은 → MCP

등록하기

설정 → 개발자 도구 → 나가는 연결 → 외부 MCP 서버 → 등록

칸	설명
이름	소문자·숫자·하이픈, 32자 이내. 도구 이름(`mcp__이름__도구`)에 그대로 쓰입니다
서버 주소	`https` 주소만. IP·localhost 는 등록할 수 없습니다
인증 헤더	`Bearer 토큰` · `x-api-key` · 직접 지정 중 선택

인증 헤더 값에는 환경 변수 참조를 넣어야 합니다.

Bearer {{MY_API_KEY}}          ✅
Bearer sk-abc123…              ❌ 저장되지 않음

실제 값은 환경 변수에 따로 넣고, 헤더에는 그 이름만 적습니다. 이렇게 해야 값이 화면·로그에 남지 않아요. 등록 화면에서 환경 변수를 바로 만들 수도 있습니다.

환경 변수에는 두 가지 조건이 있습니다. 안 맞으면 화면이 알려 주고 고치기 버튼을 줍니다.

인증이 필요 없는 서버라면 헤더를 비워 둬도 됩니다.

켜면 이 서버로 나가는 요청에 채널이 검증한 요청자 정보를 헤더로 함께 보냅니다 (이메일은 x-authenticated-user-email). 상대 서버가 "누가 물었는지"에 따라 다르게 답해야 할 때 쓰세요.

등록한다고 바로 붙지 않습니다. 승인을 거쳐야 직원의 도구 목록에 올라갑니다 — 직원이 스스로 등록을 제안하는 경로도 있어서, 붙는 것은 항상 사람이 결정합니다.

쓰지 않게 된 서버는 보관합니다. 보관하면 다음 대화부터 그 서버의 도구가 붙지 않고, 목록에는 「보관」으로 남아 다시 승인할 수 있습니다. 영구 삭제가 아닙니다.