名称： fast-io
描述： >-
云文件管理与协作平台。当用户需要存储文件、创建品牌化共享空间（发送/接收/交换）或使用内置RAG AI查询文档时，请使用此技能。支持将所有权转移给人类、管理工作区以及实时协作。包含266个工具，涵盖身份验证、文件上传、AI聊天和组织管理。提供免费的智能体计划，包含100 GB存储空间和每月5,000积分。
许可证： 专有
compatibility: >-
需要网络访问。通过流式HTTP (/mcp) 或SSE (/sse) 连接到位于 mcp.fast.io 的 Fast.io MCP 服务器。
元数据：
author: fast-io
version: "1.29.0"
主页： "https://fast.io"

Fast.io MCP 服务器

存储文件。与人类共享。用AI查询。一个API搞定所有——免费。

此为摘要文档。 包含所有266个工具参数、工作流、ID格式和限制的完整智能体指南位于 https://mcp.fast.io/skill.md —— 建议在每个会话开始时获取。

Fast.io 为AI智能体提供了一个完整的文件管理与协作平台。上传输出、创建品牌化数据空间、使用内置AI查询文档，并在任务完成后将所有内容移交给人类。

连接到服务器

MCP 资源

可通过 resources/list 和 resources/read 获取两种资源：

MCP 提示

通过 prompts/list 和 prompts/get 提供八个用于常见操作的引导式提示：

快速开始

1. 创建智能体账户

auth-signup → first_name, last_name, email, password

智能体账户免费，无需邮箱验证，永不过期。会话会自动建立。JWT令牌有效期为1小时——过期后调用 auth-signin 重新认证。API密钥（人类账户）永不过期。

2. 创建一个组织

org-create → name, domain (3+字符，小写字母数字+连字符)

智能体组织获得免费计划：100 GB存储空间，每月5,000积分，5个工作区，50个共享空间。

3. 创建一个工作区

org-create-workspace → org_id, name, folder_name (URL slug)

工作区是包含AI聊天、成员管理和共享功能的文件存储容器。

替代方案：协助现有用户

如果人类用户已有 Fast.io 账户，他们可以在 https://go.fast.io/settings/api-keys 创建API密钥，并将其作为Bearer令牌提供。无需创建智能体账户。

组织发现（重要）

要查找所有可用组织，务必同时调用：

• list-orgs —— 您作为直接成员加入的内部组织
• orgs-external —— 您仅通过工作区成员身份访问的组织

当人类用户邀请智能体加入工作区而非整个组织时，外部组织是最常见的情况。仅检查 list-orgs 的智能体会完全错过这些组织。

核心概念

工作区

协作式文件存储容器。每个工作区包含成员、文件夹层次结构、AI聊天和共享空间。免费计划提供100 GB存储空间。

智能开关： 关闭 = 纯存储。开启 = 具备自动RAG索引、语义搜索、自动摘要和元数据提取功能的AI知识库。默认启用。

共享空间

专为与工作区外人员交换文件而设计的空间：

• 发送 —— 向人类交付文件（报告、导出、生成内容）
• 接收 —— 从人类收集文件（文档、数据集、提交内容）
• 交换 —— 双向协作（协作工作流、评审周期）

功能：密码保护、过期时间、自定义品牌、访问级别、访客聊天、下载控制。

存储节点

文件和文件夹由30个字符的不透明ID标识。使用 root 表示根文件夹，trash 表示回收站文件夹。

配置文件ID

组织、工作区和共享空间使用19位数字字符串标识符。

核心能力

AI 聊天

AI聊天为只读模式。 它可以读取、分析、搜索和回答关于文件内容的问题，但无法修改文件、更改设置、管理成员或访问事件。所有超出读取文件内容的操作都必须通过MCP工具直接完成。

两种聊天类型：

• chat —— 常规对话，无文件上下文
• chat_with_files —— 基于您的文件并附带引用

两种文件上下文模式（互斥）：

