#NocoBase MCP

Sobald das NocoBase-MCP-Service-Plugin aktiviert ist, stellt die NocoBase-Anwendung eine MCP-Service-Schnittstelle bereit, über die MCP-Clients NocoBase-Schnittstellen aufrufen können.

#Service-Adresse

• Hauptanwendung:

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

• Sub-Anwendung:

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

Diese Adresse verwendet das Übertragungsprotokoll streamable HTTP.

#Bereitgestellte Funktionen

#Allgemeine Tools

Können zum Bedienen von Datentabellen verwendet werden.

#NocoBase-Kern und Schnittstellen verschiedener Plugins

Über den Request-Header x-mcp-packages lässt sich steuern, welche Paket-Schnittstellen MCP exponiert, zum Beispiel:

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

Dieser Request-Header unterstützt vollständige Paketnamen; fehlt der Scope, wird automatisch @nocobase/ ergänzt.

Standardmäßig werden außer den allgemeinen Tools keine weiteren Paket-Schnittstellen geladen. Empfohlen wird, andere Systemfunktionen über die NocoBase CLI zu bedienen.

Häufig verwendete Pakete:

Weitere Pakete und zugehörige Schnittstellenbeschreibungen finden Sie über das Plugin API-Dokumentation.

#Authentifizierungsmethoden

#API-Key-Authentifizierung

Mit einem über das Plugin API keys erstellten API Key können Sie die MCP-Service-Schnittstelle aufrufen; die Berechtigungen werden durch die mit dem API Key verknüpfte Rolle bestimmt.

#OAuth-Authentifizierung

Verwenden Sie das nach erfolgreicher OAuth-Authentifizierung erhaltene Access Token, um die MCP-Service-Schnittstelle aufzurufen; die Berechtigungen werden durch den autorisierten Nutzer bestimmt. Hat der Nutzer mehrere Rollen, kann die Aufruferrolle über den Request-Header x-role festgelegt werden.

#Schnellstart

#Codex

#Mit API-Key-Authentifizierung

Aktivieren Sie zunächst das API-Keys-Plugin und erstellen Sie einen API Key.

export NOCOBASE_API_TOKEN=<your_api_key>
codex mcp add nocobase --url https://<host>:<port>/api/mcp --bearer-token-env-var NOCOBASE_API_TOKEN

#Mit OAuth-Authentifizierung

Aktivieren Sie zunächst das Plugin „IdP: OAuth".

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

#Claude Code

#Mit API-Key-Authentifizierung

Aktivieren Sie zunächst das API-Keys-Plugin und erstellen Sie einen API Key.

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

#Mit OAuth-Authentifizierung

Aktivieren Sie zunächst das Plugin „IdP: OAuth".

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

Öffnen Sie nach der Ausführung Claude und melden Sie sich am gewünschten MCP-Service an:

claude
/mcp

#OpenCode

#Mit API-Key-Authentifizierung

Aktivieren Sie zunächst das API-Keys-Plugin und erstellen Sie einen API Key. Konfigurieren Sie 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"
}

#Mit OAuth-Authentifizierung

Aktivieren Sie zunächst das Plugin „IdP: OAuth". Konfigurieren Sie opencode.json:

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

Login

opencode mcp auth nocobase

Debug

opencode mcp debug nocobase