Composio For You 仪表板导航详解：Connect Apps、Connect my agent 与 Sessions & API Key 的完整操作指南
【免费下载链接】composioComposio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio
本文围绕 Composio 知识库中的 For You 导航文档（docs/kb/articles/dashboard-for-you-navigation.md）展开，系统讲解 For You 侧边栏的 Home、Connect Apps、Connect my agent、Help 四个入口，以及设置区 General、Members、Sessions & API Key、Billing 的用途与关键操作，并结合仓库中的消费者项目边界文档、Connect 文档和导航源码，说明消费者密钥（ck_*）与平台项目密钥（ak_*）的分工，帮助你在不混淆 For You 与 Platform 两个界面的前提下完成应用连接、Agent 接入和密钥轮换。
一、For You 是什么：与 Platform 的界面边界
在展开具体导航之前，需要先明确 For You 在整个产品模型中的位置。根据导航总览文档（docs/kb/articles/dashboard-navigation-overview.md）：
- Platform面向开发者：包含开发者项目、Playground、项目 API Keys、Toolkits、Skills、Users、Sessions、Auth Configs、Triggers、Logs 等资源，以及固定的 Support、Documentation、Settings 入口。
- For You面向个人使用者：把个人的应用（Gmail、Notion、GitHub 等）连接到支持的 Agent 和 MCP 客户端。
两者的资源互不自动可见：在一个界面创建的资源不会出现在另一个界面。因此，当用户说"我在 Platform 里连了 Gmail，为什么 Claude 里用不了"时，答案通常是——那是开发者项目侧的授权配置，消费者侧（For You / Connect）需要走独立的连接流程。这一点在边界文档（docs/kb/articles/consumer-project-boundaries-and-auth-selection.md）中有更完整的说明。
从文档站源码也可以印证这一"双产品"划分。在 docs/lib/home-navigation.ts 中，DOCS_PRODUCTS把文档站显式建模为两个产品：
for-you：切换器描述为 "Connect your apps to AI clients"，落地页指向/docs/agent-plugins，侧边栏包含 Agent plugins、Composio CLI、Connect with MCP（/docs/composio-connect）三条入门路径；platform：切换器描述为 "Build agents with the Composio SDK"，落地页为/docs/quickstart。
resolveDocsProduct函数（同文件 L224-L233）按"URL 前缀 → 持久化 cookie → 默认 Platform"的优先级解析当前产品，产品切换通过composio-docs-productcookie 持久化。也就是说，文档站本身就是一个 For You 与 Platform 双入口的导航器，与仪表板的产品切换器逻辑一致。
实操结论：当用户要的是"我个人应用的连接"，停留在 For You；当涉及项目级 auth config、项目用户、triggers、logs 或ak_...项目 API key 时，切换回 Platform。
二、For You 侧边栏：Home、Connect Apps、Connect my agent、Help
当前 For You 侧边栏包含四个入口，各自的定位与操作如下。
1. Connect Apps：认证提供方账户
打开Connect Apps，选中目标应用，点击Connect即可对某个提供方的账户完成认证（例如 Gmail、Notion、Slack）。这是 For You 的核心自助动作：连接属于"授权了该连接的成员"，而非工作区共享资源——另一位成员用自己的 Connect MCP 端点或自己的ck_*密钥时，解析到的是他自己的已连接账户，不会读到你的（见边界文档中 "Workspace members do not automatically share For You connections" 一节）。
2. Connect my agent：为 Agent / MCP 客户端生成接入配置
打开Connect my agent，选择当前要接入的目标 Agent 或 MCP 客户端，页面会展示针对该客户端的最新接入说明。这里有一条关键纪律，原文档明确要求：
复制该页面上展示的 MCP URL、header 或 key，不要把其他客户端的配置语法搬过来。
原因在于不同客户端的配置格式并不统一。以仓库中的 Connect 文档（docs/content/docs/composio-connect.mdx）为例，同一个 MCP 服务端点https://connect.composio.dev/mcp在不同客户端里的写法差异明显：
- 支持 OAuth 的客户端（Claude Desktop、ChatGPT、Notion 等）：填入 MCP URL 后由客户端弹浏览器完成 Composio 授权；
- 只支持 API key/header 的客户端（Antigravity、OpenAI Agent Builder、n8n 等）：需要额外配置
x-consumer-api-key请求头，值为你的消费者密钥； - 终端类 Agent（Claude Code、Codex、Gemini CLI、Hermes、OpenClaw 等）：推荐直接安装 Composio CLI 的原生插件（
composio login），而不是手填 MCP URL。
通用 MCP URL 写法如下（来自 Connect 文档的 "Generic MCP URL" 一节）：
{ "mcpServers": { "composio": { "url": "https://connect.composio.dev/mcp", "headers": { "x-consumer-api-key": "YOUR_CONSUMER_KEY" } } } }接上之后，Agent 侧实际获得的是 7 个 meta-tools（而非上千个应用工具的直接列表），Connect 文档 "Available MCP tools" 一节列出了完整清单：
COMPOSIO_SEARCH_TOOLS：在工具目录中检索与请求相关的工具，并给出建议执行计划；COMPOSIO_GET_TOOL_SCHEMAS：拉取搜索返回的工具完整输入 schema；COMPOSIO_MULTI_EXECUTE_TOOL：跨已连接应用并行执行工具（单次最多 50 个）；COMPOSIO_MANAGE_CONNECTIONS：创建、列出、重命名或删除上游应用的 OAuth 连接；COMPOSIO_WAIT_FOR_CONNECTIONS：等待用户完成 OAuth 流程后再继续；COMPOSIO_REMOTE_WORKBENCH：在远程沙箱中运行 Python，处理批量操作或大响应；COMPOSIO_REMOTE_BASH_TOOL：在远程沙箱中运行 bash，处理文件与大数据。
这也解释了 Connect Apps 与 Connect my agent 的分工：前者负责"认证账户"，后者负责"把账户能力交给客户端"。
仓库中的静态测试 docs/tests/static/for-you-client-snapshot.test.ts 进一步佐证了这一"按客户端给出接入说明"的导航设计：它维护了一份PINNED_CLIENT_TERMS白名单（Claude Code、Claude Cowork、ChatGPT、Cursor、Codex、Gemini CLI、VS Code、Windsurf、Antigravity、OpenAI Agent Builder、n8n、Generic MCP URL 等 21 个客户端/别名），并断言 Connect 页面的可搜索内容必须覆盖全部条目——即"Connect my agent"这类入口的可发现性是被测试保障的产品契约。同一测试（L50-L59）还断言页面源码中不得出现任何真实ck_/ak_凭证、组织/会话 ID 或 dashboard 链接，与下文"绝不把密钥贴进支持对话"的安全纪律相呼应。
3. Help：支持入口
当用户需要的是支持通道（support route）而不是自助产品指引时，打开Help。原文档把 Help 定位成"支持路由"，与产品内自服务（self-service）文档明确区分。
三、For You 设置区：Sessions & API Key 与消费者密钥轮换
For You 的设置当前包含四个分区：General、Members、Sessions & API Key和Billing。其中技术含量最高的是Sessions & API Key：用它查看当前的消费者接入说明，或重新生成（regenerate）消费者密钥。
消费者密钥（ck_*）的身份与使用方式
消费者密钥以ck_*为前缀，通过x-consumer-api-key请求头传给https://connect.composio.dev/mcp，与 Platform 的ak_*项目 API key 是完全不同的东西（边界文档 "Rotate the Connect MCP consumer key" 一节明确：ak_*是特权项目密钥，处理方式不同）。
重新生成消费者的完整步骤（合并原文档与边界文档的操作细节）：
- 打开 For You / Connect；
- 在左侧边栏选择Settings；
- 进入Sessions & API Key；
- 在 "Your API Key" 旁点击Regenerate并确认；
- 把每一个使用
https://connect.composio.dev/mcp的 MCP 客户端更新为新的x-consumer-api-key值。
注意事项（均出自原文档与边界文档）：
- 重新生成会立即使旧密钥失效——必须更新所有正在使用该密钥的客户端，否则它们会立刻断连；
- 重新连接 Gmail、Calendar 等单个应用不会轮转消费者密钥，两者是独立操作；
- 永远不要让用户把密钥粘贴进支持对话；
- 如果在正确工作区且有写权限却看不到 Regenerate 按钮，或需要排查可疑使用，应联系 Composio 支持走账户级处理。
底层机制上，消费者密钥对应一个"消费者作用域的 MCP 会话"：当 MCP 客户端不支持 OAuth 而仅支持 header 时，ck_*密钥就是这条链路的身份凭证，会话按该用户与允许的工具列表建立（见边界文档 "Consumer MCP auth has two common paths" 一节的两条路径：OAuth 流 vs.x-consumer-api-key）。
Members 分区的权限含义
结合边界文档可以补充 Members 分区在 For You 语境下的权限语义：管理员可以管理工作区设置与成员，但其 Connect MCP 会话不会自动使用其他成员的账户；普通成员可以连接并使用自己的账户；Viewer（查看者）无法从 For You 界面连接或调用工具。这解释了为什么"团队共享账号"不是 For You 的默认模型，显式共享必须走SHARED连接 + ACL + 会话内显式 pin 的机制，属于另一套配置。
四、边界核对清单：什么时候该切回 Platform
原文档最后一句划定了本文的边界，这里整理成可执行的判断清单：
| 你正在做的事 | 应该所在的界面 |
|---|---|
| 连接个人应用（Gmail、Notion 等） | For You → Connect Apps |
| 为 Claude Code / ChatGPT / Cursor 等客户端生成 MCP 接入 | For You → Connect my agent |
查看/重新生成ck_*消费者密钥 | For You → Settings → Sessions & API Key |
| 管理项目 auth config、项目用户、triggers、logs | Platform |
使用ak_*项目 API key（特权项目密钥） | Platform |
| 调试 SDK 会话、toolkit schema、Playground | Platform |
另外提醒一点产品结构上的对称性：Platform 的"会话 MCP 端点"（sessions-via-mcp）面向自建应用，与 For You 的connect.composio.dev/mcp是不同端点——文档站用docsProductDestination（docs/lib/home-navigation.ts）中的"counterpart"映射（/docs/sessions-via-mcp↔/docs/composio-connect）正是把这两条路径视为彼此对应的两侧入口。
五、参考与延伸阅读
- For You 导航原文：docs/kb/articles/dashboard-for-you-navigation.md（源文档：docs/kb/source/dashboard/for-you-navigation/public.md）
- 导航总览（Platform vs For You 划分）：docs/kb/articles/dashboard-navigation-overview.md
- 消费者/开发者项目边界与
ck_*密钥轮换：docs/kb/articles/consumer-project-boundaries-and-auth-selection.md - Composio Connect 文档（各客户端接入与 7 个 meta-tools）：docs/content/docs/composio-connect.mdx
- 文档站双产品导航模型源码：docs/lib/home-navigation.ts
- 客户端快照与凭证泄漏防护测试：docs/tests/static/for-you-client-snapshot.test.ts
适用前提：本文描述的是 For You 界面"当前"的导航结构（侧边栏四项、设置四项），该结构以 2026-08-17 时间戳的知识库文档为准；界面迭代后请以产品内实际页面为准，密钥前缀与请求头字段（ck_*/x-consumer-api-key）则以仓库边界文档的说明为准。
【免费下载链接】composioComposio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
