Gemini's support for OAuth-secured remote MCP servers is still moving. The reliable path today is Gemini CLI, which reads MCP servers from a config file and completes the OAuth sign-in in your browser.
Google has changed Gemini's extension/MCP surface repeatedly. If your Gemini app build doesn't offer a custom MCP server with OAuth, that's expected — use the CLI path below, or connect Claude or ChatGPT instead.
Gemini support is honest work-in-progress: the CLI path works today, the consumer app surface is still changing. We update this page as Google ships.
Setup
Every step is the action — click the card and it happens.
Step 1
The MCP needs a workspace behind it. The self-serve signup wizard creates one and adds your team's staff emails. No sales call, no waitlist.
Already have a workspace? Skip to step 2.Open the signup wizard
Step 3
Install Gemini CLI and sign in to your Google account. Add an MCP server entry to your Gemini CLI settings file with httpUrl set to the OK Capsule endpoint. { "mcpServers": { "okcapsule": { "httpUrl": "https://storefront.okcapsule.app/mcp" } } }
Open Gemini
Step 4
A browser window opens automatically. Enter your work email, type the one-time code, approve the scopes — done.
See the sign-in sequence
Step 5
A walkthrough of the OK Capsule flow end to end — the same demo video from the MCP overview.
Watch the walkthrough
Setting this up is easiest on desktop — once connected, it's available wherever you use Gemini with the same account.
Questions during setup? Use our custom OK Capsule AI assistant — available anytime.
Exact clicks
Modern MCP clients run this whole handshake for you. Nothing to copy, nothing to store.
Try it now
Add the connector and sign in first — then run one of these.
Pack building
Using the OK Capsule tools, show me our product catalog, then design a personalized daily supplement pack for one of our customers — ask me about their goals and any restrictions first. Explain why you chose each product, then walk me through creating the order.
Client hand-off
Using the OK Capsule tools, design a supplement pack for one of our customers focused on sleep and stress — browse our catalog, use the product intelligence to explain each pick and flag anything that shouldn't be combined, then create a shareable pack-builder link I can send them to review and check out.
Catalog intelligence
Using the OK Capsule tools, pull the product intelligence for our top products and draft customer-friendly descriptions we could use on our site — lifestyle language only, no medical claims.
Troubleshooting
Sign-in refused (403)
Your email isn't on a workspace yet. Run through the onboarding wizard, or ask your workspace admin to add you as a staff user.
Asked to sign in again after a month
Expected. The 30-day refresh window rolled over — sign in again and you're set for another 30 days.
Connector won't add
Check that your plan supports custom / remote MCP connectors on this platform. That gating is on the AI platform's side, not ours.
