Stable Baseline

---

如何使用 Stable Baseline

选择适合你工作方式的入口。每种方式都使用相同的处理程序、身份验证和数据：

入口	用途	安装
MCP 服务	AI Agent（Claude Code、Cursor、Windsurf、ChatGPT、Gemini、Smithery 等）。原生协议，支持提示词和资源。	端点：api.stablebaseline.io/functions/v1/cloud-serve/mcp。请参阅下方的快速入门。
REST API	适用于任何 HTTP 客户端、Postman、OpenAPI 代码生成工具和 Zapier 风格的集成工具。提供工具 RPC 和符合惯例的资源路由。	在线规范：/api/v1/openapi.json · 交互式文档：/api/v1/docs
TypeScript SDK	Node、浏览器、Deno、Bun。提供类型化的 client.tools.<toolName>(...) 接口。	npm i @stablebaseline/sdk，请参阅 packages/sdk-typescript
命令行（sb）	Shell、脚本、CI/CD。sb tool call <name> --json '{...}'。	npm i -g @stablebaseline/cli，请参阅 packages/cli
Python SDK	Python 应用和数据处理。支持同步和异步客户端。	pip install stablebaseline，请参阅 packages/sdk-python

提供 20 个类别的 222 个工具。无论使用哪种入口，都共享同一个大脑、同一个知识图谱和同一套 RBAC。

---

一个工作空间，让人类和任何兼容 MCP 的 AI Agent（Claude Code、Cursor、Windsurf、VS Code、Warp、OpenCode、Antigravity、OpenAI Codex、ChatGPT Developer Mode、Gemini CLI/Extensions 等）共同编写持续演进的文档（以 Markdown 为原生格式，并提供丰富的扩展功能）、40 多种可视化图表（Mermaid、BPMN 2.0、D2、PlantUML、GraphViz、云架构图、时序图、状态图、ERD、甘特图、徒手草图）、带视图、表单和实时仪表板的数据库、计划、时间线、任务、改进项、组织自己的 Agent，以及一个能够自我学习的知识图谱，它就是企业大脑。

精简、快速、安全且经济实惠：足够灵活，既适合个人整理思维，也适用于小型企业、成长型企业和大型企业。

20 个类别的 222 个 MCP 工具让 Agent 能够驱动端到端流程：注册 → 计费 → 组织/工作空间/项目 → 成员 → 团队 → 权限 → 大脑范围 → 文档 → 图表 → 白板 → 计划 → 数据库 → Agent，全程无需人工操作界面。

端点

https://api.stablebaseline.io/functions/v1/cloud-serve/mcp

**传输方式：**可流式 HTTP（支持 SSE 回退） **身份验证：**OAuth 2.1（支持动态客户端注册），或 Bearer API 密钥（sta_*） 发现清单：https://stablebaseline.io/.well-known/mcp.json

快速开始

创建 API 密钥（跳过 OAuth）

1. 免费注册，无需信用卡
2. 打开组织设置、已连接的应用、开发者，然后切换到API 密钥标签页，并点击创建密钥。选择密钥可访问的内容；数据库默认未勾选，如果 Agent 应使用数据库，请勾选
3. 复制 sta_... 密钥

（也可以跳过此步骤：下方的每个客户端都支持在首次调用时进行交互式 OAuth。）

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "stable-baseline": {
      "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
      "headers": {
        "Authorization": "Bearer sta_YOUR_KEY"
      }
    }
  }
}

或者使用 Claude Desktop OAuth 流程：只设置 url，Claude 就会在首次调用时提示你授权。

Claude Code

claude mcp add --transport http stable-baseline \
  https://api.stablebaseline.io/functions/v1/cloud-serve/mcp \
  --header "Authorization: Bearer sta_YOUR_KEY"

或者通过 OAuth：

claude mcp add --transport http stable-baseline \
  https://api.stablebaseline.io/functions/v1/cloud-serve/mcp

