mailinapp
Documentation menu

连接 Gemini

适用哪些步骤取决于你如何使用 Gemini:消费者版应用(Spark)、通过所在组织使用的 Gemini Enterprise,或 Antigravity CLI。请在下面选择与你相符的一种。

Gemini 应用(Spark)

  1. 前往 gemini.google.com → 设置和帮助 → 已连接的应用 → Spark 的自定义应用 → 添加自定义应用。
  2. 将 https://mailinapp.com/api/mcp 粘贴为服务器 URL。
  3. 当 Gemini 打开 MailInApp 的授权确认页面时完成批准——如有需要请先登录,如果你属于多个账户则选择要以哪一个连接,选择你的权限范围(见权限范围与权限),然后完成批准。

就这么简单——不需要提交或等待审核,与连接 Claude 或 ChatGPT 一样。如果你没有看到Spark 的自定义应用这个选项,这是 Google 自身的资格限制,而不是 MailInApp 一侧的问题:目前 Google 将自定义 Spark 应用限定为美国境内、18 岁以上的个人 Google 账户,且需要开启"保留活动记录",并将 Gemini 应用语言设置为英语。不满足这些条件时,该选项根本不会出现。

Gemini Enterprise(通过你所在的组织)

如果你的公司使用 Gemini Enterprise,你无法像在消费者版应用中那样自行添加 MailInApp——它默认被组织策略关闭,开启它是你的 Workspace 管理员需要完成的一次性设置,而不是你自己能做的。请把以下信息发给你的管理员:

  • 授权 URL: https://mailinapp.com/oauth/authorize
  • 令牌 URL: https://mailinapp.com/oauth/token
  • 权限范围: 从权限范围与权限中任意组合,以空格分隔。
  • PKCE: 开启(S256)。
  • 客户端 ID / 密钥: 请发邮件至 [email protected],并附上你的 Gemini Enterprise 租户所使用的重定向 URI,我们会签发一份供你的管理员填入。

一旦你的管理员完成这些设置,通过 Gemini Enterprise 连接和使用 MailInApp 的方式就和其他任何助手一样——登录、选择账户、选择权限范围、完成批准。

Antigravity CLI

如果你使用的是 Antigravity CLI(Gemini CLI 的后继产品)而不是 Gemini 应用,需要将 MailInApp 添加到它的配置文件中,而不是设置界面。在 mcp_config.json(或 .agents/mcp_config.json)中添加一个条目:

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

Antigravity CLI 第一次连接时,会打开与其他所有客户端相同的 OAuth 授权确认页面。

如果连接无法正常工作

  • 在"已连接的应用"下没有"添加自定义应用"选项——这是 Google 自身的资格限制,与 MailInApp 无关:Spark 的自定义应用功能要求美国境内、18 岁以上的个人 Google 账户,开启"保留活动记录",并将 Gemini 应用语言设置为英语。不满足这些条件时该选项根本不会出现,无论 MailInApp 一侧如何。
  • Enterprise 连接被你管理员的配置拒绝——MailInApp 签发的客户端 ID/密钥与你的租户在设置时提供的确切重定向 URI 绑定。如果该 URI 发生变化,请让你的管理员将新的 URI 发邮件至 [email protected],而不要重用旧的客户端。
  • Antigravity CLI 报告连接错误——请检查 mcp_config.json 是否为合法的 JSON,且 url 字段的内容与 https://mailinapp.com/api/mcp 完全一致;mcpServers 对象格式错误是最常见的原因。
  • 你更换了团队,或团队成员撤销了你的访问权限——与其他所有平台一样,Gemini 连接器令牌在每次调用时都会针对你当前的账户成员身份重新校验,因此一旦你失去某个公司的访问权限,该连接的调用会立即失效,你无需在 Gemini 那一端做任何操作。

撤销

无论你通过哪个 Gemini 入口完成连接,MailInApp 仪表盘中的连接(/dashboard/connections)都会将它与其他所有助手一起列出,并提供一键撤销——该令牌会在下一次调用时失效。