Connect Apps 是一个将 Claude 连接到外部应用的技能,基于 Composio CLI 实现。它的核心价值在于让 Claude 能够真正执行操作,例如发送邮件、创建 issue、发布消息,而不仅仅是生成关于这些操作的文本。该技能支持 1000+ 应用,覆盖邮件、聊天、开发、文档、数据等多个类别。
用途
当用户希望 Claude 发送邮件、创建 issue、发布消息,或跨多个应用执行实际操作时,可以使用此技能。它通过 Composio CLI 将 Claude 与外部应用打通,使对话中的指令能够转化为真实的应用动作。
主要能力
- 连接 1000+ 应用,包括:
- 邮件:Gmail、Outlook、SendGrid
- 聊天:Slack、Discord、Teams、Telegram
- 开发:GitHub、GitLab、Jira、Linear
- 文档:Notion、Google Docs、Confluence
- 数据:Sheets、Airtable、PostgreSQL
- 支持执行具体动作,例如:
- 发送邮件:composio execute GMAIL_SEND_EMAIL
- 创建 GitHub issue:composio execute GITHUB_CREATE_ISSUE
- 发布 Slack 消息:composio execute SLACK_SEND_MESSAGE
- 创建 Notion 页面:composio execute NOTION_CREATE_PAGE
- 支持工具发现、参数检查、并行执行、多步骤工作流和原始 API 调用。
使用方式
快速开始
第一步:安装 Composio CLI
curl -fsSL https://composio.dev/install | bash
第二步:登录
composio login composio whoami
该命令会打开浏览器进行认证,然后提示选择默认组织和项目。在脚本中可使用 -y 跳过提示。
第三步:链接所需应用
composio link gmail composio link slack composio link github
每个命令会引导完成一次 OAuth 授权,之后连接会持久保存。
第四步:试用
composio execute GMAIL_SEND_EMAIL -d '{ "recipient_email": "YOUR_EMAIL@example.com", "subject": "Composio test", "body": "Hello from the CLI" }'
如果邮件成功到达,说明连接已建立。
核心工作流
- 已知工具 slug:composio execute <SLUG> -d '{...}'
- 不知道 slug:composio search "what you want"
- 需要输入参数:composio execute <SLUG> --get-schema 或 --dry-run
- 尚未连接:composio link <toolkit> 后重试
- 多步骤任务:使用 composio run 编写 JS/TS 工作流,或使用 composio proxy 发起原始 API 调用
常用命令
发现工具:
composio search "create a github issue" composio tools list gmail composio tools info GITHUB_CREATE_ISSUE
执行前检查或试运行:
composio execute GITHUB_CREATE_ISSUE --get-schema composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'
并行执行:
composio execute --parallel
GMAIL_FETCH_EMAILS -d '{"max_results": 2}'
GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'
多步骤工作流:
composio run ' const issue = await execute("GITHUB_CREATE_ISSUE", { owner: "acme", repo: "app", title: "Bug", body: "..." }); console.log(issue); '
无专用工具时的原始 API 调用:
composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail
配置
环境变量:
- COMPOSIO_API_KEY:用于非交互式使用的认证凭据
- COMPOSIO_BASE_URL:自定义 API 端点
- COMPOSIO_SESSION_DIR:覆盖产物存储位置
- COMPOSIO_DISABLE_TELEMETRY=true:选择退出遥测
全局标志:--log-level <all|trace|debug|info|warning|error|fatal|none>、--help。
故障排查
- 未登录:运行 composio login
- 提示需要连接某工具包:运行 composio link <toolkit>
- 未知 slug:运行 composio search "<goal>" 或 composio tools list <toolkit>
- 输入参数错误:先运行 composio execute <SLUG> --get-schema,再运行 --dry-run
- 动作失败:检查目标应用中的权限
完整参考文档:docs.composio.dev/docs/cli
适用场景
适用于需要让 Claude 跨多个外部应用执行真实操作的场景,例如自动发送邮件、在 GitHub 上创建 issue、在 Slack 中发布通知、将会议记录写入 Notion 等。也适合需要串联多个应用步骤的自动化工作流。
限制
使用前需要安装 Composio CLI 并完成登录和 OAuth 授权。部分操作可能受目标应用的权限限制。关于收费、价格、平台支持范围等具体信息,资料中暂未提供。