mcpField
N
nocobase-mcp-setup

nocobase-mcp-setup

github.com/nocobaseAgent workflows5580 installsUpdated 8w ago
Repository

About nocobase-mcp-setup

A skill that helps NocoBase users configure an MCP connection for a coding-agent CLI and verify reachability and authentication. It provides setup steps for different CLIs and auth modes, then checks the registered server and its available tools.

Key features

  1. 01Identify the main or non-main app endpoint
  2. 02Check NocoBase service accessibility
  3. 03Configure API Key or OAuth authentication
  4. 04Provide commands for Codex and Claude Code
  5. 05Check registered servers and available tools

Use cases

  1. 01Add NocoBase MCP to Codex CLI
  2. 02Configure NocoBase for Claude Code
  3. 03Troubleshoot endpoint or authentication setup
  4. 04Confirm collection and field tools are available

MCP support

The skill guides users in adding NocoBase as an MCP server to a coding-agent CLI. NocoBase uses streamable HTTP to expose core and plugin APIs, plus a generic CRUD tool for operating on collections.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nocobase/skills --skill nocobase-mcp-setup

After installing, type/nocobase-mcp-setupin Claude Code to confirm it loaded.

Details

From the project README

Goal

Configure the NocoBase MCP connection for the user's coding agent CLI and verify that the server is reachable and authenticated.

Workflow

  1. 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
  2. Verify NocoBase is running and accessible.
  3. Determine the auth mode:
    • API Key: require the API Keys plugin and an existing API key
    • OAuth: require the IdP: OAuth plugin
  4. Guide the user to add the NocoBase MCP server using the command for their CLI.
  5. Verify the MCP connection by checking the registered server and available tools.

Service Notes

  • NocoBase MCP uses the streamable HTTP transport 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 Keys plugin is enabled
    • an API key has been created
  • For OAuth auth:
    • IdP: OAuth plugin 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

Comments

Markdown supported