# Connect Gemini CLI

Google’s agent in the terminal. For teachers and partners. These steps connect it to the Main Team MCP server at `https://mcp.main-team.org/mcp`.

Teachers and partners

Gemini CLI is not one of the verified apps, so a **student account cannot connect it**. Students use Claude apps, Claude Code, ChatGPT, Codex and VS Code.

## Connect

1. Add the server for your user account:

   Terminal

   ```
   gemini mcp add --transport http -s user main-team https://mcp.main-team.org/mcp
   ```
2. In Gemini CLI, sign in. Your browser opens Main Team’s sign-in page:

   In Gemini CLI

   ```
   /mcp auth main-team
   ```
3. Or add it by hand, to `~/.gemini/settings.json`:

   settings.json

   ```
   {
     "mcpServers": {
       "main-team": {
         "httpUrl": "https://mcp.main-team.org/mcp"
       }
     }
   }
   ```

- Gemini CLI is not one of the apps a student account may connect. Teachers and partners may use it.

Main Team’s sign-in page opens at `auth.main-team.org`. Sign in the way you always do, tick the olympiads the connection should cover, and decide whether the app may change anything — reading only is the default. [How a connection works](https://hub.main-team.org/api/mcp).

## Add the skills

The Main Team skills teach your agent how the server works: to say whose account it is on, to read before it changes anything, to preview and confirm, and never to help with an exam in progress. [Agent skills](https://hub.main-team.org/api/skills) lists them and how to add them to Gemini CLI.

## Verify

Ask your agent:

Which Main Team account am I connected to, and may you change anything?

It answers with your own name and role, the olympiads the connection covers and whether it may change anything. If any of that is not what you expected, disconnect and connect again.

## Troubleshooting

- **It connects and then fails**: Use `httpUrl`, not `url`. In Gemini CLI `url` means the older SSE transport, which Main Team does not serve.
- **Sign-in says this app is not allowed**: A student account may connect only the verified apps: Claude apps, Claude Code, ChatGPT, Codex and VS Code. Teachers and partners may connect the others too.
- **The app asks you to sign in again**: A connection ends after a time without use, at the end of its lifetime, when you disconnect it and whenever your password changes. Sign in again from the app.
- **A tool is refused and names your panel**: Something that cannot be undone needs your app to ask you directly. When it cannot, the answer carries a link into your panel; do it there.