教程2026-11-06 · 智涌AI

Positron MCP 怎么接:让 Claude Code / Codex 看见数据会话

Positron MCP 配置教程头图:打开 ai.mcp.enabled,用 Add to Coding Agent 接 Claude Code 或 Codex,让 Agent 看见数据会话并在 Console 标注执行

你已经在用 Claude Code 或 Codex,却又离不开 Positron 里的数据帧、控制台和图。Positron 2026.10 起内置实验性 Positron MCP:打开开关后,第三方 Agent 按标准 MCP 连上 IDE,能看见已加载数据、在 Console 里跑 R/Python,并对着当前图改参数。下面按 Posit 开源博客(2026-11-04)与官方 Release Notes(2026.10 / 2026.11)整理配置步骤、能力边界和安全口径;站内短讯见 Positron 实验 MCP。

先分清两件事

不装 MCP,Claude Code / Codex 扩展也能在 Positron 里用,体感接近「在普通终端里开 Agent」:看不见已加载对象、看不见当前图,要跑代码就走 shell,你也难在 Console 里跟住它。

打开 Positron MCP 之后,官方列的能力是:

能力官方表述对你意味着什么
已加载数据Agent 能看见 loaded data少粘贴 CSV 头 / df.head()
控制台在 R/Python Console 跑码,带 Agent 名标注你能看见它跑了什么
图看见当前 plot,帮你迭代改图参数不用截图往返
会话列会话、读近期历史、打断长计算跟住正在跑的分析
命令可搜并跑 Positron 命令和 IDE 动作对齐
项目范围按窗口 / 项目各起一份 MCP没开文件夹的窗口当前不起服务

十月亮点文还写:目标是让第三方 Agent 拿到一套接近 Posit Assistant 的 IDE 工具面——列会话、在 Console 执行、检查对象又不污染你的历史、读近期会话、打断长计算、看当前图、搜索并执行 Positron 命令。第三方 harness 未必有 Assistant 那套数据科学经验,但写代码、探数据已经够用。

官方原话:把 Positron MCP 暴露给 Agent,等价于给它不受限的 shell 访问(代码以你的用户身份跑)。

前置条件

第一步:打开 MCP 开关

在 Settings 里启用 MCP: Enabled(设置项对应 ai.mcp.enabled,Release Notes 标为 experimental)。打开后,Positron 对外暴露一个标准 MCP 服务,终端里的 CLI Agent 和扩展里的 Agent 都可以连。

2026.11 的说明补充:第三方 Agent 通过稳定路径上的 launcher启动 MCP,升级 Positron 后原有 Agent 配置不必重写 URL。以前手写本机临时路径的人,升级后最容易踩断连;稳定 launcher 就是为这个。

第二步:一键写进 Agent 配置

命令面板运行:

Positron MCP: Add to Coding Agent

官方会按已知列表自动写配置。2026.10 起可配 Claude Code(扩展侧也可自动)、Codex CLI、Gemini CLI;2026.11 起「Add to Coding Agent」还覆盖 OpenCode、Copilot CLI、Kiro CLI。

列表里没有你的 harness 时:

Positron MCP: Show Connected Agents

选 Copy Connection Details,把 URL / token 贴进该 Agent 的 MCP 配置。连上之后一般不用手启停服务,Positron 会管连接生命周期。

多项目并行时记住:每个打开了文件夹的窗口各有一份 MCP,且知道自己对应哪个项目。不是全机共用一个 MCP 端口。连错窗等于连错数据环境。

第三步:确认连上,并点名用 MCP

可选打开 MCP Status Bar:已连接的 coding agent 会在状态栏出图标,悬停可看名单。不确定时直接问 Agent「你现在能不能用 Positron MCP / 看得到我的 Console 吗」。

官方建议:下任务时提到「Positron」或明确说「use the Positron MCP」。否则有的 harness 可能仍只走自己的 shell 工具,绕过 IDE 会话。

实用检查清单:

  1. 当前窗口打开了项目文件夹(不是空窗口)。
  2. Settings 里 ai.mcp.enabled 为开。
  3. Status Bar 能看到对应 Agent,或 Show Connected Agents 列表非空。
  4. 让 Agent 在 Console 跑一行无害查询(例如列出已加载对象名);Console 里应出现带 Agent 名的标注。
  5. 需要时再让它描述当前 plot 或对已加载表做汇总;若它仍要你粘贴 head(),多半没走 MCP。

十月亮点还提到:Console 标签页在「你没看着的那一侧」有代码在跑时会打点提示,不管代码来自 Posit Assistant 还是外部 Agent。跟住输出、别让长计算在后台偷跑完,靠的就是这些标注。

和 Posit Assistant、错误动作怎么并存

Posit Assistant 仍是 Posit 自家 harness,深度绑在 IDE 权限与数据科学流程上。MCP 路线面向已经为 Claude Enterprise / 公司 Codex 额度付过账、想继续用熟悉界面、又要摸到 Positron 会话的人。

2026.11 额外补了一刀:控制台、笔记本、Quarto 上的 Fix and Explain 可以把报错送给支持的第三方 coding agent(例如 Claude Code),用设置 ai.errorActions.agent 指定目标。它和 MCP 各管一段:MCP 把 IDE 工具面交给常驻 Agent;Fix and Explain 是单次错误快捷甩给外部 Agent。别混成同一步配置。

博客还提到:Posit 在探索用官方 SDK 把外部引擎接进模型选择器,让你在 Assistant 界面里跑 Claude / Copilot / Codex,同时保留 Assistant 的权限模型。那还在探索里;本教程只覆盖现成的 MCP 开关与一键配置。

常见坑

完成标准

最后

日常在 Positron 做探索性分析、又已经为 Claude / Codex 付过账的话,按上面三步打开 MCP,再让 Agent 对当前会话提问一次。需要 MCP 背景概念时,先看 MCP 是什么与怎么接;GitHub 侧工具集收窄可对照 GitHub MCP 怎么配;多 Agent 自带入座另见 BYOB 教程。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。