mcpField
N
nocobase-mcp-setup

nocobase-mcp-setup

github.com/nocobaseAgent 工作流5580 次安装8 周前更新
代码仓库

关于 nocobase-mcp-setup

帮助 NocoBase 用户为编码 Agent CLI 配置 MCP 连接并验证可访问性与身份验证的技能。它根据 CLI 和认证方式提供配置步骤，并检查已注册服务及其可用工具。

主要功能

  1. 01确认主应用或非主应用端点
  2. 02检查 NocoBase 服务可访问性
  3. 03按 API Key 或 OAuth 配置认证
  4. 04提供 Codex 与 Claude Code 命令
  5. 05检查已注册服务和可用工具

适用场景

  1. 01为 Codex CLI 添加 NocoBase MCP
  2. 02为 Claude Code 配置 NocoBase 连接
  3. 03排查 MCP 端点或认证配置
  4. 04确认集合与字段相关工具可用

MCP 相关

该技能指导将 NocoBase 作为 MCP 服务添加到编码 Agent CLI。NocoBase 通过 streamable HTTP 暴露核心与插件 API，以及用于操作集合的通用 CRUD 工具。

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/nocobase-mcp-setup确认已加载。

详细介绍

目标

为用户的编码 Agent CLI 配置 NocoBase MCP 连接，并验证服务可访问且已通过身份验证。

工作流

  1. 确认应使用哪个应用端点：
    • 主应用：http(s)://<host>:<port>/api/mcp
    • 非主应用：http(s)://<host>:<port>/api/__app/<app_name>/mcp
  2. 确认 NocoBase 正在运行且可访问。
  3. 确定身份验证模式：
    • API Key：需要启用 API Keys 插件并拥有现有的 API Key
    • OAuth：需要启用 IdP: OAuth 插件
  4. 根据用户的 CLI，指导用户使用相应命令添加 NocoBase MCP 服务。
  5. 检查已注册的服务和可用工具，以验证 MCP 连接。

服务说明

  • NocoBase MCP 使用 streamable HTTP 传输协议。
  • NocoBase 提供：
    • NocoBase 核心和插件 API
    • 用于操作集合的通用 CRUD 工具

MCP 配置

根据用户的 CLI 和身份验证模式选择命令。

Codex（使用 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（使用 OAuth）

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

Claude Code（使用 API Key）

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

Claude Code（使用 OAuth）

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

然后打开 Claude，并在 MCP 面板中完成登录：

claude
/mcp

其他 CLI

使用相同的端点格式和 CLI 支持的身份验证模式。

前提条件

  • NocoBase 已安装并正在运行
  • 已知正确的应用端点
  • 使用 API Key 身份验证时：
    • 已启用 API Keys 插件
    • 已创建 API Key
  • 使用 OAuth 身份验证时：
    • 已启用 IdP: OAuth 插件

验证

配置完成后，验证 NocoBase MCP 工具是否可用于集合和字段等 NocoBase API 操作。

Codex CLI 请使用：

codex mcp list
codex mcp get nocobase

Claude Code 请启动 Claude 并检查 MCP 条目：

claude
/mcp

评论

支持 Markdown