任意 MCP 客户端

一个托管服务器

该服务器托管在 https://mcp.foir.dev/mcp 并使用 Streamable HTTP。每个工具调用的是控制台和 CLI 所用的同一批平台 RPC，因此校验和行级作用域划分仍由平台负责。在启用了发布的模型上，记录写入会以草稿形式落地，发布和删除是单独的工具。你的智能体自带模型，所以连接它不会消耗 AI 额度。

两种认证方式

第一种是登录。把服务器的 URL 添加到你的客户端，首次使用时会在浏览器中打开 Fóir 的授权同意页面，你在其中授予不超过你自身级别的访问权限。之后智能体以你的身份行事。

第二种是机密API 密钥，适合 CI 和无人值守的任务。foir mcp 会运行一个指向托管服务器的本地代理，并在设置了 FOIR_API_KEY 时使用其中的密钥。此时智能体的可触及范围就是该密钥自身的作用域。公开密钥会被拒绝。

已登录的智能体能触及什么

登录后，智能体的令牌只能发现你有权访问的内容。它必须进入一个工作区，还可以选择进入一个项目和一个组织，这会签发一个带有你在该处有效权限的工作令牌。工作令牌有效期为 30 分钟并会重新签发，工作区和项目不能按调用选择。

每次请求都会按凭据所持有的内容过滤工具列表，因此两个人把同一个智能体连接到同一个项目，可能会得到不同的工具。

只读连接

在授权同意页面勾选“只读”，智能体就只会获得读取工具。无论智能体之后读取什么，授权同意都是上限，因此藏在内容中的指令无法把只读授权变成写入。CLI 代理对已登录的会话有一个对应的标志，但无法收窄密钥的权限。