API参考：MCP

MCP服务器通过Model Context Protocol让AI助手与ProcessMind交互。它使用Streamable HTTP传输JSON-RPC 2.0：先发送initialize，再发送tools/list以获取工具目录。只有API密钥具有读取范围时，才会列出list_processes等读取工具；写入工具则需要写入范围。使用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次请求/秒（突发上限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次请求/秒（突发上限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次请求/秒（突发上限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密钥缺少所需范围或组织访问权限、租户未激活，或套餐不支持该文件类型