• 文件夹/文件范围（RAG） —— 搜索索引内容；需要开启智能功能
• 文件附件 —— 直接读取文件；最多10个文件；无需智能功能

风格： concise（简短回答）或 detailed（全面详细，默认）。可在创建聊天或每条消息时设置。

AI 聊天工作流

ai-chat-create → workspace_id, query_text, type
ai-message-read → workspace_id, chat_id, message_id  (自动轮询直至完成)
ai-message-send → workspace_id, chat_id, query_text   (后续消息)

使用 activity-poll 进行高效等待，而不是在循环中轮询消息详情。

文件上传

文本文件（推荐）

upload-text-file → profile_type, profile_id, parent_node_id, filename, content

单步上传文本类文件（代码、markdown、CSV、JSON、配置文件）。创建会话、上传、完成并轮询直至存储完成——返回 new_file_id。

二进制或大文件（分块流程）

upload-create-session → profile_type, profile_id, parent_node_id, filename, filesize
upload-chunk → upload_id, chunk_number, content | blob_ref | data (三选一)
upload-finalize → upload_id (轮询直至存储完成，返回 new_file_id)

分块数据的三种选项（仅提供一种）：
- content —— 文本（字符串、代码、JSON）。不要将文本放入 data。
- blob_ref —— 二进制文件首选。将原始字节 POST 到 /blob，并附带 Mcp-Session-Id 请求头和 Content-Type: application/octet-stream。返回 { blob_id, size }。将 blob_id 作为 blob_ref 传递。避免base64开销。Blob在5分钟后过期，使用时消耗。
- data —— 旧版base64编码的二进制数据。仍受支持，但会增加约33%的大小开销。

共享空间工作流

share-create → workspace_id, type (send/receive/exchange), title
share-add-file → share_id, node_id (向共享空间添加文件)

共享链接：https://go.fast.io/shared/{custom_name}/{title-slug}

所有权转移

构建包含工作区、共享空间和文件的组织，然后转移给人类：

org-transfer-token-create → org_id (返回64字符令牌，有效72小时)

认领URL：https://go.fast.io/claim?token={token}

人类成为所有者，智能体保留管理员访问权限。人类获得14天试用期并可升级。

常见模式

• 下载： 工具返回下载URL；从不流式传输二进制数据。
• 分页： 存储列表端点使用基于游标的分页 (sort_by, sort_dir, page_size, cursor; 检查 next_cursor)。所有其他列表端点支持限制/偏移分页 (limit 1-500，默认100; offset 默认0)。
• 回收站/删除/清除： 删除会移至回收站（可恢复）。清除会永久销毁（请先与用户确认）。
• 活动轮询： 使用带 wait=95 的 activity-poll 进行高效变更检测，而不是轮询资源端点。

智能体计划（免费）

$0/月。无需信用卡，无试用期，永不过期。

积分覆盖范围：存储（100/GB）、带宽（212/GB）、AI令牌（1/100令牌）、文档摄取（10/页）。

积分用完后，将组织转移给可以升级到无限积分的人类用户。

工具类别（266个工具）

权限值（快速参考）

组织创建 (org-create)：

工作区权限 (org-create-workspace, workspace-update)：

共享空间权限 (share-create)：

完整参数文档和限制请参阅完整指南。

详细参考

此技能文件为摘要。包含所有266个工具参数、工作流和限制的完整智能体指南由MCP服务器直接提供：

获取完整指南： https://mcp.fast.io/skill.md

这是权威参考文档——建议在每个会话开始时获取以获取最新的工具文档。它涵盖：

• 所有266个工具的完整参数参考
• 详细的AI聊天文档（文件上下文模式、问题措辞、响应处理）
• 完整的URL构建指南（含深度链接）
• 积分预算管理
• 所有端到端工作流及分步说明
• ID格式、编码规则和常见问题

另请参阅：references/REFERENCE.md —— 平台能力、智能体计划详情和升级路径。