Composio For You 实战指南为你的个人 AI 客户端接入 1000 应用【免费下载链接】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/composioComposio For You 是 Composio 面向个人 AI 客户端与终端 Agent 的产品线让用户自己的 Agent 直接使用自己已连接的 Gmail、Slack、GitHub、Notion、Linear 等应用。本文以本仓库中的路由与操作指引 skills/composio/references/for-you.md 为骨架结合仓库内文档源码系统讲解 MCP 接入、CLI 操作、应用连接与故障排查的完整流程。读完本文你将掌握 For You 的稳定产品契约、不同接入表面的差异以及一套可复制、可验证的接入与调试方法。一、For You 是什么路由式产品定位For You 的服务对象是希望自己的 AI 客户端或终端 Agent 使用自己已连接应用的用户。与之相对的是 Composio Platform——面向正在构建产品、需要让产品用户连接账户的开发者。二者使用不同的凭据与接入路径不能混用。根据 skills/composio/SKILL.md 中的产品区分规则命名一个个人 AI 客户端无产品代码→ 按 For You 处理应用代码库、SDK、用户或租户身份、后端、产品 Agent → 按 Platform 处理。在 For You 场景下任务可按类型路由回答问题、配置 MCP 客户端、通过 CLI 操作、连接应用、排查既有配置。先识别任务类型再选择对应路径是本文贯穿始终的原则。二、稳定产品契约端点、密钥与请求头For You 有一份不会随意变动的产品契约是配置任何客户端的基石契约项值MCP 端点https://connect.composio.dev/mcp消费者密钥Consumer Keyck_...前缀仅当客户端需要请求头时使用请求头名称x-consumer-api-key密钥获取位置Dashboard → For You → AI Clients → 选择对应客户端两个关键红线已移除的mcp.composio.dev端点不是替代品。仓库变更日志 docs/content/changelog/03-25-26-mcp-endpoint-removed.mdx 明确记载该端点已于 2026 年 3 月 25 日永久下线网页流量重定向到composio.dev/toolkits底层服务已完全退役。官方文档 docs/content/docs/composio-connect.mdx 也指出 Platform 的会话型 MCP URL 同样不能混用。ck_...消费者密钥与 Platform 的COMPOSIO_API_KEY不可互换。二者分属不同产品线、不同凭据体系用错密钥必然导致认证失败。配置任何需要请求头的客户端时标准形态如下JSON 配置节选自 docs/content/docs/composio-connect.mdx 的通用 MCP URL 示例{ mcpServers: { composio: { url: https://connect.composio.dev/mcp, headers: { x-consumer-api-key: YOUR_CONSUMER_KEY } } } }安全提示消费者密钥等同于账户访问凭据严禁写入提交到版本库的配置文件、URL、日志或聊天记录中。三、MCP 还是 CLI按 Agent 形态选择默认原则很简单桌面端与托管型 AI 客户端用 MCP能在终端执行命令、直接操作工具的终端 Agent 用 CLI。各接入表面安装了什么For You 的接入表面是互补关系安装其中一个并不会自动安装其他表面。理解这一点才能解释Agent 能看到工具却看不到技能的困惑表面Agent 会发现什么原生 Composio MCP 连接可调用的工具及其 schema。MCP 不安装 Agent 技能。公共composio技能本产品与任务路由器。需从ComposioHQ/composio显式安装。Composio CLIcomposio命令以及 CLI 的 agent 设置流程安装的独立维护的composio-cli技能该技能负责当前命令用法。OpenAI/Codex 插件托管的 Composio 应用及其捆绑的composio-runtime技能用于在托管工具与本地 CLI 之间选择。Claude Code 插件命令与 hooks。不捆绑技能CLI 登录/设置会单独安装composio-cli。因此Agent 完全可能看得到 Composio 工具、却看不到任何一个 Composio 技能也可能同时拥有多个角色不同的技能。正确的分工是composio负责产品选择与集成指导composio-runtime负责 OpenAI 插件路由composio-cli负责 CLI 操作。关于插件与 CLI 技能的安装细节可参考仓库中的 docs/content/docs/agent-plugins.mdxcomposio login默认会为 Claude Code 安装composio-cli技能如需单独安装可使用composio --install-skill composio-cli claude或composio --install-skill composio-cli codex。MCP 客户端的配置要点Claude DesktopClaude Cowork与 ChatGPT走浏览器 OAuth不需要消费者密钥。以 Claude Cowork 为例在消息框点击 → Connectors → Add custom connector命名为 Composio 并粘贴https://connect.composio.dev/mcp然后在浏览器中完成授权即可详见 docs/content/docs/composio-connect.mdx。基于请求头的客户端使用上文端点与x-consumer-api-key请求头。例如 Antigravity 使用serverUrl配置远程 HTTP 服务并带 headersn8n 则选择HTTP Streamable连接类型 Header Auth凭据。由于各客户端的配置方式会随版本变化在给出具体客户端的操作步骤之前应先去获取权威信息源https://docs.composio.dev/docs/composio-connect.md如果官方文档与 CLI/tool schema 仍无法解答 For You 的支持问题可查询统一知识检索https://docs.composio.dev/api/knowledge-search?q问题。检索结果可能是规范文档、KB、toolkit、示例或 reference 页面——以返回的证据作答不要从公开记录推断用户账户、连接或工具调用的实时状态。终端 AgentCLI 的安装与操作仅当任务确实需要时才安装并认证 CLIcurl -fsSL https://composio.dev/install | bash composio login面对一个真实任务时标准操作链是搜索 → 连接 → 执行composio search 用户想要什么 composio link toolkit composio execute TOOL_SLUG -d {...}当 Agent 无法打开浏览器时使用无等待模式并解析返回的 JSONcomposio login --no-wait | jq把返回的登录 URL 交给用户用返回的密钥完成认证。CLI 安装完成后命令与参数的最新细节应优先以捆绑的composio-cli技能为准而不是凭记忆拼写 flag。另外永远不要凭空猜测 toolkit 或 tool 的 slug——通过composio search或运行时发现来获取这一规则同样写入了 skills/composio/SKILL.md 的稳定规则第 4 条。四、按需连接应用不做全量预连接不要在开始任务前把所有应用都连上。正确做法是直接启动用户要求的任务当某个集成确实需要时Composio 会返回一个授权链接Connect Link连接建立后会持续存在供后续运行复用无需重复授权。对设置类或操作类请求若授权可用用一次安全的真实调用验证所选路径是否正确对提问或配置解释类请求直接作答不要强行触发执行。这个最小动作 一次安全验证的原则与 skills/composio/SKILL.md 中优先选择能完成当前任务的最小配置的稳定规则一脉相承。关于 For You 的 MCP 服务器如何工作docs/content/docs/composio-connect.mdx 提供了底层机制connect.composio.dev/mcp并非直接暴露全部应用工具而是暴露 7 个元工具meta-tools供 Agent 编排——搜索目录COMPOSIO_SEARCH_TOOLS、获取 schemaCOMPOSIO_GET_TOOL_SCHEMAS、并行执行COMPOSIO_MULTI_EXECUTE_TOOL单次最多 50 个、管理连接COMPOSIO_MANAGE_CONNECTIONS、等待 OAuthCOMPOSIO_WAIT_FOR_CONNECTIONS以及远程沙箱中的 Python 与 bash 工具。Agent 首次需要某个应用时Composio 会生成一个 OAuth 链接供你在浏览器批准之后连接跨会话持久化。五、调试清单从证据到修复调试的第一步永远是先确认客户端连接到了正确的 MCP 端点或 CLI 已成功认证然后获取 Composio 日志或请求 ID再对照 skills/composio/references/errors.md 定位失败边界。CLI 已安装并认证时以下命令可补充证据引自 skills/composio/references/errors.mdcomposio dev logs tools composio dev logs triggers composio connections list注意不要仅仅为了诊断一条已包含失败信息的仪表盘日志就去安装或重新初始化 CLI。For You 场景下最常见的四类检查MCP 工具不出现确认连接器已启用客户端支持时清除其缓存然后重新连接。浏览器 OAuth 反复选错账户在干净的全新浏览器配置文件中重试只登录一个 Composio 账户。授权链接已过期请求一个新链接而不是复用旧链接。已连接应用的 action 返回 auth 错误重新连接该应用并重试不要为此重新生成消费者密钥。连接管理入口与密钥管理的真实位置依据 docs/kb/articles/dashboard-for-you-navigation.mdDashboard → For You → Connect Apps管理各 provider 账户的连接选择应用 → Connect → 认证。Dashboard → For You → Connect my agent查看针对目标 Agent 或 MCP 客户端的当前设置指引复制该页面显示的 MCP URL、请求头或密钥不要从其他客户端迁移配置语法。Settings → Sessions API Key查看当前消费者连接指引或重新生成消费者密钥。重新生成会使旧密钥立即失效必须同步更新每一个使用它的客户端也绝不要要求用户把密钥粘贴到支持对话中。六、与 Platform 的边界避免凭据混淆最后重申 For You 与 Platform 的边界这是本仓库多处文档反复强调的常见事故源维度Composio For YouComposio Platform使用场景自己的 Agent 用自己已连接的应用开发者构建产品由产品用户连接账户主要表面MCP 或 Composio CLI应用内的 SDK 会话凭据需要请求头时用ck_...消费者密钥COMPOSIO_API_KEY项目密钥仪表盘dashboard.composio.dev→ For Youdashboard.composio.dev→ Platform在动手之前先确立产品归属再选择凭据、URL、SDK 或命令——这既是本路由文档的第一原则也是避免密钥混用 → 401 → 无头绪重试循环的最有效手段。【免费下载链接】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），仅供参考
