★ FEATURED ARTICLE 【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址https://gitcode.com/gh_mirrors/th/thinkrail点击查看免费下载ThinkRail 是一款轻量级 AI 编程 IDE内置了完整的 MCPModel Context Protocol服务器管理能力。本文将从零带你完成 MCP 服务器配置用 3 步添加第一个服务器、看懂 5 个内置预设Context7、DeepWiki、Linear、Sentry、Playwright并一次讲透 ThinkRail 独有的双层审批机制——让 AI 在改动任何数据之前先征得你的同意。为什么你需要配置 MCP 服务器MCP 服务器相当于给 AI 装上的外接插件查文档Context7 可以拉取最新的库和框架文档避免模型记错API接工作流Linear、Sentry 让 AI 直接读取你的 issue 和报错操作浏览器Playwright 让 AI 真实打开网页、执行端到端验证ThinkRail 基于 pi 内置的 MCP 引擎运行这些服务器配置入口只有一个Settings › MCP servers。一分钟找到配置入口所有 MCP 相关操作都在设置面板的Agent分组里包含 Models、Providers、MCP servers、Prompt templates。打开它需要先在 ThinkRail 中激活一个工作区否则页面会提示 Open a workspace to manage its MCP servers。每个服务器行都会显示状态圆点与原因、User / Project 作用域徽章、HTTP / stdio 传输徽章、曝光exposure菜单和启用开关。完整的面板逻辑见 McpSettings.tsx。MCP 服务器配置在哪个文件ThinkRail 沿用 pi 的两级mcp.json配置层级文件位置作用范围用户级~/.pi/agent/mcp.json所有项目可用项目级工作区下的.pi/mcp.json随 git 提交仅本项目需审批后才运行最小可用配置长这样两种传输方式二选一{ mcpServers: { docs: { url: https://example.com/mcp }, browser: { command: npx, args: [-y, playwright/mcp0.0.83] } } } 个人使用的服务器放用户级文件只有当你要把服务器分享给整个仓库时才写入.pi/mcp.json。快速上手5 个内置预设详解打开 Settings › MCP servers 点击Add第一档就是内置预设——5 个经过验证、版本锁定的一键安装选项源码定义在 mcpPresets.ts预设传输方式需要登录能做什么Context7HTTP❌查最新库/框架文档开箱即用DeepWikiHTTP❌提问任意公开 GitHub 仓库开箱即用Linear (read-only)HTTP✅ OAuth只读访问 issue、项目与评论SentryHTTP✅ OAuth读取 issue、事件与 release可修改数据Playwrightstdio❌驱动本机浏览器仅对当前项目生效几个新手最容易忽略的细节Context7 和 DeepWiki使用exposure: direct工具会像内置工具一样预先声明给模型连接即用。Linear默认走厂商只读端点/mcp/readonly添加后在服务器行的Sign in完成 OAuth 登录即可。Sentry标记为可修改数据——每次写操作都会触发审批弹窗后文细讲。Playwright以禁用状态加入用户级配置同时为当前项目写入启用覆盖即optInPerProject它只在你主动选择的项目里运行且绝不污染仓库文件。预设下方还有一个Use recipe选项会填入 GitHub 的只读端点配方基于gh auth token因为它依赖本机 GitHub CLI 登录状态所以被设计成配方而非预设。手动添加表单、Paste JSON 与命名规则Add对话框共三档逐档灵活预设上面 5 个短表单填服务器名、选择传输方式stdio 填 command argshttp 填 URL、按需添加 env / headers、选作用域Paste JSON直接粘贴mcpServers配置块逐个服务器预览校验SSE 或不合规条目会被标红表单校验非常严格见 mcpEntries.ts记住三条规则即可名称只能用字母、数字、-和_且-/_互换的同名会互相冲突SSE 传输不受支持请改用服务器的 streamable HTTP 地址通常以/mcp结尾包版本务必锁定如playwright/mcp0.0.83不要写latest密钥怎么填只存引用不存明文这是 ThinkRail MCP 配置最重要的安全设计表单里的 env 和 header 值只接受两种引用${GITHUB_TOKEN}—— 从宿主环境变量读取!gh auth token—— 每次聊天连接时执行命令取其输出要求命令足够快比如读缓存的 token任何明文密钥都会被直接拒绝粘贴到 URL 里的凭据同样会被拦截并提示你改用Authorization: Bearer ${TOKEN}这类 header。这样mcp.json可以放心提交进 git。审批机制全解析ThinkRail 如何替你把关ThinkRail 的审批分两层服务器级审批管这个仓库自带的 MCP 服务器能不能跑工具调用级审批管这一次调用能不能动数据。第一层仓库自带服务器的Review approve如果同事在.pi/mcp.json里放了一个 MCP 服务器ThinkRail不会直接启动它。你会在 Settings 里看到一行Review approve按钮点击后它会列出将要执行的完整命令行或 URL凭据参数显示为***工作目录每一个!command所有 env / header 名称及其引用确认后 ThinkRail 用该条目的指纹SHA-256 项目记录记录批准。这意味着仓库不能自带预批准——授权存于项目记录而不是.pi/mcp.json条目内容任何改动都会使审批失效需要重新审查项目未被信任trust时.pi/mcp.json根本不会被加载第二层工具调用的 4 个选项当 AI 调用一个可能修改数据的 MCP 工具时问题会直接显示在聊天里的工具卡片上并完整列出本次调用的参数四个按钮按风险从低到高排列Deny · Allow once · Allow in this chat · Always allow选项生效范围适合场景Deny本次调用直接拒绝不确定的操作Allow once仅这一次偶发的一次性写入Allow in this chat当前聊天会话本轮任务里的重复调用Always allow本项目所有聊天长期信任的单个工具几个关键细节声明了readOnlyHint: true的只读工具不会弹审批Always allow只信任那一个工具且授权存放在项目记录里一旦服务器的 command 或 URL 发生变化授权自动失效、下次重新询问想收回授权去Settings › MCP servers管理即可已打开的聊天会在下一次调用时立刻生效聊天中直接发送消息即可取消正在等待的审批弹窗完整的引擎与守卫实现见 agent/mcp/SPEC.mdAI 助手管理 MCP 服务器的行为准则见 managing-mcp-servers/SKILL.md。常见问题速查改了mcp.json要重启吗不用。空闲聊天会自动热加载忙碌中的聊天会在空闲时自动生效。连接失败怎么办服务器行会出现Reconnect和Show log日志内容已由宿主自动脱敏token、Bearer 凭据等被掩码。保存失败报错所有写操作都携带渲染时的指纹做乐观锁报错通常说明另一个客户端或 git checkout 改动了文件——刷新后从最新条目重试即可。项目级条目想改用Edit以 JSON 方式编辑明文值显示为literal value hidden占位标记保留原值新值必须是引用。相关实现与测试McpServerDialogs.tsx、mcp-settings.spec.ts。小结配置入口Settings › MCP servers两级mcp.json用户级 项目级新手路径预设一键添加 → Sign inOAuth 服务器→ 聊天中按需审批安全底线密钥只存${VAR}/!command引用仓库服务器先审批后运行写操作先问再动按这套流程走完你的 ThinkRail 就拥有了既方便又可控的 MCP 能力。赞分享【免费下载链接】thinkrailVibe code with pi in a lightweight, real IDE that customises itself around the way you work — The Vibe You Need项目地址https://gitcode.com/gh_mirrors/th/thinkrail点击查看免费下载相关推荐用 mcp-use 构建最小的 TypeScript MCP 服务器工具、资源与提示词一次讲透用 mcp use 构建最小的 TypeScript MCP 服务器工具、资源与提示词一次讲透 本篇技术指南以 examples/typescript/bas人工智能后端AI 应用MCP 服务SukiUI基于Avalonia的桌面UI库教程SukiUI基于Avalonia的桌面UI库教程 SukiUI 是一个基于 .NET 的 Avalonia 框架构建的免费桌面 UI 库提供丰富的主题支持和网络安全渗透测试CLIHappier MCP服务器配置教程一次定义、多处复用的AI工具终极方案Happier MCP服务器配置教程一次定义、多处复用的AI工具终极方案 Happier MCP服务器配置 是本文的核心主题。Happier 是一款支持 We上一篇如何使用Midori浏览器轻量级网页浏览的终极指南下一篇如何快速搭建Windows C/C开发环境MinGW-w64完整配置指南 创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
