Gemini 연결하기

어떤 단계를 따라야 하는지는 Gemini를 어떻게 사용하는지에 따라 다릅니다: 소비자용 앱(Spark), 조직을 통한 Gemini Enterprise, 또는 Antigravity CLI. 자신에게 맞는 항목을 아래에서 선택하세요.

Gemini 앱 (Spark)

gemini.google.com → Settings & help → Connected apps → Custom apps for Spark → Add a custom app으로 이동합니다.
서버 URL로 https://mailinapp.com/api/mcp를 붙여넣습니다.
Gemini가 열어주는 MailInApp의 동의 화면을 승인합니다 — 필요하면 로그인하고, 둘 이상의 계정에 속해 있다면 어느 계정으로 연결할지 선택한 뒤, 스코프를 고르고(스코프 및 권한 참고) 승인합니다.

이게 전부입니다 — Claude나 ChatGPT를 연결할 때와 마찬가지로 제출하거나 검토받을 것이 없습니다. Custom apps for Spark 옵션이 보이지 않는다면, 이는 MailInApp 쪽의 문제가 아니라 Google의 자격 요건 때문입니다: Google은 현재 커스텀 Spark 앱을 미국 기반, 18세 이상, 개인 Google 계정이면서 "Keep Activity"가 켜져 있고 Gemini 앱 언어가 영어로 설정된 경우로 제한합니다. 이 조건을 벗어나면 옵션 자체가 아예 나타나지 않습니다.

Gemini Enterprise (조직을 통한 연결)

회사에서 Gemini Enterprise를 사용한다면 소비자용 앱에서처럼 직접 MailInApp을 추가할 수 없습니다 — 기본적으로 조직 정책에 의해 꺼져 있으며, 이를 켜는 것은 사용자가 아니라 Workspace 관리자가 한 번만 수행하는 설정입니다. 관리자에게 다음 정보를 전달하세요:

Authorization URL: https://mailinapp.com/oauth/authorize
Token URL: https://mailinapp.com/oauth/token
Scopes: 스코프 및 권한에 나온 조합 중 필요한 것을 공백으로 구분해 입력.
PKCE: 켜짐 (S256).
Client id / secret: Gemini Enterprise 테넌트가 사용하는 리다이렉트 URI와 함께 [email protected]으로 이메일을 보내면, 관리자가 입력할 값을 발급해 드립니다.

관리자가 이 설정을 완료하고 나면, Gemini Enterprise를 통해 MailInApp을 연결하고 사용하는 방식은 다른 어시스턴트와 동일하게 작동합니다 — 로그인하고, 계정을 선택하고, 스코프를 고르고, 승인합니다.

Antigravity CLI

Gemini 앱이 아니라 Antigravity CLI(Gemini CLI의 후속)를 사용한다면, 설정 화면이 아니라 설정 파일에 MailInApp을 추가합니다. mcp_config.json(또는 .agents/mcp_config.json)에 다음 항목을 추가하세요:

{
  "mcpServers": {
    "mailinapp": {
      "url": "https://mailinapp.com/api/mcp"
    }
  }
}

Antigravity CLI는 처음 연결할 때 다른 모든 클라이언트와 동일한 OAuth 동의 화면을 엽니다.

연결이 작동하지 않을 때

Connected Apps에 "Add a custom app" 옵션이 없다 — 이는 MailInApp이 아니라 Google 자체의 자격 요건 문제입니다: Spark의 커스텀 앱 기능은 미국 기반, 18세 이상, 개인 Google 계정이면서 "Keep Activity"가 켜져 있고 Gemini 앱 언어가 영어로 설정되어 있을 것을 요구합니다. MailInApp 쪽과 무관하게 이 조건을 벗어나면 옵션 자체가 나타나지 않습니다.
엔터프라이즈 연결이 관리자 설정에서 거부된다 — MailInApp이 발급한 client id/secret은 설정 시 테넌트가 제공한 정확한 리다이렉트 URI에 묶여 있습니다. 그 URI가 바뀌었다면 기존 client를 재사용하지 말고 관리자가 새 URI와 함께 [email protected]으로 이메일을 보내도록 하세요.
Antigravity CLI가 연결 오류를 표시한다 — mcp_config.json이 유효한 JSON인지, url 필드가 정확히 https://mailinapp.com/api/mcp인지 확인하세요. mcpServers 객체 형식 오류가 가장 흔한 원인입니다.
팀을 옮겼거나, 팀원이 접근 권한을 취소했다 — 다른 모든 플랫폼과 마찬가지로 Gemini 커넥터 토큰도 호출할 때마다 사용자의 실시간 계정 멤버십을 기준으로 재검증되므로, 회사에 대한 접근 권한을 잃으면 Gemini 쪽에서 아무것도 하지 않아도 해당 연결의 호출이 즉시 비활성화됩니다.

취소하기

어떤 Gemini 인터페이스를 통해 연결했든, MailInApp 대시보드의 Connections(/dashboard/connections)에는 다른 모든 어시스턴트와 나란히 나열되며 클릭 한 번으로 Revoke할 수 있습니다 — 토큰은 다음 호출부터 작동을 멈춥니다.