본문으로 건너뛰기
MarcommAI

마컴을 Gemini Enterprise에 연결하기

Google Cloud 관리자가 마컴 MCP 서버를 Gemini Enterprise의 커스텀 MCP 서버로 추가하면, 구성원이 Gemini에서 자기 계정으로 마컴을 쓸 수 있습니다. Gemini CLI는 확장으로 연결합니다.

  1. 1
    Google Cloud에서 Discovery Engine Editor 역할이 있는지 확인합니다. Gemini Enterprise 앱을 열고 Connected data stores에서 Custom MCP server를 추가합니다.
  2. 2
    MCP Server URL에 https://app.marcomm.works/api/mcp 를 넣습니다. 마컴은 Gemini Enterprise가 받는 유일한 전송 방식인 Streamable HTTP로 응답합니다.
  3. 3
    Authorization URL에 https://marcomm.works/oauth/authorize (파라미터 없이), Token URL에 https://marcomm.works/api/oauth/token 를 넣습니다.
  4. 4
    Client ID는 터미널에서 아래 명령을 한 번 실행해 응답의 client_id를 복사합니다: curl -X POST https://marcomm.works/api/oauth/register -H "Content-Type: application/json" -d '{"client_name":"Gemini Enterprise","redirect_uris":["https://vertexaisearch.cloud.google.com/oauth-redirect"]}'
  5. 5
    Client Secret에는 unused 같은 아무 문자나 넣습니다. 마컴은 비밀을 발급하지도 확인하지도 않고, 로그인은 PKCE로 지킵니다.
  6. 6
    Scopes에 read write 를 넣습니다(read 만 넣으면 읽기 전용). Enable PKCE Support와 Use HTTP Basic Authentication을 모두 켭니다.
  7. 7
    에이전트 이그레스 허용 목록에 app.marcomm.works / marcomm.works 를 추가하고 저장합니다. 누군가 처음 마컴 도구를 쓰면 Gemini가 마컴 로그인, 워크스페이스 선택, 허용 를 안내합니다.

Gemini CLI는 gemini extensions install https://github.com/alex-digitalog/marcomm-gemini-extension 를 실행합니다.

구성원은 Claude · ChatGPT와 똑같이 자기 이름으로, 워크스페이스에서 자기 역할이 허용하는 범위만 씁니다. 설정 → MCP 연결 의 워크스페이스 설정은 Gemini에도 적용됩니다.

Gemini Enterprise용으로는 리디렉션 주소 https://vertexaisearch.cloud.google.com/oauth-redirect 만 받습니다. Client ID에는 비밀이 없어 로그인은 PKCE가 지키며, PKCE가 없는 요청은 거절합니다.

마컴은 갱신 토큰을 늘 발급하므로 offline_access 는 필요 없습니다. 넣어도 무시됩니다.

자주 묻는 질문

Gemini Enterprise 에서 Client Secret 을 꼭 넣어야 하나요?
Gemini Enterprise 가 칸을 비울 수 없게 하므로 unused 같은 아무 문자나 넣습니다. 마컴은 비밀을 발급하지도 확인하지도 않고, 켜 둬야 하는 PKCE 가 로그인을 지킵니다.

AI 도구