All integrations
AI coding agent · Google

Gemini CLI + Norbix

One settings block, one /mcp auth.

Connects through MCP Acts with the roles you pick No key in any file
Where Gemini CLI fits

Gemini CLI speaks MCP, so it calls the hosted server.

Every Norbix installation is an MCP server — the hosted address below, nothing to install. The tool signs in with OAuth in your browser and gets described tools marked read or change.

Coding agents
have a shell
Claude CodeCodexCursorGemini CLICoworkVS CodeWindsurf
Chat apps
no shell
ClaudeChatGPTGemini
CLI Norbix CLI
Recommended for coding agents
norbix login → norbix ai init → norbix … --json
  • ▸Signs in in your browser. You pick the roles, press Allow.
  • ▸One JSON answer per command — small context, every endpoint.
  • ▸--dry-run first, --yes only for destructive changes. Same commands in CI.
MCP MCP server
For chat apps
https://hub.norbix.ai/v3/account/mcp
  • ▸Hosted by every Norbix installation — nothing to install or run.
  • ▸OAuth in the browser: a consent screen with the roles, then Allow.
  • ▸400+ described tools, marked read or change; risky ones ask first.
Your Norbix backend
managed, self-hosted or enterprise
The tool acts as an AI service user — never as you — with the roles you picked. Nothing more.
DatabaseMembershipFilesEmail · Push · SMSPaymentsSchedulerCodeLogs
●Every call shows up in Logs.
●Sign a tool out in Cloud: Account → AI service users → Remove.
Connect

Connect Gemini CLI to Norbix

The blocks below are the ones Cloud shows for the managed service. On your own installation Cloud fills in your own addresses.

Recommended

MCP server

httpUrl means Streamable HTTP. Gemini loads MCP servers only in a trusted folder.

  1. 1
    Add the server
    ~/.gemini/settings.json
    {
      "mcpServers": {
        "norbix": {
          "httpUrl": "https://hub.norbix.ai/v3/account/mcp"
        }
      }
    }
  2. 2
    Sign in
    text
    /mcp auth norbix

    Inside Gemini CLI. Allow in the browser; gemini mcp list then shows norbix as Connected.

Alternative

Or the Norbix CLI from the terminal

  1. 1
    Install, sign in, write AGENTS.md
    terminal
    npm i -g @norbix.ai/cli
    norbix login
    norbix ai init --target agents
Unattended runs — with a key
MCP with a key
~/.gemini/settings.json
{
  "mcpServers": {
    "norbix": {
      "httpUrl": "https://hub.norbix.ai/v3/account/mcp",
      "headers": {
        "Authorization": "Bearer $NORBIX_API_KEY"
      }
    }
  }
}
Then ask

A first prompt

Gemini CLI calls a read tool, for example get_database_taxonomies, and turns the JSON into a list. Ask for a change and the tool either goes through (Administrator) or answers "Caller is missing required permission" (Viewer).

you

How many users does my Norbix project have, and which roles do they hold?

→ get_database_taxonomies
{"ok":true,"data":{"list":{"items":[…]}}}
…turned into a list.
Every module

What Gemini CLI can do with Norbix

Every tool group, per module
01

Scaffold a backend

Create a project, enable modules, build collections from a schema bundle and publish them.

02

Read and change data

Find, count, insert and update records; taxonomies, aggregates and triggers on every collection.

03

Set up providers

Email, push, SMS and payment providers; templates, campaigns, files and storage.

04

Users, roles, sign-in

Roles and policies, sign-in integrations, invitations and the membership settings.

05

Automate

Triggers across modules, scheduler tasks, serverless code functions and webhooks.

06

Inspect and debug

Logs by correlation id, diagnostics, usage — the same read-only look Cloud gives you.

Built in

Guardrails the agent cannot skip

Roles you pick

OAuth opens Cloud's consent screen. You tick the projects and roles the tool gets — Viewer, Developer, Data Editor, Administrator or your own.

Never as you

The tool acts as an AI service user. Remove it under Account → AI service users and it is signed out.

Asks before it acts

Every tool is marked read or change. Tools that send messages, delete or change a lot answer requires_confirmation first.

Everything in Logs

Every call the tool makes is in Logs with its correlation id, like any other request.

No copy-paste needed

Cloud writes the block for your installation

Open your avatar → Connect your AI in Cloud. It holds a prompt you can paste into any AI tool, the Hub, API and MCP addresses of your installation, and one tab per tool with the exact commands — including the key variants for CI.

Cloud · avatar → Connect your AI
Prompt — paste into any AI tool
Addresses — Hub · API · MCP
Add Norbix to your tool — one tab per tool
/account/connect-ai

Try Gemini CLI + Norbix

Create a free account, connect Gemini CLI, and ask it for your first backend change.