AI Specialists Hub - MCP 集成

连接

通过 HTTP POST 调用 MCP 端点。端点 URL 存储在 TOOLS.md 中，或由用户直接提供。

curl -s -X POST "$MCP_URL" 
  -H "Content-Type: application/json" 
  -H "Accept: application/json, text/event-stream" 
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"TOOL_NAME","arguments":{...}}}'

关键请求头：必须包含 Accept: application/json, text/event-stream，否则服务器将返回 406 错误。

响应格式：SSE（Server-Sent Events）—— 解析方式为：response.split('data: ')[1] → JSON → result.content[0].text

可用工具

发现与管理

工作区导航

文档操作

文件夹操作

参数说明：specialist 标识符始终为 list_specialists 返回结果中 id 字段的值，而非显示名称。请统一使用小写形式（例如：ruby、peter、benjamin）。

与 Specialist 协同工作

每个 specialist 均拥有一个 ai-instructions/ 文件夹，其中包含其身份定义与行为指令。首次使用尚未加载过的 specialist 时，务必优先阅读这些文件：

ai-instructions/
├── core-instructions.md    # 其身份定位、职责范围与行为准则
└── getting_started.md      # 初始化流程、工作区结构说明

模式：与 Specialist 的首次交互

1. list_specialists → 获取目标 specialist 的 id
2. read_specialist_documents → 读取 ai-instructions/core-instructions.md 与 ai-instructions/getting_started.md
3. 理解其专业领域、工作区结构及沟通风格
4. explore_specialist_tree → 查看其完整工作区结构
5. 基于上下文信息，即可开始对其数据开展有依据的操作

模式：快速获取数据

1. explore_specialist_tree → 定位所需文件
2. read_specialist_documents → 批量读取（比逐个读取更高效）
3. 向用户汇总呈现关键信息

模式：更新 Specialist 数据

1. 先读取原始文档内容
2. 按需修改内容
3. update_specialist_document → 写回更新（若文档不存在则新建，存在则覆盖）
4. 如需新建文件夹：先调用 create_specialist_folder，再向其中写入文档

用户注册（代理发起的入驻流程）

若您的终端用户尚无 AI Specialists Hub 账户，您可通过公开注册 API 为其创建账户：

curl -s -X POST "https://aispecialistshub.com/api/v1/signup" 
  -H "Content-Type: application/json" 
  -d '{"username":"","email":"","password":""}'

响应（HTTP 201）：

{
  "username": "...",
  "mcpKey": "...",
  "accountStatus": "unverified",
  "specialistLimit": 2,
  "message": "..."
}

⚠️ 关键提示：凭证交接

您必须将全部凭证完整交付给终端用户。无论用户名/邮箱/密码是自动生成还是由用户自主设定，均须确保用户明确获知以下四项信息：

1. 用户名 — 用于登录 aispecialistshub.com 网页控制台
2. 邮箱 — 用于账户验证
3. 密码 — 用于登录 aispecialistshub.com 网页控制台
4. MCP key — 用于将 AI 工具连接至其 specialist

切勿对用户隐瞒任何凭证。账户归属权属于用户本人，请在注册完成后清晰、完整地展示全部四项凭证。

未验证账户限制

• 最多可聘用 2 名 specialist（默认自动聘用 Friday）
• 具备完整的 MCP 访问权限 —— specialist 可立即投入运行
• 可使用用户名与密码登录网页控制台
• 完成邮箱验证后可解锁完整功能（包括增加 specialist 数量）

注册流程

1. 确认终端用户是否需要 AI Specialists Hub 账户
2. 收集或生成：用户名、邮箱、密码
3. 调用 POST /api/v1/signup
4. 将全部凭证交付终端用户（用户名、邮箱、密码、MCP key）
5. 在您的配置中保存 MCP 端点 URL：https://aispecialistshub.com/api/v1/mcp//
6. 开始通过 MCP 使用 specialist

配置

将 MCP 端点 URL 存入 TOOLS.md：

### AI Specialists Hub
- MCP endpoint: https://aispecialistshub.com/api/v1/mcp//

有关 specialist 工作区约定的详细说明，请参阅 references/specialists-guide.md。