如需安装教 Claude Code 使用工作流（文档、图表、白板、数据库、仪表板和 Agent）的技能，请安装 Claude Code 的 Stable Baseline 插件。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "stable-baseline": {
      "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
      "headers": { "Authorization": "Bearer sta_YOUR_KEY" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "stable-baseline": {
      "serverUrl": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
      "headers": { "Authorization": "Bearer sta_YOUR_KEY" }
    }
  }
}

VS Code（Copilot Chat）

.vscode/mcp.json（工作区）或用户设置：

{
  "servers": {
    "stable-baseline": {
      "type": "http",
      "url": "https://api.stablebaseline.io/functions/v1/cloud-serve/mcp",
      "headers": { "Authorization": "Bearer ${input:sta_key}" }
    }
  }
}

其他客户端

Warp、OpenCode、Antigravity、OpenAI Codex、ChatGPT Developer Mode、Gemini CLI/Extensions 和通用配置示例见 stablebaseline.io/docs/mcp/setup。

What you get

Category	Sample tools	Docs
navigation	listOrganisations, getProjectHierarchy, searchTools	→
folders	createFolder, listFolders, setPlanItemParent	→
documents	createDocument, editDocument, exportDocument	→
diagrams	insertDiagramInDocument, listDiagramTypes, getCdmdLanguageGuide	→
whiteboards	createWhiteboard, addWhiteboardElements, designDeckInWhiteboard	→
images	createImageUploadSession, insertImageInDocument	→
data	createVegaDataUploadSession (CSV/JSON/TSV → Vega charts)	→
improvements	createImprovement, searchImprovements, addImprovementEvidence	→
plans	createPlan, createPlanPhase, previewTaskDependencyCascade	→
databases	createDatabase, queryDatabaseRows, saveDatabaseDashboard	→
agents	listAgents, delegateToAgent, approveAgentAction	→
knowledge_graph	kg_search, kg_get_entity, kg_related_documents	→
organization	createOrganisation, createWorkspace, createProject	→
members	inviteMember, updateMemberRole, setMemberActive	→
teams	createTeam, grantTeamWorkspaceAccess	→
permissions	upsertResourcePermission, setResourcePermissionOverride	→
billing	previewSubscriptionChange, applySubscriptionChange, purchaseCreditPackage	→
kg_admin	setKgWorkspaceScope, triggerKgRebuild, previewKgRebuild	→
settings	getOrgSettings, updateOrgFeatureFlags, createBrandKit	→
signup	startSignup, pollSignupStatus	→

Full live catalogue: stablebaseline.io/docs/mcp/tools

亮点

• 端到端由 Agent 管理：Agent 驱动注册 → 账单 → 组织／工作区／项目生命周期 → 成员 → 团队 → 权限 → 知识图谱范围。全程无需人工操作界面。
• 持续演进的文档：AI 原生富文本编辑器（CDMD = Markdown + 行内图表、数据表、媒体、版本历史、实时多人协作编辑），支持导出 PDF 和 Word。
• 可视化图表创建与编辑：支持 40 多种类型，可由 AI 生成、通过代码创建图表，也可徒手绘制。
• 数据库：由类型化字段组成的表格，包含视图、行规则、表单和实时仪表板。可导入 CSV 或 Excel，一次调用即可获取计数、总计和分组。
• Agent：组织自己的 AI 工作人员，各自拥有职责、限定范围的访问权限和审批流程。可从任何 MCP 客户端向 Agent 提问或委派任务、跟踪运行情况、决定是否采纳其提案，还可撤销整个任务。
• 计划、时间线、任务、改进项与 Bug：甘特图支持按日／周／月／季度／年缩放；可拖动调整排期，并级联更新依赖项。
• 自学习知识图谱（Enterprise）：从每份文档、计划、改进项和数据库记录中自动构建；每个已连接的 Agent 都可读取。避免在信息缺失时产生幻觉。可在整个工作区运行一个知识大脑，也可按部门或项目分别运行，并提供端到端的 RBAC。
• 合规就绪度（Enterprise）：依据 OWASP ASVS、NIST SSDF、CIS Controls、ISO 27001、SOC 2、TISAX 扫描。仅评估就绪度：不构成法律建议，也不代表认证。
• 自带 Agent，无厂商锁定：支持任何兼容 MCP 的客户端。
• 每项支出操作均遵循信用点费用预览流程：previewX → 确认令牌 → applyX。

