Composio For You 仪表板导航详解：Connect Apps、Connect my agent 与 Sessions API Key 的完整操作指南
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.mdPlatform面向开发者包含开发者项目、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请求头值为你的消费者密钥终端类 AgentClaude 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拉取搜索返回的工具完整输入 schemaCOMPOSIO_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、logsPlatform使用ak_*项目 API key特权项目密钥Platform调试 SDK 会话、toolkit schema、PlaygroundPlatform另外提醒一点产品结构上的对称性Platform 的会话 MCP 端点sessions-via-mcp面向自建应用与 For You 的connect.composio.dev/mcp是不同端点——文档站用docsProductDestinationdocs/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.mdComposio Connect 文档各客户端接入与 7 个 meta-toolsdocs/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），仅供参考