内容
# Brainbase MCP
适用于任何兼容MCP客户端的官方Brainbase MCP。
任何兼容的MCP客户端都可以通过Streamable HTTP和OAuth与Brainbase连接。该存储库还包括可选的Codex和Claude Code包，它们将相同的MCP连接与配套操作技能捆绑在一起。
## 提供的内容
- 无凭证远程MCP连接至 `https://api.brainbaselabs.com/mcp`
- 客户端管理的Brainbase OAuth，无需粘贴API密钥或Bearer令牌
- 适用于任何兼容MCP客户端的代理、组件、评估、任务、编排、调度、模板和技能工具
- 适用于支持打包技能的客户端的可选维护操作技能
- 修订安全目标写入、幂等创建、破坏性确认和明确的计费运行指导
- 可选的Codex、Claude Code和Brainbase包清单
工作流程被故意排除在外。
## 权限和安全性
Brainbase OAuth请求 `mcp:all` 作用域。这授予客户端用户对Brainbase资源的广泛访问权限，这些资源是登录用户在正常Brainbase权限下已经可以访问的。它不限于一个代理。
这意味着MCP可以：
- 检查和更新代理，包括附加到的代理；
- 管理支持的代理组件、评估、编排和调度；
- 启动可能消耗付费Brainbase用量的任务和评估运行；
- 在修订和名称确认后存档或删除支持的资源。
该软件包不包含令牌、机密、凭证头或环境值。OAuth凭证保留在安装的客户端和Brainbase中。
在批准更改之前，请检查它们，尤其是标记为计费或破坏性的操作。
## 要求
- Brainbase账户
- 具有远程Streamable HTTP和OAuth支持的MCP客户端
- 允许打开 `app.brainbaselabs.com` 以完成OAuth
## 从任何MCP客户端连接
配置一个名为 `brainbase` 的远程HTTP MCP服务器，网址为：
```text
https://api.brainbaselabs.com/mcp
```
对于接受 `mcpServers` 对象的客户端，请适配此无凭证配置：
```json
{
"mcpServers": {
"brainbase": {
"type": "http",
"url": "https://api.brainbaselabs.com/mcp"
}
}
}
```
不要在配置中添加授权头或粘贴令牌。当提示时，通过客户端完成Brainbase OAuth。
## 可选：安装Codex包
Codex包安装MCP连接和配套操作技能：
```sh
codex plugin marketplace add BrainbaseHQ/brainbase-mcp --ref main
codex plugin add brainbase-mcp@brainbase
```
在安装或首次使用时完成OAuth，然后启动新线程。
尝试：
> 使用 $brainbase-mcp 列出我的Brainbase代理并解释哪个代理是安全的 修改。
删除它：
```sh
codex plugin remove brainbase-mcp@brainbase
codex plugin marketplace remove brainbase
```
## 可选：安装Claude Code包
Claude Code包安装相同的MCP连接和操作技能：
```sh
claude plugin marketplace add --scope user BrainbaseHQ/brainbase-mcp
claude plugin install --scope user brainbase-mcp@brainbase
```
在Claude Code提示时完成OAuth，重启Claude Code，并调用Brainbase工具。
删除它：
```sh
claude plugin uninstall --scope user brainbase-mcp@brainbase
claude plugin marketplace remove --scope user brainbase
```
删除插件会删除其本地配置。如果可能已公开OAuth凭证，请通过 [SECURITY.md](SECURITY.md) 中的私有流程报告。
## 首次使用工作流程
1. 列出组织和团队，而不是猜测ID。
2. 检查代理并获取其当前的不透明修订版。
3. 进行有针对性的更改。
4. 读取资源并验证结果。
5. 在部署调度之前测试任务或评估的行为。
配套技能在安装时自动应用此工作流程。否则，直接使用MCP工具遵循相同的顺序。
## 能力边界
直接支持的操作包括：
- 代理检查、创建、更新、存档和删除
- 指令、剧本、注册技能和MCP服务器配置
- 评估生命周期和结果检索
- 编排成员、边缘、调度程序和触发器测试
- 任务创建、跟进、中断和标准化事件
- 注册模板和技能发现
交互式或引导式操作包括秘密输入、第三方OAuth、浏览器凭证、内存管理、Slack、会议、电话和外部应用程序触发器。
不通过此MCP公开任意文件CRUD、函数、模式和旧版工作流程。
## 存储库布局
- `.mcp.json` — 共享无凭证远程MCP描述符
- `.codex-plugin/` — Codex插件元数据
- `.claude-plugin/` — Claude Code插件和市场元数据
- `.agents/plugins/marketplace.json` — Codex市场元数据
- `skills/brainbase-mcp/` — 维护的技能和参考资料
- `components/mcps/brainbase/` — Brainbase包MCP组件
- `brainbase.json` — 可选的Brainbase注册包清单
- `scripts/validate.mjs` — 无依赖包验证
## 开发
运行存储库验证：
```sh
node scripts/validate.mjs
```
使用Claude Code验证：
```sh
claude plugin validate --strict .
```
在Codex中本地测试：
```sh
codex plugin marketplace add .
codex plugin add brainbase-mcp@brainbase
```
在更改清单或发布新版本之前，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
## 版本控制和发布
该软件包遵循语义版本控制。发布更新 `package.json`、客户端插件清单和 `brainbase.json` 中的版本。
当技能或MCP组件更改时，请在发布前重新生成相应的 `brainbase.json`校验和。拉取请求和 `main` 分支由GitHub Actions验证。
该存储库是Brainbase MCP分发的规范来源。任何兼容的MCP客户端都可以直接连接到远程端点。npm软件包故意禁用；可选的Codex和Claude Code软件包从此Git存储库安装。
## 支持
- 产品文档：<https://docs.brainbaselabs.com>
- 产品网站：<https://brainbaselabs.com>
- 错误和功能请求：<https://github.com/BrainbaseHQ/brainbase-mcp/issues>
- 安全报告： [SECURITY.md](SECURITY.md)
## 许可证
[MIT](LICENSE)
