#NocoBase MCP

Nach dem Aktivieren des NocoBase MCP-Server-Plugins stellt deine NocoBase-Anwendung einen MCP-Endpunkt bereit, über den MCP-Clients auf NocoBase-APIs zugreifen und sie aufrufen können.

#Server-Adresse

• Hauptanwendung:

  http(s)://<host>:<port>/api/mcp

• Nicht-Hauptanwendung:

  http(s)://<host>:<port>/api/__app/<app_name>/mcp

Dieser Endpunkt verwendet das Transportprotokoll streamable HTTP.

Über den Request-Header x-mcp-packages kannst du steuern, welche Paket-APIs MCP bereitstellt, zum Beispiel:

x-mcp-packages: @nocobase/server,plugin-workflow*,plugin-users

Der Header akzeptiert vollständige Paketnamen. Wenn kein Scope angegeben ist, wird automatisch @nocobase/ ergänzt. Standardmäßig lädt MCP die APIs dieser Pakete:

• @nocobase/plugin-data-source-main
• @nocobase/plugin-data-source-manager
• @nocobase/plugin-workflow*
• @nocobase/plugin-acl
• @nocobase/plugin-users
• @nocobase/plugin-auth
• @nocobase/plugin-client
• @nocobase/plugin-flow-engine
• @nocobase/plugin-ai

#Funktionen

• NocoBase-Kern- und Plugin-APIs
• Ein allgemeines CRUD-Tool zur Arbeit mit Datentabellen

#Schnellstart

#Codex

#Authentifizierung mit API Key

Aktiviere zuerst das Plugin API Keys und erstelle einen 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

#Authentifizierung mit OAuth

Aktiviere zuerst das Plugin IdP: OAuth.

codex mcp add nocobase --url http://<host>:<port>/api/mcp
codex mcp login nocobase --scopes mcp,offline_access

#Claude Code

#Authentifizierung mit API Key

Aktiviere zuerst das Plugin API Keys und erstelle einen API Key.

claude mcp add --transport http nocobase http://<host>:<port>/api/mcp --header "Authorization: Bearer <your_api_key>"

#Authentifizierung mit OAuth

Aktiviere zuerst das Plugin IdP: OAuth.

claude mcp add --transport http nocobase http://<host>:<port>/api/mcp

Öffne danach Claude und melde dich beim entsprechenden MCP-Dienst an:

claude
/mcp

#OpenCode

#Authentifizierung mit API Key

Aktiviere zuerst das Plugin API Keys und erstelle einen API Key. Konfiguriere opencode.json:

{
  "mcp": {
    "nocobase": {
      "type": "remote",
      "url": "https://<host>:<port>/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer <your_api_key>"
      }
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

#Authentifizierung mit OAuth

Aktiviere zuerst das Plugin IdP: OAuth. Konfiguriere opencode.json:

{
  "mcp": {
    "nocobase": {
      "type": "remote",
      "url": "https://<host>:<port>/api/mcp",
      "enabled": true
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

Anmeldung

opencode mcp auth nocobase

Debug

opencode mcp debug nocobase

#Zusammen mit Skills verwenden

Es wird empfohlen, NocoBase MCP zusammen mit NocoBase Skills zu verwenden. Siehe NocoBase Skills.