身份验证

方法	使用场景
OAuth 2.1 + 动态客户端注册	桌面应用和 IDE 扩展的默认方式。Smithery 会自动处理。
Bearer API 密钥（sta_...）	CI/CD、无头 Agent、服务器到服务器。前往组织设置中的已连接应用、开发者页面创建（app.stablebaseline.io/settings/developers）。可将密钥限定到某个工作区、项目或文件夹，也可允许其访问整个组织。

OAuth 端点：

• authorize：https://api.stablebaseline.io/functions/v1/cloud-serve/oauth/authorize
• token：https://api.stablebaseline.io/functions/v1/cloud-serve/oauth/token
• register（DCR）：https://api.stablebaseline.io/functions/v1/cloud-serve/oauth/register
• 作用域：openid、profile、email、phone。这些作用域用于识别已登录用户，不决定 Agent 可以执行哪些操作：授权取决于各内容类型的读取／写入／删除权限，以及在同意页面中选择的组织功能开关。
• 权威元数据（请始终优先采用此处信息，而非以上列表）：https://api.stablebaseline.io/functions/v1/cloud-serve/.well-known/oauth-authorization-server

发现

入口	URL
.well-known/mcp.json（清单）	https://stablebaseline.io/.well-known/mcp.json
官方 MCP 注册表	https://registry.modelcontextprotocol.io/v0/servers?search=io.stablebaseline
Smithery	https://smithery.ai/servers/stablebaseline/sb-mcp
llms.txt	https://stablebaseline.io/llms.txt
robots.txt	https://stablebaseline.io/robots.txt
sitemap.xml	https://stablebaseline.io/sitemap.xml
security.txt	https://stablebaseline.io/.well-known/security.txt

定价

• 免费版：A$0，无需信用卡。AI 运行费用由组织自己的 AI 服务提供商账户承担。
• Plus：每月 A$39（不含 GST），每月含 300 个信用点。
• Pro：每位用户每月 A$79（不含 GST），每位用户每月含 500 个信用点。
• Enterprise：价格定制。增加知识图谱、合规就绪度和审计日志。联系。

各方案的完整限额：stablebaseline.io/pricing。

状态

• 🟢 MCP Registry：io.stablebaseline/sb，active，isLatest。已列出。
• 🟢 Smithery：已发布，并提供 configSchema（快速设置）。在线服务列出 222 个工具、11 个提示词和 8 个资源。
• 🟢 .well-known/mcp.json：在线，架构版本为 2025-06-18。
• 🟢 端点：api.stablebaseline.io/functions/v1/cloud-serve/mcp 接受带有 mcp-protocol-version: 2025-06-18 的 POST 请求。

问题与支持

• 错误或功能请求：在此处提交问题。
• 安全报告：参阅 .well-known/security.txt（RFC 9116 联系方式）。
• 常规支持：https://stablebaseline.io/contact

许可证

本仓库（README、llms-install.md、品牌素材及任何文档）采用 MIT 许可证授权，详见 LICENSE。你可以自由复制、分叉和改编这些文档。

Stable Baseline 产品本身（SaaS 应用、MCP 服务实现以及公司的知识图谱）为专有闭源产品，并依据 Stable Baseline 服务条款在 https://stablebaseline.io 作为服务提供。

---

由澳大利亚悉尼的 Orixian Solutions Pty Ltd 构建。