Claude 및 Claude Code 연결

커스텀 커넥터는 Claude Pro, Max, Team, Enterprise 플랜에서 사용할 수 있습니다.

1. Claude에서 Settings ➤ Connectors를 열거나 claude.ai/settings/connectors로 이동합니다.
2. Add custom connector를 클릭합니다.
3. 이름(예: “Google Docs”)과 서버 URL(예: https://api.gpt.space/servers/google-docs/mcp)을 입력합니다. OAuth 클라이언트 필드는 비워 두세요. 서버가 클라이언트를 직접 등록합니다.
4. Add를 클릭한 다음 Connect를 클릭합니다. Claude가 Google 로그인 페이지를 열면, GPT Workspace에서 사용하는 계정을 선택하고 권한을 수락합니다.

원하는 각 Google 앱마다 이 과정을 반복하세요. 서버당 하나의 커넥터가 필요합니다. 채팅에서 메시지 입력란 아래의 도구 메뉴를 열고 커넥터가 켜져 있는지 확인합니다. 그러면 Claude가 해당 서버의 도구를 나열하고, 요청에 필요할 때 사용합니다.

시도해 보기: “아래 회의록으로 Google 문서를 만들어 줘”, “이번 주 읽지 않은 이메일을 나열해 줘”, “금요일까지 송장을 보내는 작업을 추가해 줘”.

claude mcp add 명령어와 HTTP 트랜스포트를 사용하여 서버를 추가합니다:

claude mcp add --transport http google-sheets https://api.gpt.space/servers/google-sheets/mcp

그 다음 Claude Code 안에서 /mcp를 실행하고, 서버를 선택한 뒤 Authenticate를 선택합니다. 브라우저가 Google 로그인 페이지를 열고, 수락하면 해당 세션에서 도구를 사용할 수 있습니다.

--scope user를 사용하면 모든 프로젝트에서 서버를 사용할 수 있습니다. 각 Google 앱마다 다른 이름과 URL로 명령어를 반복하세요.

• 잠시 후 “Authorization is required” 또는 401 오류가 발생하는 경우: 커넥터를 다시 연결하세요. Claude가 서버를 통해 토큰을 갱신합니다. 계속 실패하면 Authorization is required to perform that action을 참조하세요.
• 도구가 나타나지 않는 경우: 해당 채팅에서 커넥터가 꺼져 있거나 연결이 완료되지 않은 것입니다. 커넥터 페이지를 열고 연결됨으로 표시되는지 확인하세요.
• 잘못된 Google 계정: 커넥터 연결을 해제하고, Google 계정 연결에서 GPT Workspace 권한을 취소한 뒤 올바른 계정을 선택하여 다시 연결하세요.