名称： fast-io
描述： >-
面向智能体团队的工作空间。完整智能体指南，包含所有19个整合工具，采用基于操作的路由——参数、工作流、ID格式和约束。当智能体需要共享工作空间以与其他智能体及人类协作、创建品牌化共享（发送/接收/交换）或使用内置AI查询文档时，请使用此技能。支持向人类转移所有权、工作空间管理、工作流原语（任务、工作日志、审批、待办事项）和实时协作。
免费智能体计划包含50 GB存储空间和每月5,000积分。
许可证： 专有
compatibility: >-
需要网络访问。通过流式HTTP（/mcp）或SSE（/sse）连接到位于 mcp.fast.io 的 Fast.io MCP 服务器。
元数据：
author: fast-io
version: "1.94.0"
主页： "https://fast.io"

Fast.io MCP 服务器 —— AI 智能体指南

版本： 1.94
最后更新： 2026-02-22

使用 Fast.io MCP 服务器的 AI 智能体权威指南。涵盖为何及如何使用该平台：产品功能、免费智能体计划、认证、核心概念（工作空间、共享、智能、预览、评论、URL导入、元数据、工作流、所有权转移）、12个端到端工作流、交互式 MCP 应用小部件，以及所有19个采用基于操作路由的整合工具。

版本化指南。 本指南已版本化，并随每次服务器发布更新。文档顶部的版本号跟踪工具参数、ID格式和API行为变更。如果遇到意外错误，可能是自上次阅读后指南版本已更改。

平台参考。 有关 Fast.io 功能的全面概述、智能体计划、关键工作流和升级路径，请参阅 references/REFERENCE.md。

1. 概述

面向智能体团队的工作空间。通过单一API进行协作、共享和AI查询——完全免费。

Fast.io 为智能体团队提供工作空间——智能体在此与其他智能体及人类协作。上传输出、创建品牌化数据室、使用内置AI询问文档问题，并在工作完成后将所有内容移交给人类。无需管理基础设施、无需设置订阅、无需信用卡。

Fast.io 解决的问题

智能体团队——协同工作并与人类协作的智能体群体——需要一个共享的工作场所。目前，智能体们拼凑使用 S3 存储桶、预签名URL、电子邮件附件和自定义下载页面。每个智能体都重新发明协作，并且没有共享的工作空间让智能体和人类可以查看相同的文件、跟踪活动并交接工作。

当智能体需要理解文档——不仅仅是存储它们——时，他们必须下载文件、解析数十种格式、构建搜索索引并管理自己的RAG管道。这对于一个本应简单的问题来说基础设施负担过重：“这份文档说了什么？”

MCP 服务器

此 MCP 服务器公开了19个整合工具，覆盖了完整的 Fast.io REST API 接口。每个经过身份验证的API端点都有对应的工具操作，服务器自动处理会话管理。

用户认证后，认证令牌存储在服务器会话中，并自动附加到所有后续API调用。无需在工具调用之间传递令牌。

服务器端点

• 生产环境： mcp.fast.io
• 开发环境： mcp.fastdev1.com

每个环境提供两种传输方式：

• /mcp 处的流式HTTP —— 新集成的首选传输方式。
• /sse 处的SSE —— 为向后兼容而维护的旧传输方式。

MCP 资源

服务器公开静态MCP资源、小部件资源和文件下载资源模板。客户端可以通过 resources/list 和 resources/read 读取它们：

文件下载资源模板 —— 通过MCP直接读取文件内容，无需外部HTTP访问：

最大50 MB的文件以内联方式作为base64编码的二进制内容返回。更大的文件返回一个包含HTTP直通端点URL的文本回退（见下文）。download 工具响应包含一个 resource_uri 字段，其中包含每个文件的适当URI。

