#NocoBase MCP

Depois de habilitar o plugin NocoBase MCP Server, sua aplicação NocoBase passa a expor um endpoint MCP para que clientes MCP possam acessar e chamar as APIs do NocoBase.

#URL do servidor

• Aplicação principal:

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

• Aplicação que não é principal:

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

Esse endpoint usa o transporte streamable HTTP.

Você pode usar o cabeçalho de requisição x-mcp-packages para controlar quais APIs de pacotes o MCP expõe, por exemplo:

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

Esse cabeçalho aceita nomes completos de pacotes. Se o escopo for omitido, @nocobase/ será adicionado automaticamente. Por padrão, o MCP carrega as APIs destes pacotes:

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

#Capacidades

• APIs do núcleo do NocoBase e de seus plugins
• Uma ferramenta CRUD genérica para trabalhar com tabelas de dados

#Início rápido

#Codex

#Autenticação com API Key

Primeiro, habilite o plugin API Keys e crie uma 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

#Autenticação com OAuth

Primeiro, habilite o plugin IdP: OAuth.

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

#Claude Code

#Autenticação com API Key

Primeiro, habilite o plugin API Keys e crie uma API key.

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

#Autenticação com OAuth

Primeiro, habilite o plugin IdP: OAuth.

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

Depois, abra o Claude e faça login no serviço MCP correspondente:

claude
/mcp

#OpenCode

#Autenticação com API Key

Primeiro, habilite o plugin API Keys e crie uma API key. Configure o 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"
}

#Autenticação com OAuth

Primeiro, habilite o plugin IdP: OAuth. Configure o 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

#Uso com Skills

Recomenda-se usar o NocoBase MCP junto com NocoBase Skills. Veja NocoBase Skills.