#NocoBase MCP

После включения плагина NocoBase MCP Server ваше приложение NocoBase будет предоставлять MCP-эндпоинт, через который MCP-клиенты смогут обращаться к API NocoBase и вызывать их.

#Адрес сервера

• Основное приложение:

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

• Неосновное приложение:

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

Этот эндпоинт использует транспорт streamable HTTP.

Вы можете использовать заголовок запроса x-mcp-packages, чтобы управлять тем, API каких пакетов MCP будет предоставлять, например:

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

Этот заголовок принимает полные имена пакетов. Если scope опущен, @nocobase/ будет добавлен автоматически. По умолчанию MCP загружает API следующих пакетов:

• @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

#Возможности

• API ядра NocoBase и его плагинов
• Универсальный CRUD-инструмент для работы с таблицами данных

#Быстрый старт

#Codex

#Аутентификация через API Key

Сначала включите плагин API Keys и создайте 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

#Аутентификация через OAuth

Сначала включите плагин IdP: OAuth.

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

#Claude Code

#Аутентификация через API Key

Сначала включите плагин API Keys и создайте API key.

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

#Аутентификация через OAuth

Сначала включите плагин IdP: OAuth.

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

После этого откройте Claude и выполните вход в соответствующий MCP-сервис:

claude
/mcp

#OpenCode

#Аутентификация через API Key

Сначала включите плагин API Keys и создайте API key. Настройте 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"
}

#Аутентификация через OAuth

Сначала включите плагин IdP: OAuth. Настройте opencode.json:

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

Вход

opencode mcp auth nocobase

Отладка

opencode mcp debug nocobase

#Использование вместе со Skills

Рекомендуется использовать NocoBase MCP вместе с NocoBase Skills. См. NocoBase Skills.