All integrations
AI code editor

Windsurf + Norbix

Give Cascade a real backend to call.

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

Windsurf 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 Windsurf 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

Not in Cloud's Connect your AI page yet — the block is the same for everyone.

  1. 1
    Add the server
    ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "norbix": {
          "serverUrl": "https://hub.norbix.ai/v3/account/mcp"
        }
      }
    }
  2. 2
    Sign in

    Windsurf opens the browser; pick the roles on Cloud's consent screen and press Allow.

Alternative

Or the Norbix CLI from the terminal

Any agent with a shell can use the CLI. The AGENTS.md block is read by most agents.

  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
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "norbix": {
      "serverUrl": "https://hub.norbix.ai/v3/account/mcp",
      "headers": { "Authorization": "Bearer ${env:NORBIX_API_KEY}" }
    }
  }
}
Then ask

A first prompt

Windsurf 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

List the collections in my Norbix project and their fields.

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

What Windsurf 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 Windsurf + Norbix

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