AI 도구 연결
AI 도구에 Gate를 추가하고, 연결됐는지 첫 질문으로 확인합니다.
이 문서는 Gate에 로그인하고 조회할 데이터의 권한을 확인한 다음 진행합니다. 아직 준비하지 않았다면 첫 조회 시작하기에서 1~2단계를 먼저 마치세요.
AI 도구에 Gate를 추가할 때 쓰는 서버 주소는 다음과 같습니다. Gate는 AI 도구가 외부 데이터를 이용하는 연결 방식인 MCP를 지원합니다.
https://mcp.gate.axlift.io/한 번 연결하면 내가 소속된 고객사를 사용할 수 있습니다. 각 고객사에서 받은 데이터 권한이 적용됩니다. 여러 곳에 소속돼 있다면 질문에 고객사 이름을 함께 적으세요.
Claude 연결하기
아래는 Claude 웹에서 연결하는 순서입니다. 회사 조직 계정에서는 조직 소유자의 등록이나 사용 허용이 먼저 필요할 수 있습니다. Gate가 이미 목록에 있다면 새로 추가하지 말고 연결하세요.
내 커넥터에서 Gate를 찾습니다
Claude의 내 커넥터를 엽니다. 메뉴로 이동한다면 사용자 지정 → 커넥터 → 내 항목을 선택합니다.
목록에 Gate가 있으면 3단계로 이동하세요. 없으면 다음 단계에서 추가합니다.
Gate가 없다면 추가합니다
개인 계정은 추가 → 커스텀 커넥터 추가를 선택합니다. 이름에 Gate, 서버 주소에 위 주소를 붙여넣고 계속을 누릅니다.
인증 설정에서 필요할 때 로그인하는 방식을 선택하고 OAuth 클라이언트는 기본 선택값을 유지한 뒤 추가합니다.
회사 조직 계정은 조직 소유자(Owner 또는 Primary Owner)가 조직 커넥터 설정에서 추가 → Custom → Web을 선택해 등록합니다. 등록이 끝나면 구성원은 내 커넥터 목록에서 Gate를 찾습니다.
추가 메뉴가 보이지 않나요?
회사의 Claude 관리자에게 Gate 등록과 사용 허용을 요청하세요. Claude 조직 소유자와 Gate 조직 관리자는 서로 다른 권한입니다.
Gate 계정으로 연결합니다
Gate 옆의 연결을 누릅니다. 로그인 창이 열리면 회사에서 Gate에 등록한 이메일로 로그인하고, 계정과 접근 범위를 확인한 뒤 허용합니다.
이미 로그인돼 있다면 로그인 화면을 다시 거치지 않을 수 있습니다. 연결 후 커넥터 상세에서 사용할 수 있는 도구가 보이는지 확인하세요. 연결 해제 버튼이 보이면 연결된 상태입니다.
새 대화에서 Gate를 켭니다
새 대화를 열고 입력창의 + → 커넥터에서 Gate가 켜져 있는지 확인합니다. 이 설정은 대화마다 확인하세요.
처음 도구를 실행할 때 Claude가 사용 허용을 물으면 요청 내용을 확인하고 승인합니다. 반복해서 묻는 것이 번거롭다면 커넥터 상세의 도구 권한 설정을 확인하세요. Gate의 원본 조회 도구는 읽기 전용이며, 실제 데이터 접근 범위는 Gate에서 받은 권한을 따릅니다.
첫 질문으로 연결을 확인합니다
아래 질문의 고객사 이름을 실제 이름으로 바꿔 보내세요.
Gate에서 접근 가능한 고객사를 확인하고,
고객사 이름의 조회 가능한 데이터 이름을 알려줘.
목록이 비어 있거나 접근할 수 없으면 그대로 알려줘.여기까지 보이면 연결 완료입니다
답변에 Gate 도구 실행 표시와 예상한 데이터 이름이 함께 나옵니다. 이 질문은 연결과 권한을 확인하는 단계입니다. 실제 데이터 조회는 첫 조회 시작하기의 5단계로 이어가세요.
다른 AI 도구 연결하기
콘솔의 AI 연결 메뉴에서 도구와 컴퓨터 종류를 선택하면 등록 명령, 복사 버튼, 화면 예시를 볼 수 있습니다. 아래는 도구별 진행 방법입니다.
Claude Code와 Codex
콘솔이 보여 주는 등록 명령을 복사해 터미널에서 실행합니다. Claude Code는 /mcp에서 Gate를 골라 연결합니다. Codex는 콘솔이 보여 주는 로그인 명령을 실행합니다.
ChatGPT
설정 → 보안 및 로그인에서 개발자 모드(Developer mode)를 켭니다. 플러그인 메뉴의 + → 앱 만들기에서 서버 주소를 입력하고 인증 방식은 OAuth를 고릅니다. 새 대화의 + → Developer mode에서 Gate 앱을 선택합니다.
Cursor
콘솔의 버튼으로 Cursor를 열면 이름과 주소가 채워집니다. 버튼이 동작하지 않으면 콘솔이 주는 설정을 .cursor/mcp.json에 추가합니다.
다른 MCP 클라이언트
연결 방식은 Streamable HTTP, 인증은 OAuth를 고르고 서버 주소를 입력합니다.
잘 안 될 때
| 증상 | 확인할 것 |
|---|---|
| 추가 버튼을 쓸 수 없습니다 | 회사 계정은 AI 도구 관리자의 등록이나 사용 허용이 필요할 수 있습니다. |
| 로그인이나 접근 허용이 거절됩니다 | Gate에 등록된 이메일로 로그인했는지 확인합니다. 다른 계정이면 로그인 창에서 바꿉니다. |
| 서버에 연결할 수 없다고 나옵니다 | 등록한 주소가 위 서버 주소와 같은지 확인하고 다시 연결합니다. |
| 데이터가 없거나 권한이 없다고 합니다 | AI 연결과 데이터 권한은 별개입니다. 콘솔에서 내 커넥터 권한을 확인합니다. |
| AI가 Gate를 쓰지 않고 설명만 합니다 | 그 대화에서 Gate를 켜고, 질문 앞에 “Gate에서”를 붙여 다시 질문합니다. |
| 연결이 만료됐다고 나옵니다 | AI 도구의 커넥터 목록에서 다시 연결(Reconnect)을 눌러 재인증합니다. |
해결되지 않으면 콘솔 AI 연결 화면 아래의 도움 요청하기에서 요청 내용을 복사해 담당자에게 전달하세요.