nocobase/nocobase-mcp-setup
skills/nocobase-mcp-setup/SKILL.md
Configure NocoBase as an MCP server for your coding agent CLI. Use when users need to set up MCP connection to NocoBase for the first time.
$ install --global
skillsauthnpx skillsauth add nocobase/skills nocobase-mcp-setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 9, 2026, 2:29 AM6.2s1 file scanned
SKILL.md
- name:
- nocobase-mcp-setup
- description:
- Configure NocoBase as an MCP server for your coding agent CLI. Use when users need to set up MCP connection to NocoBase for the first time.
- allowed-tools:
- Bash, Read
Goal
Configure the NocoBase MCP connection for the user's coding agent CLI and verify that the server is reachable and authenticated.
Workflow
- Confirm which app endpoint should be used:
- Main app:
http(s)://<host>:<port>/api/mcp - Non-main app:
http(s)://<host>:<port>/api/__app/<app_name>/mcp
- Main app:
- Verify NocoBase is running and accessible.
- Determine the auth mode:
- API Key: require the
API Keysplugin and an existing API key - OAuth: require the
IdP: OAuthplugin
- API Key: require the
- Guide the user to add the NocoBase MCP server using the command for their CLI.
- Verify the MCP connection by checking the registered server and available tools.
Service Notes
- NocoBase MCP uses the
streamable HTTPtransport protocol. - NocoBase exposes:
- NocoBase core and plugin APIs
- A generic CRUD tool for operating on collections
MCP Configuration
Choose commands based on the user's CLI and auth mode.
Codex with API Key
export NOCOBASE_API_TOKEN=<your_api_key>
codex mcp add nocobase --url http://<host>:<port>/api/mcp --bearer-token-env-var NOCOBASE_API_TOKEN
Codex with OAuth
codex mcp add nocobase --url http://<host>:<port>/api/mcp
codex mcp login nocobase --scopes mcp,offline_access
Claude Code with API Key
claude mcp add --transport http nocobase http://<host>:<port>/api/mcp --header "Authorization: Bearer <your_api_key>"
Claude Code with OAuth
claude mcp add --transport http nocobase http://<host>:<port>/api/mcp
Then open Claude and complete login from the MCP panel:
claude
/mcp
Other CLIs
Use the same endpoint pattern and auth mode supported by the CLI.
Prerequisites
- NocoBase is installed and running
- The correct app endpoint is known
- For API Key auth:
API Keysplugin is enabled- an API key has been created
- For OAuth auth:
IdP: OAuthplugin is enabled
Verification
After configuration, verify that NocoBase MCP tools are available for NocoBase API operations such as collections and fields.
For Codex CLI, use:
codex mcp list
codex mcp get nocobase
For Claude Code, start Claude and inspect the MCP entry:
claude
/mcp
Related Skills
nocobase/nocobase-ai-employee
tools
VerifiedTrustedCommunity
Use when a NocoBase task requires AI employee lifecycle work such as discovering existing employees, judging fit, creating a dedicated employee, or configuring profile, prompt, model, skills, tools, or knowledge base before another skill binds it to a UI surface.
34SKILL.mdUpdated May 30, 2026
nocobase/nocobase-workflow-manage
tools
VerifiedTrustedCommunity
Use when users need to inspect, create, revise, enable, or diagnose NocoBase workflows through the `nb` CLI, including trigger selection, node-chain changes, version safety checks, and execution troubleshooting.
34SKILL.mdUpdated Apr 9, 2026
nocobase/nocobase-ui-builder
tools
VerifiedTrustedCommunity
DEFAULT entry point for NocoBase Modern UI authoring or tweaks: new pages, blocks, menu items, and localized edits to blocks, fields, actions, layouts, or reactions on an already-running app via backend flow-surfaces through nb api. Also handles AI employee / AI assistant action placement on UI surfaces. Hand off employee lifecycle work such as discovering, judging, creating, or configuring profile, prompt, model, skills, tools, or knowledge base to nocobase-ai-employee, then return for the UI write. Only hand off to nocobase-dsl-reconciler when the user explicitly asks for DSL, YAML, git, or cli push workflow. Does not handle ACL, data modeling, workflow orchestration, browser reproduction, page error postmortems, or non-Modern page navigation.
34SKILL.mdUpdated Apr 9, 2026
nocobase/nocobase-data-modeling
data-ai
VerifiedTrustedCommunity
Create and manage NocoBase data models through the available data-modeling surface. Use when users want to inspect or change collections, fields, relations, or view-backed schemas in a NocoBase app.
29SKILL.mdUpdated Apr 9, 2026