All integrations
Editor · GitHub Copilot agent mode

VS Code + Norbix

Copilot's agent mode, with Norbix as a tool.

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

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

MCP server

For GitHub Copilot agent mode. Not in Cloud's Connect your AI page yet.

  1. 1
    Add the server
    .vscode/mcp.json
    {
      "servers": {
        "norbix": {
          "type": "http",
          "url": "https://hub.norbix.ai/v3/account/mcp"
        }
      }
    }
  2. 2
    Press Start

    VS Code shows a Start action above the server in the file and asks you to sign in. Pick the roles, press Allow.

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
With a key

VS Code asks for the key once and keeps it in its secret store — nothing lands in the file.

MCP with a key
.vscode/mcp.json
{
  "inputs": [
    { "type": "promptString", "id": "norbix-key", "description": "Norbix API key (nbsu_…)", "password": true }
  ],
  "servers": {
    "norbix": {
      "type": "http",
      "url": "https://hub.norbix.ai/v3/account/mcp",
      "headers": { "Authorization": "Bearer ${input:norbix-key}" }
    }
  }
}
Then ask

A first prompt

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

Show the last 20 error logs of my Norbix project.

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

What VS 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

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 VS Code + Norbix

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