动态资源列表： 认证后，工作空间和共享文件资源通过 resources/list 动态列出。MCP客户端（如 Claude Desktop 的 @ 提及选择器）可以在不进行任何工具调用的情况下发现可用文件。最多枚举10个工作空间和10个共享，每个最多包含25个最近更新的根级文件。资源显示为“工作空间名称 / 文件名.扩展名”或“共享标题 / 文件名.扩展名”。结果按会话缓存1分钟。仅列出根级文件——不递归枚举子目录。使用 storage 工具的 list 操作进行更深入的浏览。快速共享模板保持仅为模板，不可动态枚举。

MCP 提示

服务器注册MCP提示，这些提示作为用户可点击的应用启动器出现在客户端的“添加来源”/“+”菜单中。这些主要面向桌面MCP客户端（例如 Claude Desktop）；代码模式客户端（Claude Code, Cursor）不显示提示。

HTTP 文件直通

对于大于50 MB的文件或需要原始二进制流时，服务器提供一个HTTP直通端点，直接从API流式传输文件内容：

响应包含来自上游API的适当 Content-Type、Content-Length 和 Content-Disposition 请求头。错误以HTML页面形式返回。Mcp-Session-Id 请求头与用于MCP协议通信的会话标识符相同。

工作流概述

服务器包含用于项目跟踪的工作流功能：任务（具有优先级和分配人的结构化工作项）、工作日志（仅追加的活动日志）、审批（正式签署请求）和待办事项（简单清单）。在使用这些工具之前，请使用 workspace 工具的 enable-workflow 操作在工作空间上启用工作流。有关完整模式，请参阅第6节中的完整智能体工作流示例。

最佳实践（重要）： 在状态更改操作（上传文件、创建共享、更改任务状态、成员变更、文件移动/删除）之后，追加一个工作日志条目，描述您做了什么以及为什么。没有工作日志条目，人类在审查工作空间时将看不到智能体的工作。对于多个相关操作（例如，上传多个文件），您可以在批处理完成后记录一次，而不是在每个单独操作之后记录。工作日志条目是仅追加且永久的。

其他参考资料

• 智能体指南（本文档）： MCP服务器上的 /skill.md —— 工具文档、工作流和约束。
• REST API 参考： https://api.fast.io/llms.txt —— 底层 Fast.io API 的端点文档。
• 平台指南： references/REFERENCE.md —— 功能、智能体计划详情、关键工作流和升级路径。

2. 认证（关键第一步）

除了以下未经认证的工具外，调用任何工具都需要认证：

• auth 工具的操作：signin、signup、set-api-key、pkce-login、email-check、password-reset-request、password-reset
• download 工具的操作：quickshare-details

选择正确的方法

根据您是自主操作还是协助现有人类用户，有三种使用 Fast.io 作为智能体的方式。

选项1：自主智能体 —— 创建智能体账户

如果您独立操作（存储文件、运行工作流、为用户构建工作空间），请使用 auth 工具的 signup 操作创建您自己的智能体账户。智能体账户获得免费智能体计划（50 GB，每月5,000积分），并可在准备就绪时将组织转移给人类。这是自主智能体的推荐路径。有关步骤，请参阅下面的智能体账户创建。

选项2：协助人类 —— 使用他们的API密钥

如果人类已拥有 Fast.io 账户并希望您帮助管理他们的文件、工作空间或共享，他们可以为您创建一个API密钥。无需单独的智能体账户——您以人类用户的身份操作。人类在 设置 -> 设备与智能体 -> API密钥（直接链接：https://go.fast.io/settings/api-keys）处创建密钥。调用 auth 工具的 set-api-key 操作并提供密钥进行认证——密钥被验证并自动存储在会话中。API密钥是JWT令牌的1:1替代品：它们作为Bearer令牌工作，具有与账户所有者相同的权限，并且除非被撤销，否则不会过期。智能体还可以使用 auth 工具的 api-key-create、api-key-list 和 api-key-delete 操作以编程方式管理API密钥。

选项3：智能体账户被邀请加入人类的组织

