All integrations
AI coding agent · Anthropic

Claude Code + Norbix

Tell Claude what you need. It runs the Norbix CLI and ships a backend.

Recommended: Norbix CLI Acts with the roles you pick No key in any file
Where Claude Code fits

Claude Code has a shell, so it runs the Norbix CLI.

A coding agent runs commands all day. Instead of loading hundreds of tools into its context, it runs norbix like you do and reads one JSON answer per command. The MCP server stays there as the second way in.

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 Claude Code 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

Norbix CLI — recommended

In your project folder. The CLI is what a coding agent does best: run a command, read one JSON answer.

  1. 1
    Install the CLI, sign in, write the agent's instructions
    terminal
    npm i -g @norbix.ai/cli
    norbix login
    norbix ai init
  2. 2
    Approve in the browser

    norbix login opens Cloud. Check the code matches your terminal, pick the roles Claude gets (for example Viewer on one project, or Administrator), press Allow.

  3. 3
    Start Claude

    norbix ai init wrote .claude/skills/norbix/SKILL.md and a short block in CLAUDE.md. Claude now knows to use norbix with --json, --dry-run first, and --yes only for destructive changes. You can even skip norbix login: when Claude finds it is not signed in, it shows you the link and the code and waits for your Allow.

Alternative

Or connect through MCP

The hosted MCP server, no key in any file. Claude signs in through the browser.

  1. 1
    Add the server
    terminal
    claude mcp add --transport http norbix https://hub.norbix.ai/v3/account/mcp
  2. 2
    Sign in

    Start claude, run /mcp, pick norbix and allow in the browser. claude mcp list shows “Needs authentication” until you do.

Unattended runs (CI) — with a key

Put an nbsu_ key in NORBIX_API_KEY. Keep this server in the local scope: never --scope project, which writes the key into the shared .mcp.json.

MCP with a key
terminal
claude mcp add --transport http norbix https://hub.norbix.ai/v3/account/mcp --header "Authorization: Bearer $NORBIX_API_KEY"
CLI with a key
terminal
export NORBIX_API_KEY=nbsu_…
export NORBIX_PROJECT_ID=pr_…
norbix db count orders --json
Then ask

A first prompt

Claude Code runs norbix whoami --json, then the read commands it needs, and answers from the JSON. Ask for a change and it shows you the --dry-run request first. With Viewer, the change is refused by the server; with Administrator, it goes through.

you

Which tables does my Norbix project have?

$ norbix whoami --json
$ norbix db schemas --json
…answers from the JSON.
Every module

What Claude Code 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

Sign-in happens in your browser. You tick the projects and roles the agent gets — Viewer, Developer, Data Editor, Administrator or your own.

Never as you

The CLI acts as an AI service user named after your computer. Remove it in Cloud and the agent is signed out.

Dry run, then --yes

The agent runs --dry-run first and shows the exact request. Destructive commands refuse to run without --yes.

Everything in Logs

Every call the agent 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 Claude Code + Norbix

Create a free account, connect Claude Code, and ask it for your first backend change.