API参考：MCP

MCP服务器通过Model Context Protocol让AI助手与ProcessMind交互。它通过Streamable HTTP使用JSON-RPC 2.0：先发送initialize，再发送tools/list以发现工具目录。只有当API密钥具有read权限范围时，才会列出list_processes等读取工具；写入工具需要write权限范围。使用tools/call并传入参数调用工具。跨会话信息可通过记忆工具存储（remember、recall、forget），长时间运行的AI生成任务则按工具调用进行跟踪：在_meta["io.modelcontextprotocol/related-task"]中附加任务引用，ProcessMind会随调用返回该任务的状态。系统不提供tasks/list、tasks/get和tasks/cancel扩展方法。

Model Context Protocol服务器端点（通过Streamable HTTP使用JSON-RPC）

通过Streamable HTTP传输JSON-RPC 2.0：initialize、tools/list、tools/call、resources/list、resources/read、prompts/list。读取工具需要密钥的read作用域，写入工具需要write作用域。工具目录详见MCP指南。使用x-api-key或Authorization: Bearer <token>进行身份验证（令牌来自OAuth令牌端点）。

端点： POST /v1/mcp/{tenantId}

**身份验证：**租户作用域API密钥·read作用域·速率限制20 req/s（突发40）

参数：

名称	类型	位置	必填	描述
tenantId	string	路径	是	格式：uuid

请求正文：

MCP JSON-RPC请求

{}

响应（200）：

MCP JSON-RPC响应

{
	"message": "string"
}

字段	类型	必填	描述
message	string	是

错误：

• 401缺少、无效、已禁用或已过期的API密钥
• 403API密钥缺少所需作用域或组织访问权限，租户未激活，或套餐不支持该文件类型

OAuth 2.1授权端点（PKCE），302重定向回redirect_uri，并附带?code=…

端点： GET /v1/mcp/{tenantId}/oauth/authorize

**身份验证：**公开访问，无需API密钥·速率限制10 req/s（突发20）

参数：

名称	类型	位置	必填	描述
tenantId	string	路径	是	格式：uuid
client_id	string	查询参数	是
redirect_uri	string	查询参数	是	格式：uri
code_challenge	string	查询参数	是
code_challenge_method	S256	查询参数	否	允许的值：S256
state	string	查询参数	否

错误：

• 302重定向到redirect_uri，并附带code和state
• 400错误请求，例如筛选表达式无效、流程没有模型、不支持的上传类型或缺少必填字段
• 401缺少、无效、已禁用或已过期的API密钥

OAuth 2.0令牌端点（client_credentials或authorization_code+PKCE）

端点： POST /v1/mcp/{tenantId}/oauth/token

**身份验证：**公开访问，无需API密钥·速率限制5 req/s（突发10）

参数：

名称	类型	位置	必填	描述
tenantId	string	路径	是	格式：uuid

响应（200）：

访问令牌

{
	"access_token": "string",
	"token_type": "Bearer",
	"expires_in": 0
}

字段	类型	必填	描述
access_token	string	是	用于POST /v1/mcp/{tenantId}的短期Bearer JWT
token_type	Bearer	是	允许的值：Bearer
expires_in	number	是

错误：

• 400错误请求，例如筛选表达式无效、流程没有模型、不支持的上传类型或缺少必填字段
• 401缺少、无效、已禁用或已过期的API密钥
• 403API密钥缺少所需作用域或组织访问权限，租户未激活，或套餐不支持该文件类型