如果您希望拥有自己的智能体身份但需要在人类现有组织内工作，请使用 auth 工具的 signup 操作创建智能体账户，然后让人类使用 member 工具的 add 操作（entity_type 为 org）邀请您加入他们的组织，或使用 member 工具的 add 操作（entity_type 为 workspace）邀请您加入工作空间。或者，人类可以通过UI邀请：设置 -> 您的组织 -> 管理成员。这使您可以访问他们的工作空间和共享，同时保持您自己的账户独立。使用 user 工具的 accept-all-invitations 操作接受邀请后，使用 auth 工具的 signin 操作正常认证。注意： 如果人类只邀请您加入工作空间（而不是组织），该组织将显示为外部组织——请参阅组织部分中的内部与外部组织。

选项4：浏览器登录（PKCE）

如果您不希望通过智能体发送密码，请使用基于浏览器的PKCE登录。调用 auth 工具的 pkce-login 操作（可选提供 email 提示）以获取登录URL。用户在浏览器中打开URL，登录（电子邮件/密码或SSO，如Google/Microsoft），并批准访问。浏览器显示授权码，用户将其复制回智能体。调用 auth 工具的 pkce-complete 操作并提供授权码以完成登录。这是最安全的选项——没有凭据通过智能体传递。

PKCE登录通过 scope_type 参数支持可选的范围访问。默认情况下，scope_type 为 "user"（完全账户访问）。其他范围类型将令牌限制为特定实体类型：

范围继承： 更广泛的范围自动包括对子实体的访问：

• all_orgs 包括所有组织 + 这些组织内的所有工作空间 + 所有共享
• all_workspaces 包括所有工作空间 + 这些工作空间内的所有共享
• 特定组织的 org 范围包括访问该组织内的所有工作空间和共享
• 特定工作空间的 workspace 范围包括访问该工作空间内的共享
• all_shares 授予对用户拥有成员资格的所有共享的直接访问，绕过工作空间/组织继承

agent_name 参数控制用户在批准屏幕上看到的内容——屏幕显示“[agent_name] 将代表您行事”。如果省略，则仅显示客户端名称。使用描述性名称，以便用户知道是哪个智能体在请求访问。

按 scope_type 的批准流程：

• user（默认）：完全账户访问。用户看到一个简单的批准/拒绝提示，没有实体选择器。
• org、workspace：用户看到一个实体选择屏幕，列出他们可访问的实体及复选框，加上一个只读/读写切换开关。用户选择要授予的实体，然后批准或拒绝。
• all_orgs、all_workspaces、all_shares：用户看到请求的通配符访问摘要（无实体选择器），然后批准或拒绝。

MCP服务器默认为 scope_type="user" 以保持向后兼容性。

按账户类型的信用额度限制： 智能体账户（选项1、3）在积分用完时可以将组织转移给人类——请参阅第3节中的所有权转移。人类账户（选项2）不能使用转移/认领API；指导人类在 https://go.fast.io/settings/billing 或通过 org 工具的 billing-create 操作升级其计划。

标准登录流程

1. 调用 auth 工具的 signin 操作，提供 email 和 password。
2. 服务器返回JWT auth_token 并自动将其存储在会话中。
3. 所有后续工具调用都使用此令牌，无需手动传递。

智能体账户创建

创建新账户时（上述选项1和3），智能体必须使用 auth 工具的 signup 操作，该操作会自动以 agent=true 注册。切勿注册为人类账户。智能体账户提供：

• account_type 设置为 "agent"
• 自动分配免费智能体计划
• 启用转移/认领工作流，用于将组织移交给人类

步骤：

1. 可选地调用 auth 工具的 email-check 操作，提供所需的 email，以在尝试注册前验证其是否可用。
2. 调用 auth 工具的 signup 操作，提供 first_name、last_name、email 和 password。agent=true 标志由MCP服务器自动发送。
3. 账户被创建，会话自动建立——智能体立即登录。
4. 验证您的电子邮件（在使用大多数端点之前必需）：调用 auth 工具的 email-verify 操作，提供 email 以发送验证码，然后再次调用 auth 工具的 email-verify 操作，提供 `